Atendimento omnichannel
Integrar WhatsApp com Chatwoot
O Chatwoot é uma plataforma de atendimento ao cliente open-source e omnichannel. Ele reúne conversas de vários canais (site, e-mail, redes sociais e WhatsApp) dentro de um único inbox compartilhado, onde vários agentes atendem em equipe, com filas, times, tags, respostas prontas e relatórios. É a alternativa self-hosted mais popular a ferramentas como Zendesk e Intercom, e por ser aberta permite conectar canais próprios através do tipo de caixa de entrada "API".
Por que conectar
Sozinho, o Chatwoot não fala WhatsApp por número comum: ou você usa a API Oficial (cara e burocrática) ou fica sem canal. Conectando a ZapZap API, você usa um número de WhatsApp normal via instância gerenciada e joga todas as conversas para dentro do inbox do Chatwoot. Cenário concreto: um time de suporte de 5 agentes atende centenas de clientes num só número. O cliente manda mensagem no WhatsApp, a ZapZap dispara um webhook, sua camada intermediária cria a conversa no Chatwoot e o agente responde pela tela do Chatwoot. A resposta volta pelo webhook do Chatwoot e a ZapZap envia de volta no WhatsApp. Você ganha distribuição de conversas, histórico centralizado e métricas de atendimento, mantendo aquecimento em comunidade, recursos de anti-bloqueio que reduzem o risco da conta e a possibilidade de IA por instância, tudo por R$15 por número ativo/mês, pré-pago e com crédito grátis para testar.
Passo a passo
- 1
Crie uma caixa de entrada do tipo API no Chatwoot
No Chatwoot, vá em Configurações (Settings) > Caixas de entrada (Inboxes) > Adicionar caixa de entrada (Add Inbox) e escolha o canal API. Dê um nome (ex: WhatsApp ZapZap) e informe uma Webhook URL apontando para a sua camada intermediária. Ao finalizar, o Chatwoot gera o inbox_identifier e um api_access_token que você usará nas chamadas.
- 2
Configure o webhook de eventos do Chatwoot
Em Configurações > Integrações > Webhooks (ou no Agent Bot da caixa API), marque os eventos message_created e conversation_created. Assim, sempre que um agente responder na tela do Chatwoot, ele dispara o payload para a sua camada, que fará o envio real pelo WhatsApp via ZapZap API.
- 3
Aponte o webhook da instância ZapZap para a sua camada
No painel da ZapZap API, configure o webhook por evento da instância (mensagem recebida) para a URL do seu middleware. Quando um cliente escrever no WhatsApp, a ZapZap envia o payload com número e conteúdo da mensagem para você processar.
- 4
Encaminhe a mensagem recebida para dentro do Chatwoot
No seu middleware, ao receber o webhook da ZapZap, use a API pública do Chatwoot para criar/encontrar o contato e a conversa e postar a mensagem: POST /public/api/v1/inboxes/{inbox_identifier}/contacts/{contact_identifier}/conversations e depois /messages. A conversa aparece no inbox do time como uma nova entrada de WhatsApp.
- 5
Envie a resposta do agente de volta pelo WhatsApp
Quando o agente responder no Chatwoot, o webhook message_created chega ao seu middleware. Filtre por message_type outgoing e chame o endpoint de envio da ZapZap API (com headers x-api-key e x-api-secret) para entregar a resposta no WhatsApp do cliente. Confira os nomes exatos de rota e campos na doc em https://api.zapzapapi.com/llms.txt.
Exemplo
// Exemplo ILUSTRATIVO: ao chegar mensagem no Chatwoot (webhook do agente),
// sua camada envia pelo WhatsApp via ZapZap API.
// Os nomes exatos de rota e campos estão na doc: https://api.zapzapapi.com/llms.txt
POST https://api.zapzapapi.com/v1/messages/send
Headers:
x-api-key: SUA_API_KEY
x-api-secret: SEU_API_SECRET
Content-Type: application/json
{
"number": "5511999999999",
"text": "Olá! Recebemos sua mensagem e já vamos te atender."
}Ilustrativo. Os campos e endpoints exatos estão na documentação.
Perguntas frequentes
Preciso da API Oficial do WhatsApp para usar no Chatwoot?
Não. A ZapZap API funciona com números de WhatsApp comuns via instâncias gerenciadas, então você conecta ao Chatwoot pelo canal API sem passar pela API Oficial nem pela burocracia da Meta. Você mantém o inbox de time do Chatwoot e paga R$15 por número ativo/mês, pré-pago, com crédito grátis para testar.
Preciso de uma camada intermediária entre a ZapZap e o Chatwoot?
Sim. O canal API do Chatwoot e a ZapZap API não conversam diretamente: você precisa de um pequeno serviço (webhook) que recebe o evento de um lado e chama o outro. Pode ser uma função serverless, um endpoint no seu backend ou um fluxo no n8n. Ele traduz os webhooks nos dois sentidos.
Consigo ter vários agentes atendendo o mesmo número?
Sim, esse é o ponto forte. O Chatwoot distribui as conversas de um único inbox de WhatsApp entre os agentes e times, com atribuição automática, tags e respostas prontas. Todas as mensagens entram e saem por um só número gerenciado na ZapZap API.
Isso protege minha conta de WhatsApp contra bloqueio?
A ZapZap API oferece aquecimento em comunidade e recursos de anti-bloqueio que reduzem o risco da conta, além de IA por instância. Nenhuma solução garante bloqueio zero, mas centralizar o atendimento com respostas mais rápidas e humanas ajuda a manter um padrão de uso saudável.
Onde vejo os nomes exatos dos endpoints e campos da ZapZap API?
A referência oficial fica em https://api.zapzapapi.com/llms.txt, com as rotas de envio, os eventos de webhook e os campos aceitos. Os exemplos desta página são ilustrativos: confirme os nomes exatos na doc antes de subir para produção.
Comece com crédito grátis
Crie sua conta, conecte um número em minutos e teste a API com aquecimento e anti-bloqueio. R$15 por número ativo/mês, pré-pago, sem fidelidade.