Como integrar um Webhook com a Whaticket usando o n8n

Neste tutorial, você monta um fluxo no n8n que recebe dados por um Webhook e envia automaticamente uma mensagem pela Whaticket. Assim, qualquer sistema que consiga chamar uma URL pode disparar mensagens, sem depender de uma integração nativa.

O que muda para sua operação

Dados de qualquer sistema viram mensagens automáticas na Whaticket.
O n8n processa e organiza as informações antes do envio.
Você automatiza fluxos sem esperar uma integração nativa.

Antes de começar

Tenha uma conta ativa no n8n.
Para criar o token, seu perfil precisa da permissão Criar do grupo Tokens de API.
O perfil escolhido para o token precisa das permissões Criar e Iniciar do grupo Campanhas. Sem elas, a API recusa o envio.
Use uma conexão de WhatsApp QR Code para enviar texto livre como no exemplo. Na WhatsApp API Cloud, a API só envia modelos aprovados pela Meta (campo templateId).
Na conexão WhatsApp QR Code, cada mensagem enviada pela API consome um crédito de mensagem. Confira se há créditos disponíveis.
Opcional: uma ferramenta para enviar dados de teste ao Webhook, como o Postman.

Passo a passo:

Crie o token de API na Whaticket

No menu à esquerda, clique em Integrações e abra a aba Tokens.
Clique em Novo token, preencha o Nome e escolha o Perfil com as permissões necessárias.
Clique em Salvar.
Na janela Copie a chave do token, copie a Chave e guarde em lugar seguro. Ela não aparece de novo depois que você fecha a janela. Se perder, use Regenerar.

O token herda as permissões do perfil selecionado. Se você editar o perfil depois, o token passa a seguir as novas permissões na hora.

Copie o ID da conexão

No menu à esquerda, clique em Conexões.
No card da conexão que vai enviar as mensagens, abra o menu de ações e clique em Editar.
Na janela Editar Conexão, clique no ícone de copiar ao lado do título para copiar o ID da conexão.

Crie o Webhook no n8n

Adicione um nó Webhook ao seu fluxo.
Em HTTP Method, escolha POST.
Em Path, defina um caminho, por exemplo vendas.
Em Authentication, deixe None e, em Respond, escolha Immediately.
O n8n gera duas URLs: Test URL, para testes, e Production URL, para uso real.
Clique em Listen for test event para começar a receber dados.

Envie dados de teste

Envie dados para a Test URL a partir do Postman, de outro fluxo do n8n ou de um sistema externo. Exemplo de JSON:

{
  "name": "João da Silva",
  "number": "5511991113966",
  "message": "Olá, quero informações"
}

Confira se os dados aparecem no nó Webhook.

Crie o envio para a Whaticket

Adicione um nó HTTP Request conectado ao Webhook.
Em Method, escolha POST.
Em URL, informe https://api.whaticket.com/api/v1/messages.
Em Authentication, deixe None. A autenticação vai no cabeçalho.

Configure os cabeçalhos

Ative Send Headers.
Adicione o cabeçalho accept com o valor */*.
Adicione o cabeçalho Authorization com o valor Bearer, um espaço e a chave do token da Whaticket.

Configure o corpo

Ative Send Body.
Em Body Content Type, escolha JSON e, em Specify Body, escolha Using JSON.
Cole o exemplo abaixo. Troque o ID da conexão e, nos campos number, name e body, use expressões do n8n para puxar os dados recebidos pelo Webhook.

{
  "connectionId": "ID_DA_SUA_CONEXAO",
  "messages": [
    {
      "number": "5511991113966",
      "name": "Contato de teste",
      "body": "Mensagem que será enviada ao cliente"
    }
  ]
}

Execute o fluxo. Se tudo estiver certo, a resposta traz messages scheduled.

Perguntas frequentes

Onde a mensagem aparece na Whaticket?
Ela aparece como um chat. Sem nenhuma atribuição, o chat é criado como resolvido. Para abri-lo com um atendente ou departamento, inclua no item de messages o objeto ticketData com status, userId e queueId, como mostra a aba Documentação em Integrações.

Onde vejo o histórico dos envios?
Os envios pela API ficam em Campanhas, numa campanha diária chamada API seguida da data, ou com o nome enviado no campo campaignName.

A API recusou a chave do token. O que verifico?
Confira se o header Authorization tem Bearer, um espaço e a chave completa. Se a chave foi regenerada, a antiga deixa de funcionar na hora. Confira também se o perfil do token tem as permissões Criar e Iniciar de Campanhas.

O fluxo não enviou nada. O que confiro?
Confira se a chave do token é válida, se a conexão do ID informado está conectada, se o Webhook está ativo (use a Production URL depois dos testes) e se o número está no formato internacional, com código do país e sem o sinal de +.

Quais cuidados devo ter?
Teste sempre antes de usar em produção, valide os dados antes de enviar e não compartilhe a chave do token.