Skip to main content

📥 Inboxes e Canais

Aprenda a conectar e gerenciar todos os canais de atendimento no Chatwoot: WhatsApp, Instagram, Facebook, Email, chat do site e mais!

📋 O que são Inboxes?

Inbox é cada canal de comunicação onde você recebe mensagens dos clientes:
  • 💬 WhatsApp Business
  • 📷 Instagram Direct
  • 📘 Facebook Messenger
  • 📧 Email (IMAP/SMTP)
  • 🌐 Website Widget (chat do site)
  • 💬 Telegram
  • 📱 SMS
  • ☎️ Telefone (via integração)
Cada inbox funciona como uma “caixa de entrada” separada, mas todos os atendimentos ficam centralizados no Chatwoot!

➕ Adicionar Novo Inbox

Passo a Passo

  1. Na sidebar, clique em “Configurações”“Inboxes”
  2. Clique em ”+ Adicionar Inbox”
  3. Escolha o tipo de canal
  4. Siga as instruções específicas de cada canal
  5. Atribua agentes ao inbox
  6. Pronto! Comece a receber mensagens

💬 WhatsApp

Opções de Integração

O Chatwoot suporta 3 formas de conectar WhatsApp:

Evolution API

Mais estável e confiável
Multi-dispositivo
Ideal para produção

WAHA

Open-source
Auto-hospedado
Gratuito

UAZ API

Provider brasileiro
Suporte em PT-BR
Fácil configuração

Configurar WhatsApp (Evolution API)

  1. Obtenha API Key do seu provider Evolution
  2. No Chatwoot: “Adicionar Inbox”“WhatsApp”
  3. Escolha “Evolution API”
  4. Preencha:
    • Nome do Inbox: Ex: “WhatsApp Vendas”
    • URL da API: URL do seu servidor Evolution
    • API Key: Sua chave de autenticação
  5. Escanei QR Code com WhatsApp
  6. Atribua agentes ao inbox
  7. Teste enviando mensagem

Funcionalidades WhatsApp

Enviar/Receber mensagens de texto
Mídia: Imagens, vídeos, áudios, documentos
Templates: Mensagens pré-aprovadas pelo WhatsApp
Botões interativos: Respostas rápidas
Listas: Menus de opções
Localização: Compartilhar/receber localização
Contatos: Enviar vCard

📷 Instagram Direct

Conectar Instagram

Requisito: Você precisa de uma conta Instagram Business vinculada a uma página do Facebook.
  1. Adicionar Inbox“Instagram”
  2. Clique em “Conectar com Facebook”
  3. Faça login no Facebook
  4. Escolha a Página do Facebook conectada ao Instagram
  5. Autorize permissões
  6. Selecione a conta Instagram
  7. Atribua agentes

Funcionalidades Instagram

Direct Messages: Atenda DMs direto no Chatwoot
Comentários: (Opcional) Receba comentários de posts
Stories: Respostas a stories aparecem como mensagens
Mídia: Fotos, vídeos, GIFs
Respostas Rápidas: Envie respostas salvas

📘 Facebook Messenger

Conectar Facebook

  1. Adicionar Inbox“Facebook Messenger”
  2. Clique em “Conectar com Facebook”
  3. Faça login
  4. Escolha a Página que deseja conectar
  5. Autorize permissões
  6. Atribua agentes

Funcionalidades Facebook

Mensagens da Página: Atenda mensagens direto
Comentários: (Opcional) Transforme comentários em conversas
Mídia: Compartilhe fotos, vídeos, GIFs
Botões: Use botões de resposta rápida

📧 Email (IMAP/SMTP)

Configurar Email

Transforme seu email em inbox do Chatwoot!
  1. Adicionar Inbox“Email”
  2. Preencha informações:
IMAP (Receber):
  • Servidor: imap.gmail.com (Gmail)
  • Porta: 993
  • Email: [email protected]
  • Senha: Senha do email (ou App Password)
SMTP (Enviar):
  • Servidor: smtp.gmail.com (Gmail)
  • Porta: 587
  • Email: [email protected]
  • Senha: Senha do email
  1. Teste a conexão
  2. Atribua agentes

Providers Comuns

ProviderIMAPPorta IMAPSMTPPorta SMTP
Gmailimap.gmail.com993smtp.gmail.com587
Outlookoutlook.office365.com993smtp.office365.com587
Yahooimap.mail.yahoo.com993smtp.mail.yahoo.com587
Customseu-servidor.com993/143seu-servidor.com587/465

Gmail - Habilitar App Password

1

Ativar 2FA no Gmail

Configurações → Segurança → Verificação em duas etapas
2

Criar App Password

Senhas de app → Gerar nova senha
3

Usar no Chatwoot

Use a senha gerada (16 caracteres) no lugar da senha normal

🌐 Website Widget (Chat do Site)

Instalar Chat no Site

  1. Adicionar Inbox“Website”
  2. Dê um nome: Ex: “Chat do Site Principal”
  3. Configure aparência:
    • Cor primária: Cor da sua marca
    • Mensagem de boas-vindas: “Olá! Como posso ajudar?”
    • Avatar: Logo da empresa
  4. Copie o código de instalação:
<script>
(function(d,t) {
  var BASE_URL="https://chat.seudominio.com";
  var g=d.createElement(t),s=d.getElementsByTagName(t)[0];
  g.src=BASE_URL+"/packs/js/sdk.js";
  g.defer = true;
  g.async = true;
  s.parentNode.insertBefore(g,s);
  g.onload=function(){
    window.chatwootSDK.run({
      websiteToken: 'SEU_TOKEN_AQUI',
      baseUrl: BASE_URL
    })
  }
})(document,"script");
</script>
  1. Cole antes do </body> no seu site
  2. Recarregue o site e teste!

Personalizar Widget

Aparência:
  • Cor do botão e header
  • Avatar do agente
  • Mensagem de boas-vindas
  • Posição (direita/esquerda)
Comportamento:
  • Abrir automaticamente após X segundos
  • Mostrar notificação de nova mensagem
  • Pré-preencher informações do visitante
  • Desabilitar anexos (opcional)
Horário de Atendimento:
  • Configure mensagem fora do horário
  • Redirecione para email/formulário

💬 Telegram

Criar Bot do Telegram

  1. No Telegram, fale com @BotFather
  2. Envie /newbot
  3. Escolha nome e username do bot
  4. Copie o Token fornecido

Conectar ao Chatwoot

  1. Adicionar Inbox“Telegram”
  2. Cole o Token do bot
  3. Dê um nome ao inbox
  4. Atribua agentes
  5. Pronto! Mensagens ao bot aparecem no Chatwoot

⚙️ Configurações do Inbox

Atribuição Automática

Configure como conversas são atribuídas aos agentes:
  • Manual: Agente escolhe pegar conversa
  • Round Robin: Distribui igualmente entre agentes
  • Por Capacidade: Baseado em número de conversas ativas
  • Por Habilidade: (Requer configuração de skills)

Horário de Atendimento

Defina quando o inbox está ativo:
  1. Edite o inbox → “Horário de Funcionamento”
  2. Configure:
    • Dias da semana
    • Horário de início/fim
    • Fuso horário
  3. Mensagem fora do horário (opcional)

Mensagens Automáticas

Mensagem de Boas-vindas:
  • Enviada ao cliente no primeiro contato
  • Ex: “Olá! Obrigado por entrar em contato. Como posso ajudar?”
Mensagem de Ausência:
  • Quando não há agentes online
  • Ex: “No momento não há agentes disponíveis. Responderemos em breve!”
Email de Transcrição:
  • Envie cópia da conversa por email
  • Útil para follow-up

👥 Gerenciar Agentes do Inbox

Adicionar Agentes

  1. Edite o inbox
  2. Vá em “Agentes” ou “Colaboradores”
  3. Clique em ”+ Adicionar Agente”
  4. Selecione agente(s) na lista
  5. Salve

Remover Agentes

  1. Na lista de agentes do inbox
  2. Clique no “X” ao lado do nome
  3. Confirme remoção
Dica: Agentes só veem conversas dos inboxes aos quais estão atribuídos!

📊 Métricas por Inbox

Acompanhe performance de cada canal:

Métricas Disponíveis

  • Total de Conversas: Quantas conversas por canal
  • Tempo Médio de Resposta: Por inbox
  • Taxa de Resolução: % de conversas resolvidas
  • Satisfação (CSAT): Nota média por canal
  • Horário de Pico: Quando recebe mais mensagens

Visualizar Métricas

  1. Vá em “Relatórios”“Inboxes”
  2. Escolha o inbox desejado
  3. Filtre por período
  4. Analise gráficos e tabelas

🔌 Integrações Avançadas

Webhooks

Receba notificações de eventos em tempo real:
  1. Edite o inbox → “Configurações”“Webhooks”
  2. Adicione URL do webhook
  3. Escolha eventos:
    • Nova conversa
    • Nova mensagem
    • Conversa atribuída
    • Conversa resolvida
  4. Salve

API

Gerencie inboxes programaticamente:
# Listar inboxes
GET /api/v1/accounts/{account_id}/inboxes

# Criar inbox
POST /api/v1/accounts/{account_id}/inboxes

# Atualizar inbox
PATCH /api/v1/accounts/{account_id}/inboxes/{inbox_id}

🛡️ Segurança e Privacidade

Autenticação de Identidade

Para o widget do site, valide identidade do usuário:
window.chatwootSDK.run({
  websiteToken: 'SEU_TOKEN',
  baseUrl: 'https://chat.seudominio.com',
  user: {
    identifier: 'user_123',
    identifier_hash: 'HMAC_HASH_AQUI'
  }
})
Isso evita que usuários se passem por outros!

Dados Sensíveis

Nunca solicite dados sensíveis (senhas, cartões) via chat. Use links seguros para formulários.

💡 Dicas e Boas Práticas

Organização

Nomes claros: “WhatsApp Vendas”, “Email Suporte”
Um inbox por função: Separe vendas de suporte
Agentes específicos: Atribua especialistas por canal
Horários corretos: Configure horário de funcionamento

Performance

Atribuição automática: Use Round Robin ou Capacidade
Mensagens prontas: Crie templates para respostas comuns
Labels por canal: Organize conversas por origem

Experiência do Cliente

Responda rápido: Configure notificações para agentes
Personalize boas-vindas: Mensagem calorosa e útil
Fora do horário: Informe quando retornará
Multi-canal: Ofereça opções ao cliente

❓ Perguntas Frequentes

Sim! Adicione quantos inboxes WhatsApp precisar (vendas, suporte, etc.).
Use o sistema de Contatos. Vincule todas as identidades ao mesmo contato!
Não. Cada número WhatsApp pode estar conectado a apenas um Chatwoot por vez.
Sim! Use os servidores IMAP/SMTP do Office 365 (veja tabela acima).
Sim! Remova todos os agentes ou use horário de funcionamento zerado.

🚀 Próximos Passos