Captura de WhatsApp via companion
Capture todas as conversas do WhatsApp Business do vendedor direto na timeline de Conversas, usando um bridge companion que você mesmo hospeda. É opcional, desligado por padrão, e exige aceitar um aviso de Termos de Uso.
Este conector traz para a timeline de Conversas as mensagens do WhatsApp Business do vendedor, capturadas por um bridge companion que a sua organização hospeda. As mensagens caem no mesmo lugar das outras conversas, então o resumo por IA, os insights e o monitoramento de follow-up já funcionam em cima delas.
Antes de começar: aviso de Termos de Uso
Como funciona
- Você roda um bridge companion (um serviço open-source de WhatsApp Web) no seu ambiente.
- O companion pareia o WhatsApp Business por QR code e escuta as mensagens que chegam e saem.
- Para cada mensagem, o companion faz um POST assinado para a URL de ingestão da sua organização.
- A mensagem é gravada, ligada ao contato ou lead pelo telefone (ou cria um lead novo quando o número é desconhecido), e aparece na timeline de Conversas.
Como conectar
- Vá em Configurações, Integrações e abra o cartão "WhatsApp: captura via companion".
- Defina um segredo de pareamento forte e marque a caixa de consentimento (entendo o risco aos Termos de Uso). Clique em Salvar.
- Copie a URL de ingestão exibida e configure o companion com essa URL e o mesmo segredo de pareamento.
- Volte ao cartão e clique em Ativar. Sem o consentimento marcado e salvo, a captura não é aceita.
Enquanto o conector estiver desligado ou sem o consentimento salvo, a URL de ingestão recusa qualquer envio. Assim você nunca captura nada sem ter aceitado o aviso.
Formato do POST (contrato do companion)
O companion envia uma mensagem ou um lote, assinando o corpo com o segredo de pareamento (HMAC-SHA256) no cabeçalho X-Sellio-Signature no formato sha256=<hex>.
POST /api/inbound/whatsapp-capture/SEU_TOKEN
X-Sellio-Signature: sha256=<hmac-sha256 do corpo com o segredo>
Content-Type: application/json
{
"messages": [
{
"messageId": "id-unico-da-mensagem",
"from": "5511999990000",
"to": "5511888880000",
"direction": "in",
"body": "texto da mensagem",
"timestamp": 1700000000,
"name": "Nome do contato"
}
]
}O campo messageId garante que a mesma mensagem, se reenviada, não vira duplicata. O direction é "in" (recebida) ou "out" (enviada pelo vendedor). O timestamp aceita segundos ou milissegundos e é usado para ordenar a timeline.