Pular para o conteúdo principal
O Pilot Status possui uma integração nativa com o Chatwoot: conecte qualquer número de WhatsApp a uma conta Chatwoot e as conversas sincronizam bidirecionalmente — mensagens recebidas do WhatsApp aparecem no Chatwoot, e as respostas dos agentes no Chatwoot são entregues no WhatsApp.
Página do Chatwoot do Pilot Status

​
Pré-requisito: FRONTEND_URL (Chatwoot self-hosted)

Se você executa um Chatwoot self-hosted, a variável de ambiente FRONTEND_URL deve estar configurada antes de conectar: 
FRONTEND_URL=https://chatwoot.your-domain.com
  • Use a URL pública exata (mesmo esquema/host do navegador), sem barra no final, acessível pela internet — nunca localhost nem um IP interno.
  • Reinicie ambos os containers web e sidekiq depois (o Rails deriva default_url_options[:host] a partir dela na inicialização).
Sem FRONTEND_URL, o Chatwoot não consegue construir URLs absolutas de anexos nem webhooks de saída válidos. Sintomas no Pilot Status: mensagens marcadas como “Falha ao enviar”, mídia nunca entregue, e ArgumentError: Missing host to link to! nos logs do Chatwoot/sidekiq.
Para validar: envie uma mensagem com um anexo em uma conversa de teste — nenhum Missing host to link to! nos logs, a mensagem aparece como enviada no Pilot Status, e a mídia chega no WhatsApp.

​
Configurar a integração

A integração é configurada por número na página Chatwoot do painel do Pilot Status.
1

Reúna três credenciais do Chatwoot

  • Instance URL — a URL base do seu Chatwoot (ex.: https://chatwoot.your-domain.com ou https://app.chatwoot.com).
  • Account ID — o número na URL do seu Chatwoot após /app/accounts/.
  • User Access Token — nas configurações de perfil do seu Chatwoot.
2

Conecte no Pilot Status

Abra a página Chatwoot no painel, selecione o número de WhatsApp e cole os três valores. O Pilot Status cria automaticamente uma inbox de API e o webhook na sua conta Chatwoot — você nunca cola uma URL de webhook manualmente.
3

Converse

Mensagens recebidas do WhatsApp (incluindo mídia) abrem conversas na nova inbox; as respostas dos agentes voltam para o WhatsApp. O histórico de mensagens e o status de entrega permanecem sincronizados.

​
Pausar ou desconectar

Na mesma página do Chatwoot você pode pausar a sincronização por número (um botão de alternância — nada é excluído; ative-o novamente para retomar) ou desconectar a integração por completo.

​
Chamadas de voz

As chamadas de voz e a inbox do Chatwoot são superfícies separadas — os eventos de chamada do WhatsApp não são publicados nas conversas do Chatwoot. Há duas formas de trabalhar com chamadas:
  1. Atender chamadas no painel do Pilot Status (pronto para uso, sem configuração): a página /chat do painel tem um softphone integrado que atende e faz chamadas de voz do WhatsApp para ambos os tipos de conexão — números da API Meta oficial (Meta Cloud API) via WebRTC e números não oficiais (Pilot Status web) por meio de uma sessão de áudio no servidor. Veja Visão geral de Chamadas.
  2. Usar o canal de voz nativo do próprio Chatwoot (avançado, self-hosted): o Chatwoot v4.15+ traz um canal de voz nativo; você pode roteá-lo através do Pilot Status apenas para números da API Meta Cloud — em um Chatwoot self-hosted, aponte a URL base do WhatsApp Cloud para a camada Meta do Pilot Status (/api/layer/meta), crie uma inbox manual do WhatsApp Cloud para o número e adicione um webhook do Pilot Status com escopo naquele número, com o evento calls, apontando para o webhook da inbox do Chatwoot. O Chatwoot Cloud (app.chatwoot.com) e os números não oficiais não são suportados nesse caminho.

​
Relacionados