Integrando ChatWoot com WhatsApp: O Guia Definitivo

ChatWoot
Elder Theodoro
18 de março, 2025
10 minutos de leitura
Integrando ChatWoot com WhatsApp: O Guia Definitivo

O WhatsApp se tornou um dos canais de comunicação mais importantes para empresas que desejam oferecer atendimento ao cliente eficiente e personalizado. Quando integrado a uma plataforma de gerenciamento de comunicação como o Chatwoot, você pode transformar o WhatsApp em uma poderosa ferramenta de atendimento multiagente.

Neste guia completo, vou mostrar passo a passo como integrar o Chatwoot com o WhatsApp Business API, permitindo que sua equipe gerencie todas as conversas de forma organizada e eficaz.

O que é o Chatwoot?

Antes de mergulharmos na integração, vamos entender brevemente o que é o Chatwoot. Trata-se de uma plataforma de atendimento ao cliente de código aberto que unifica diferentes canais de comunicação em uma única interface. Com o Chatwoot, você pode gerenciar conversas de diversos canais como WhatsApp, Facebook Messenger, Instagram, Twitter, e-mail, entre outros.

As principais vantagens do Chatwoot incluem:

  • Interface intuitiva e moderna
  • Código aberto e flexível
  • Possibilidade de auto-hospedagem ou uso da versão cloud
  • Recursos avançados como caixas de entrada compartilhadas, etiquetas, automação e relatórios
  • Integrações nativas com diversas plataformas
Dashboard do Chatwoot mostrando conversas ativas em diversos canais

Escolhendo o método de integração com WhatsApp

Existem três principais métodos para integrar o Chatwoot ao WhatsApp:

1. Através do WhatsApp Business API oficial

Este é o método recomendado para empresas de médio e grande porte, pois oferece:

  • Maior estabilidade e confiabilidade
  • Suporte para múltiplos agentes
  • Recursos empresariais avançados
  • Conformidade oficial com os termos de serviço do WhatsApp

2. Usando provedores terceirizados de WhatsApp API

Provedores como 360dialog, Twilio, MessageBird e Gupshup oferecem acesso facilitado à API do WhatsApp:

  • Processo de aprovação simplificado
  • Configuração mais rápida
  • Suporte adicional
  • Cobranças baseadas em volume de mensagens

3. Através de soluções não-oficiais

Soluções baseadas em WhatsApp Web (não recomendadas para uso comercial):

  • Mais simples de configurar
  • Sem processo de aprovação
  • Violam os termos de serviço do WhatsApp
  • Risco de bloqueio da conta

Para este guia, focaremos na integração usando o provedor 360dialog, que é um dos mais populares e bem integrados ao Chatwoot.

Passo 1: Configurando sua conta no Chatwoot

Se você ainda não tem uma conta no Chatwoot, siga estes passos:

  1. Acesse chatwoot.com e clique em "Sign Up"
  2. Ou instale o Chatwoot em seu próprio servidor seguindo a documentação de auto-hospedagem
  3. Complete o processo de configuração da sua conta
  4. Crie sua primeira caixa de entrada clicando em "Add Inbox"

Passo 2: Obtendo acesso ao WhatsApp Business API via 360dialog

Para obter acesso à API do WhatsApp através do 360dialog:

  1. Crie uma conta no 360dialog
  2. Complete o processo de verificação da sua empresa
  3. Solicite acesso ao WhatsApp Business API
  4. Aguarde a aprovação (geralmente leva de 1 a 3 dias úteis)
  5. Depois de aprovado, você receberá suas credenciais de API

Durante o processo, você precisará fornecer:

  • Informações da empresa
  • Número de telefone para o WhatsApp Business
  • Documentação que comprove propriedade do número
  • Nome de exibição e descrição que aparecerão para os clientes
Processo de configuração do WhatsApp Business API

Passo 3: Integrando o 360dialog com o Chatwoot

Após receber aprovação e credenciais do 360dialog, siga estes passos para integrar ao Chatwoot:

  1. Faça login no seu painel do Chatwoot
  2. Navegue até "Configurações" > "Caixas de entrada" > "Adicionar Caixa de Entrada"
  3. Selecione "WhatsApp" como canal
  4. Escolha "360dialog" como provedor
  5. Preencha os seguintes detalhes:
    • Nome da Caixa de Entrada: Um nome para identificar esta integração
    • Número de telefone: O número completo com código do país (ex: 5511999998888)
    • API Key do 360dialog: Cole a chave fornecida pelo 360dialog
    • Número de ID da Conta (opcional): Se fornecido pelo 360dialog
    • Nome do Ambiente (opcional): Geralmente "sandbox" ou "production"
  6. Clique em "Salvar" para concluir a integração

Após salvar, o Chatwoot configurará automaticamente os webhooks necessários no 360dialog para receber mensagens.

Passo 4: Configurando modelos de mensagem

Para iniciar conversas com clientes através do WhatsApp Business API, você precisará usar modelos de mensagem aprovados:

  1. No painel do 360dialog, navegue até "Message Templates"
  2. Clique em "Create New Template"
  3. Configure seu modelo seguindo as diretrizes do WhatsApp:
    • Escolha uma categoria (Marketing, Utilitário, Autenticação, etc.)
    • Escreva o conteúdo da mensagem
    • Adicione parâmetros usando o formato {{1}}, {{2}}, etc., se necessário
    • Adicione botões ou mídias, se desejar
  4. Envie o modelo para aprovação
  5. Após aprovado, o modelo estará disponível para uso no Chatwoot

Exemplo de modelo de boas-vindas:

Olá {{1}},

Obrigado por entrar em contato com a [Nome da Empresa]!

Como podemos ajudar você hoje?

Este canal está disponível de segunda a sexta, das 9h às 18h.

Passo 5: Gerenciando conversas no Chatwoot

Agora que sua integração está funcionando, vamos ver como gerenciar conversas:

Recebendo mensagens

Quando um cliente envia uma mensagem para seu número do WhatsApp:

  1. A mensagem aparecerá automaticamente na caixa de entrada do Chatwoot
  2. Um novo contato será criado com o número do telefone do cliente
  3. Você pode atribuir a conversa a um agente específico ou deixá-la na fila compartilhada

Enviando mensagens

Para responder aos clientes:

  1. Abra a conversa no painel do Chatwoot
  2. Digite sua resposta no campo de texto
  3. Adicione anexos, se necessário (imagens, documentos, etc.)
  4. Clique em "Enviar"

Para iniciar uma nova conversa (requer modelo aprovado):

  1. Clique em "Nova Conversa"
  2. Selecione a caixa de entrada do WhatsApp
  3. Digite o número do cliente (com código do país)
  4. Selecione um modelo aprovado para a primeira mensagem
  5. Preencha os parâmetros do modelo, se houver
  6. Envie a mensagem
Interface de atendente gerenciando múltiplas conversas no Chatwoot

Passo 6: Configurando automações

O Chatwoot oferece poderosos recursos de automação que podem ser aplicados às conversas do WhatsApp:

Mensagens automáticas

  1. Acesse "Configurações" > "Automações"
  2. Clique em "Criar automação"
  3. Configure uma mensagem de saudação automática quando um cliente inicia uma conversa
  4. Configure mensagens fora do horário de expediente

Regras de atribuição

  1. Configure regras para distribuição de conversas entre agentes
  2. Defina roteamento baseado em disponibilidade, carga de trabalho ou habilidades

Chatbots e integrações com IA

Para automação avançada:

  • Integre o Chatwoot com plataformas de IA como Dialogflow ou Rasa
  • Configure chatbots para lidar com perguntas frequentes
  • Transfira para agentes humanos quando necessário

Passo 7: Monitoramento e análise

Para avaliar o desempenho do seu atendimento via WhatsApp:

  1. Utilize os relatórios integrados do Chatwoot
  2. Acompanhe métricas como tempo de resposta, taxa de resolução e satisfação
  3. Use etiquetas para categorizar conversas e identificar tendências
  4. Configure relatórios personalizados para necessidades específicas

Boas práticas para atendimento via WhatsApp

Para maximizar os resultados da sua integração Chatwoot-WhatsApp:

  • Responda rapidamente: Clientes esperam respostas mais ágeis no WhatsApp do que em outros canais
  • Use recursos multimídia: Aproveite a capacidade de enviar imagens, vídeos e documentos
  • Personalize o atendimento: Use o nome do cliente e histórico de interações para personalizar conversas
  • Mantenha um tom conversacional: O WhatsApp é um canal mais informal, adapte sua comunicação
  • Respeite os horários: Configure corretamente mensagens fora do expediente
  • Treine sua equipe: Garanta que todos saibam usar eficientemente o Chatwoot

Solução de problemas comuns

Alguns problemas frequentes e suas soluções:

Mensagens não chegando ao Chatwoot

  • Verifique se os webhooks estão configurados corretamente
  • Confirme se as credenciais do 360dialog estão atualizadas
  • Verifique o status da API no painel do 360dialog

Não é possível iniciar conversas

  • Confirme se você está usando modelos aprovados
  • Verifique se o número do cliente está no formato correto
  • Confirme se a janela de 24 horas não expirou

Mensagens com atraso

  • Verifique a infraestrutura de rede
  • Confirme se não há problemas de capacidade no servidor
  • Verifique o status operacional do 360dialog

Conclusão

A integração entre Chatwoot e WhatsApp oferece uma solução poderosa para empresas que desejam melhorar seu atendimento ao cliente. Com esta configuração, você pode gerenciar todas as conversas de WhatsApp de forma eficiente, profissional e escalável.

Além de melhorar a experiência do cliente, esta integração também traz benefícios para sua equipe de atendimento, como distribuição inteligente de conversas, acesso ao histórico completo de interações e insights valiosos sobre o desempenho do atendimento.

Comece hoje mesmo a transformar seu atendimento via WhatsApp com o Chatwoot!