Pular para o conteúdo principal
1

Adicionar a variável de ambiente no seu servidor

No servidor do seu Chatwoot, adicione a variável abaixo às variáveis de ambiente da instalação:
É ela que faz o Chatwoot falar com a Datafy API. Sem ela, o Chatwoot tenta validar a conexão direto na Meta e a criação do canal é recusada.A variável precisa valer para a aplicação e para o worker (Sidekiq):
  • Docker Compose ou Portainer: inclua no arquivo .env ou no bloco de variáveis compartilhado da stack.
  • EasyPanel: adicione nos dois serviços.
O exemplo abaixo é no EasyPanel. O caminho muda conforme a instalação, mas a ideia é a mesma nos outros painéis.No menu lateral, em Serviços, selecione o serviço da aplicação (chatwoot) e abra Ambiente, ou Environment se o painel estiver em inglês. Acrescente a variável no final da lista e clique em Salvar. Em seguida, repita no serviço do worker (chatwoot-sidekiq).
Exemplo no EasyPanel: os serviços chatwoot e chatwoot-sidekiq destacados no menu, e a variável WHATSAPP_CLOUD_BASE_URL no final da lista de variáveis de ambiente.
Com a variável salva nos dois serviços, faça o redeploy ou atualize a stack. Salvar a variável não aplica a mudança.
2

Copiar o token de acesso do Chatwoot

No Chatwoot, clique no seu usuário, no canto inferior esquerdo, e abra Profile settings.
Menu do usuário aberto no Chatwoot, com a opção Profile settings destacada.
Role a página de perfil até o final. Em Access Token, clique em Copy.
Final da página de perfil do Chatwoot, com a seção Access Token e o botão Copy.
O token precisa ser de um usuário administrador da conta, porque é com ele que a caixa de entrada é criada.
3

Preencher os dados no painel da Datafy API

No painel da Datafy API, abra o número e vá na aba Chatwoot. Preencha:
Pode copiar a URL inteira do seu Chatwoot, de qualquer tela em que você esteja. O formulário ajusta sozinho e mantém só o endereço base.
Aba Chatwoot no painel da Datafy API, com a URL, o token de acesso e o nome do canal preenchidos.
Clique em Conectar. A Datafy API acessa o seu Chatwoot, cria a caixa de entrada com o número e configura a entrega das mensagens recebidas. O processo leva alguns segundos, então aguarde a confirmação na tela.
4

Conferir no Chatwoot

No menu do Chatwoot, em Conversations, na seção Channels, a caixa de entrada aparece com o nome que você informou. O ícone do WhatsApp ao lado indica que o canal é uma conexão oficial.
Menu do Chatwoot mostrando a caixa de entrada criada na seção Channels, com o ícone do WhatsApp.
A integração já está funcionando. Cada mensagem recebida no número abre uma conversa em tempo real, e o agente responde por ali.
Conversa recebida aparecendo na caixa de entrada do Chatwoot logo após a conexão.

​
O webhook criado na conexão

Ao conectar, a Datafy API cadastra um webhook no número apontando para o seu Chatwoot. Ele fica visível na aba Webhooks do número, depois de atualizar a página, com os eventos messages e smb_message_echoes ativos.
Webhook criado automaticamente, apontando para o Chatwoot, com os eventos messages e smb_message_echoes.
É por ele que as mensagens recebidas chegam ao Chatwoot. Se o webhook for removido, as conversas deixam de aparecer.

​
Editar ou remover a conexão

Com a integração ativa, a aba mostra o canal conectado, com a URL, a conta e o inbox no Chatwoot.
Aba Chatwoot com a integração conectada, mostrando o canal, a conta e o inbox, e os botões Remover e Editar.
Editar permite trocar a URL, o token ou o nome do canal. Deixar o token em branco mantém o que já está salvo. Se você gerar um novo token na Datafy API ou um novo token de acesso no Chatwoot, clique em Editar, informe os dados atualizados e clique em Conectar para refazer a conexão. Remover desliga a integração: o número deixa de receber e enviar mensagens pelo Chatwoot. As conversas já existentes continuam lá para consulta.

​
Se algo der errado

A URL ou o token estão incorretos, ou o Chatwoot não está respondendo. Confirme o endereço do servidor e gere o token novamente.
A variável WHATSAPP_CLOUD_BASE_URL não está valendo na instalação. Confirme que ela foi adicionada à aplicação e ao worker e que os serviços foram reiniciados.
Abra a caixa de entrada no Chatwoot e reconecte. Nesse estado o Chatwoot descarta as mensagens recebidas.
A caixa de entrada existente é reaproveitada, com as configurações corrigidas. Nenhuma conversa é perdida e o nome atual dela é mantido.
Se você já usava a integração pelo canal API, conectar por aqui substitui a configuração antiga. A troca só acontece depois de o novo canal estar funcionando.