n8n-nodes-elevanc

Nodes do Elevanc Chat para o n8n: leia contatos
e conversas e envie mensagens de WhatsApp, Instagram e Messenger.

Referência completa da API: https://central.elevanc.com.br/docs/api —
⚠️ essa página entra no ar junto com a API pública. Até lá, as tabelas abaixo
são a referência.

Instalação

n8n self-hosted — Configurações → Community Nodes → Instalar →
n8n-nodes-elevanc.

⚠️ No n8n Cloud só é possível instalar community nodes verificados pela
n8n. Enquanto este pacote não passar por isso, use o n8n self-hosted — ou o nó
HTTP Request, apontando para a API direto.

Credencial

O valor da chave aparece uma vez só, no momento da criação. O botão de testar
conexão bate em GET /api/v1/me.

⚠️ A chave dá acesso a tudo que a API oferece, inclusive enviar mensagem
para os seus clientes. Ela fica guardada na sua instância de n8n — este pacote
não a envia para lugar nenhum além do seu próprio Elevanc Chat.

Node de ação — Elevanc Chat

O telefone pode ir em qualquer formato (+55 11 98416-2943 ou
5511984162943) — a API normaliza antes de buscar.

⚠️ Enviar manda mensagem de verdade para o cliente final, e não tem desfazer.
No WhatsApp só é aceito texto livre até 24h depois da última mensagem do contato;
fora disso a resposta é 422 outside_whatsapp_window.

Ligue Trazer Tudo para percorrer todas as páginas; sem ele vem só a primeira
(até 100 itens).

Node de gatilho — Elevanc Chat Trigger

⚠️ Ele não se registra sozinho. Copie a URL de webhook que o nó mostra e cole
em Integrações → Webhooks no Elevanc Chat.

Eventos: conversa nova, mensagem recebida, etiqueta adicionada, negócio movido,
atendimento atribuído e atendimento resolvido.

Segredo de assinatura (recomendado). Preencha com o mesmo segredo do webhook
no Elevanc Chat e o gatilho passa a recusar entrega sem assinatura válida. Sem
ele, qualquer um que descubra a URL do seu webhook consegue injetar eventos
falsos no seu fluxo.

A saída de cada evento traz:

{
  "event": "mensagem_recebida",
  "delivery_id": "…",
  "timestamp": "2026-08-17T04:12:09.481Z",
  "body": { }
}

delivery_id é estável entre repetições da mesma entrega — use-o se precisar
descartar duplicata.

Desenvolvimento

npm install
npm run typecheck   # contra os tipos reais do n8n
npm run build       # tsc + copia o ícone para dist/
npm run verify      # amarrações internas, sobre o dist construído

verify existe porque tsc limpo não prova que o nó carrega: um
$parameter que não corresponde a propriedade nenhuma, ou um caminho declarado
no package.json que o build não gerou, passam no compilador e só falham na
instância de quem instalou.

Estado

v0.1.1 — exercitado numa instância de n8n de verdade.

O que foi verificado em execução, contra uma instância self-hosted:

• a corrente contato por telefone → conversas → mensagens, com o telefone
  digitado formatado (+55 11 …) contra dado guardado em dígitos puros;
• Trazer Tudo percorrendo 3 páginas — 52 itens, 52 identificadores distintos
  (o número de distintos é o que separa paginou de repetiu a primeira página);
• o gatilho recebendo um evento nascido de uma mensagem real de WhatsApp, com
  o identificador de entrega batendo nas duas pontas;
• a assinatura: aceita a válida e recusa ausência, valor errado, segredo
  errado e corpo adulterado.

⚠️ Ainda não exercitado: a operação Enviar.

Correção da 0.1.1

A 0.1.0 respondia 200 quando recusava uma entrega por assinatura inválida —
o fluxo não executava (a guarda funcionava), mas quem entregou recebia sucesso.
Com o segredo trocado, nada rodava e não havia rastro em lugar nenhum. Agora a
recusa falha de forma visível. Atualize se você usa o Segredo de Assinatura.

⚠️ A API pública que este pacote consome ainda não está no ar. Enquanto não
estiver, ele não tem o que chamar.