n8n

Instale o nó da comunidade, crie a credencial, monte um primeiro fluxo de trabalho e entenda a limitação do webhook único antes de adicionar um gatilho.

A WASync disponibiliza um nó da comunidade para o n8n, publicado no npm como n8n-nodes-wasync. Ele usa a mesma API REST descrita nesta documentação. Tudo o que o nó faz, você também pode fazer com curl — e o que ele ainda não faz, você também pode.

Antes de começar: uma conta e um número conectado

O nó se comunica com a sua conta WASync. Se você ainda não tem uma, crie-a primeiro — leva um minuto e não custa nada:

Crie uma conta de desenvolvedor gratuita

Acesse developers.wasync.app/register — nome, e-mail e senha. Toda conta nova vem com o seu próprio workspace: o lugar onde ficam seus números de WhatsApp e suas API keys.

Coloque um número de WhatsApp nesse workspace

Há duas situações:

Você já usa a WASync dentro do Bitrix24 — entre com o mesmo e-mail que você usa no Bitrix24. Seu portal aparece como um workspace e os números conectados dele já estão prontos para uso. Enviar pela API exige o add-on de API nesse número (US$ 12 por número por mês; sem ele, a etapa de envio do nó responde addon_required).
Você é novo na WASync — conecte um número ao seu próprio workspace com uma chamada de API que retorna um QR code (ou um código de pareamento que você digita no WhatsApp). Os passos exatos estão em Conectar um número de WhatsApp. Todo número começa com um teste gratuito de 7 dias; os planos são WAPP US$ 19 ou WABA US$ 29 por número por mês, em USD.

Crie uma API key

Há duas formas de fazer isso:

Já usa a WASync dentro do Bitrix24? Acesse Configurações → API e agentes → API keys, dê um nome à integração e clique em Criar chave. É necessária uma conexão com o add-on de API ativo, e a chave já vem com os escopos de que este fluxo de trabalho precisa (whatsapp.read whatsapp.send) — pule a lista de escopos abaixo.
Caso contrário, entre e abra developers.wasync.app/keys. Escolha o workspace, dê um nome à chave, marque os escopos abaixo e crie-a.

Em ambos os casos, copie a chave imediatamente — ela é exibida uma única vez. É o valor que a credencial do n8n solicita.

Uma conta, vários números

A operação Connection → List do nó mostra todos os números que a chave consegue acessar. Se a lista estiver vazia, o workspace ainda não tem nenhum número conectado — volte ao passo 2.

1. Instale o nó da comunidade

Verificado pelo n8n (7 set 2026)

O n8n-nodes-wasync é um nó da comunidade verificado — ele exibe o selo de verificado em qualquer lugar onde o n8n mostre um.

Há duas formas de instalá-lo, dependendo de onde você executa o n8n:

n8n Cloud ou auto-hospedado — pesquise no painel de nós. Abra o painel de nós, pesquise por "WASync" e adicione o nó. Os nós verificados são instalados direto de lá, sem nenhuma configuração extra.
Somente auto-hospedado — configurações de Community Nodes. Acesse Settings → Community nodes → Install, informe o nome do pacote e confirme:
```
n8n-nodes-wasync
```
Esse caminho funciona em qualquer instância auto-hospedada, verificado ou não.

Depois da instalação, os nós WASync e WASync Trigger aparecem no painel de nós.

Pontos de partida prontos: os modelos de fluxo de trabalho gratuitos cobrem os fluxos mais comuns — importe um e ajuste os campos em vez de começar de um canvas em branco.

2. Crie a credencial

Adicione uma credencial do tipo WASync API. Ela tem um único campo: a sua API key, que é enviada como Authorization: Bearer ….

Cole a chave que você criou acima (veja Antes de começar) — ela é exibida uma única vez. Dê a ela apenas os escopos de que o fluxo de trabalho precisa:

listar conexões e ler mensagens → whatsapp.read
enviar e marcar como lida → whatsapp.send
o gatilho → whatsapp.events

Veja Escopos.

3. Seu primeiro fluxo de trabalho

O fluxo de trabalho útil mais simples tem dois nós: um gatilho manual e um envio.

Encontre o id da conexão. Adicione um nó WASync, escolha o recurso Connection → operação List e execute. Copie o id do número a partir do qual você quer enviar.

Envie uma mensagem. Adicione um segundo nó WASync, recurso Message → operação Send. Preencha:

Campo	Valor
`connectionId`	o id que você acabou de copiar
`to`	dígitos internacionais, sem `+` — por exemplo, `40712345678`
`text`	o corpo da mensagem

Execute. O nó retorna o id da mensagem, que você pode usar depois para cruzar dados — veja os dois ids.

Operações compatíveis com o nó

Recurso	Operação	Parâmetros
Connection	List	—
Message	Send	`connectionId`, `to`, `text`
Message	Get Many	`connectionId`, `limit`
Message	Mark as Read	—

Somente envio de texto. Enviar um modelo de WhatsApp e verificar se um número está no WhatsApp não estão disponíveis pela API hoje, por isso o nó não os oferece — não monte um fluxo de trabalho que suponha que existam.

4. O gatilho

O WASync Trigger inicia um fluxo de trabalho quando algo acontece na sua conta. Ele é compatível com quatro eventos:

message.received
message.status
connection.connected
connection.disconnected

Os payloads são exatamente os do guia de webhooks — mesmos campos, mesmos ids, mesmo timestamp em milissegundos.

Um único slot de webhook por conta — um gatilho o move

A API tem uma única URL de webhook por conta (PUT /webhook, POST /webhook/rotate, e nenhuma operação de exclusão). Ativar um WASync Trigger aponta esse único slot para o n8n.

Ou seja: se o seu próprio backend já recebia webhooks, ele deixa de receber assim que o gatilho assume. E dois WASync Triggers não podem ocupar o slot ao mesmo tempo — o segundo prevalece. Se você precisa dos eventos em mais de um lugar, receba-os uma vez e distribua por conta própria: deixe o n8n ocupar o slot e encaminhe a partir de um fluxo de trabalho, ou deixe o seu backend ocupá-lo e chame um nó Webhook do n8n.

As URLs do gatilho de teste e de produção são diferentes, então alternar entre elas também move o slot.

Como as entregas são descartadas após três tentativas malsucedidas, mantenha um caminho de reconciliação também no n8n: um fluxo de trabalho agendado que chame Message → Get Many a cada 30–60 segundos captura tudo o que o gatilho perdeu enquanto a instância estava reiniciando.

Quando o nó não é suficiente

O nó cobre o caminho mais comum. Para envio de mídia, códigos de pareamento, provisionamento de conexões, tratamento de Idempotency-Key ou qualquer outra coisa da referência da API, use o nó HTTP Request do n8n com a mesma credencial: URL base https://developers.wasync.app/api/v1, cabeçalho Authorization: Bearer <key>.

Esta página foi útil?

On this page