N8N: como integrar o Whaticket usando a API Send

Com a API Send do Whaticket, seus fluxos no n8n enviam mensagens de WhatsApp automaticamente. Use essa integração para notificações, avisos de CRM ou automações internas.

O n8n é uma ferramenta de automação que conecta aplicativos e serviços com fluxos visuais. Ele tem uma versão gratuita de código aberto e planos pagos na nuvem, cobrados por uso e número de execuções.

O que muda para sua operação

Mensagens saem sozinhas quando algo acontece em outro sistema, como um pedido novo ou um formulário preenchido.
Sua equipe deixa de copiar e colar avisos repetitivos.
Os envios ficam registrados no Whaticket, junto com o histórico do contato.

Antes de começar

Tenha uma conta no n8n.
No Whaticket, seu perfil precisa das permissões Visualizar e Criar do grupo Tokens de API.
O perfil vinculado ao token precisa das permissões Criar e Iniciar do grupo Campanhas.
Envios por conexão de WhatsApp via QR Code consomem créditos de mensagem. Confira se há créditos disponíveis.

Passo a passo:

Adicione o nó HTTP no n8n

Na tela do fluxo, clique no botão +.
Na busca, digite HTTP e escolha o nó HTTP Request.

Configure a requisição

Em Method, escolha POST.
Em URL, informe https://api.whaticket.com/api/v1/messages.
Em Authentication, deixe None.

Adicione os cabeçalhos

Ative Send Headers.
Em Specify Headers, escolha Using Fields Below.
Em Header Parameters, adicione o parâmetro com Name accept e Value */*.

Adicione outro parâmetro com Name Authorization e Value Bearer SEU_TOKEN_DO_WHATICKET.

Crie o token no Whaticket

No Whaticket, clique em Integrações no menu à esquerda e fique na aba Tokens.
Clique em Novo token.
Preencha o Nome e, em Perfil, escolha o perfil cujas permissões a integração vai usar.
Clique em Salvar.
Na janela Copie a chave do token, copie a Chave e clique em Concluir.
No n8n, cole a chave no lugar de SEU_TOKEN_DO_WHATICKET, depois da palavra Bearer e de um espaço.

A chave não aparece de novo depois que você fecha a janela. Se perder, use Regenerar no token.

Configure o corpo da mensagem

No nó HTTP, ative Send Body.
Em Body Content Type, escolha JSON.
Em Specify Body, escolha Using JSON.
Cole o código abaixo no campo JSON.

{
  "connectionId": "ID_DA_SUA_CONEXAO",
  "messages": [
    {
      "number": "NUMERO_DO_WHATSAPP_COM_DDI",
      "name": "NOME_DO_CONTATO",
      "body": "Texto da mensagem"
    }
  ]
}

Informe o número só com dígitos, com DDI e DDD, sem zero no início. Você pode trocar os valores fixos por campos de etapas anteriores do fluxo.

Copie o ID da conexão

No Whaticket, clique em Conexões.
No menu de ações da conexão que vai enviar as mensagens, clique em Editar.
Na janela Editar Conexão, clique no ícone de copiar ao lado do título.
No n8n, cole o ID no lugar de ID_DA_SUA_CONEXAO.

Teste a integração

No n8n, clique em Execute Step.
Confira a resposta messages scheduled. Ela indica que o envio foi agendado.
No Whaticket, abra o chat do contato e confira a mensagem.

Se a resposta trouxer um aviso de créditos, parte das mensagens pode não ser enviada até você comprar mais créditos.

Perguntas frequentes

Posso usar uma conexão da API oficial do WhatsApp?
Sim, mas nessa conexão o envio pela API Send sempre exige um modelo aprovado. Inclua o campo templateId com o ID do modelo, como mostra o artigo da documentação da API Send.

Por que o envio aparece em Campanhas?
Cada envio pela API Send cria ou reaproveita uma campanha do tipo API. Assim você acompanha os envios em Campanhas.

Os créditos de mensagem vencem?
Não. O saldo de créditos não tem data de vencimento: ele só diminui quando uma mensagem que consome crédito é enviada.

O campo whatsappId ainda funciona?
Sim. O nome atual do campo é connectionId, mas whatsappId continua aceito para integrações antigas.

Preciso de um desenvolvedor?
Não é obrigatório, mas ajuda a validar o mapeamento dos campos e a estrutura do JSON. A Whaticket não se responsabiliza por erros de configuração ou custos de plataformas de terceiros.