Integração com n8n

Envie mensagens de WhatsApp a partir dos seus fluxos (workflows) do n8n. Por exemplo, envie uma mensagem para um novo lead vindo de um webhook, confirme um pedido da sua loja ou mande um alerta quando uma verificação falhar.

Há duas formas de conectar:

• O community node do Wbiztool (n8n-nodes-wbiztool): nodes prontos, com campos para cada opção.
• O node HTTP Request nativo: funciona em qualquer instância do n8n e dá acesso a todos os endpoints da API. Veja Usar o node HTTP Request.

Antes de começar#

• Uma conta do Wbiztool com um número de WhatsApp conectado nas configurações do WhatsApp.
• Seu Client ID e sua chave de API, em Configurações → Chaves API.
• O ID do Cliente WhatsApp do número que vai enviar, mostrado nas configurações do WhatsApp.

Instalar o community node#

1. Abra os community nodes

   No n8n, acesse Settings → Community Nodes (configurações → community nodes) e clique em Install (instalar).

2. Digite o nome do pacote

   Digite n8n-nodes-wbiztool, confirme e instale. Reinicie o n8n se os nodes não aparecerem.

Em uma instância self-hosted, você também pode instalá-lo com npm na pasta de nodes personalizados do n8n:

npm install n8n-nodes-wbiztool

Criar a credencial#

Adicione uma nova credencial do tipo WbizTool API:

Ao salvar, o n8n testa a credencial com Verificar credenciais.

Nodes#

O pacote adiciona estes nodes. Cada um chama um endpoint da API do Wbiztool e retorna a resposta da API.

WbizTool Send Message#

O node retorna messageId (o msg_id da API). Guarde-o se quiser consultar o status ou cancelar a mensagem depois.

Exemplo de fluxo#

1. O node Webhook recebe um novo lead com phone e name.
2. WbizTool Send Message: defina Phone Number como {{ $json.phone }} e Message Text como Hi {{ $json.name }}, thanks for signing up!.
3. Node IF: verifique se {{ $json.messageId }} não está vazio para seguir para o próximo passo, como atualizar o seu CRM.

Um WbizTool Send Message bem-sucedido retorna um item como este:

{
  "success": true,
  "messageId": 9817263,
  "status": 1,
  "message": "Created",
  "response": { "status": 1, "message": "Created", "msg_id": 9817263 }
}

O item também inclui um objeto input com os valores que o node enviou. Se a API retornar um erro, o node para e mostra o message da API. Ative Continue On Fail para receber, em vez disso, um item com success: false e o texto do error.

No WbizTool WhatsApp Client Status, use o método de verificação General Status. O método Status by ID retorna erro para todos os números por causa de um bug nesse endpoint da API. Com General Status, um número que não está conectado também interrompe o node com um erro Disconnected; por isso, ative a opção Continue On Fail do node se quiser criar ramificações com base no resultado.

Usar o node HTTP Request#

Adicione um node HTTP Request e configure-o assim:

Depois cole um corpo como este e mapeie os valores dos nodes anteriores com expressões:

{
  "client_id": 12345,
  "api_key": "YOUR_API_KEY",
  "whatsapp_client": 678,
  "msg_type": 0,
  "country_code": "91",
  "phone": "{{ $json.phone }}",
  "msg": "Hi {{ $json.name }}, thanks for signing up!"
}

Uma chamada bem-sucedida retorna {"status": 1, "message": "Created", "msg_id": 9817263}. Todos os campos e mensagens de erro estão em Enviar mensagem.

Para chamar outros endpoints, altere a URL e o corpo. Por exemplo, para agendar uma mensagem, use https://wbiztool.com/api/v1/schedule_msg/ e adicione date no formato DD/MM/YYYY, time no formato HH:MM e timezone. Veja Agendar mensagem.

Para enviar a mesma mensagem para vários números ou grupos em uma única chamada, use https://wbiztool.com/api/v1/send_msg/multi/ e coloque os destinatários em phone como uma única string separada por vírgulas. Veja Enviar para vários números.

{
  "client_id": 12345,
  "api_key": "YOUR_API_KEY",
  "whatsapp_client": 678,
  "msg_type": 1,
  "country_code": "91",
  "phone": "{{ $json.phones }}",
  "img_url": "https://example.com/offers/diwali-sale.jpg",
  "msg": "Our Diwali sale starts tomorrow!"
}

Coloque só dígitos em cada número. Qualquer coisa que não seja um número inteiro, como 98765 43210, é enviada como nome de grupo.

Expressões do n8n funcionam em qualquer campo de texto. Por exemplo, uma saudação que depende da hora do dia ou um texto que depende do total do pedido:

{
  "msg": "Good {{ $now.hour < 12 ? 'morning' : 'evening' }} {{ $json.name }}, your order total is {{ $json.total }}.{{ $json.total > 1000 ? ' Delivery is free.' : '' }}"
}

$now usa o fuso horário do fluxo (Workflow settings → Timezone), então defina-o para decidir quando termina a "morning" (manhã).

Ser avisado quando uma mensagem é enviada#

1. Crie um fluxo com webhook

   Adicione um node Webhook com o método HTTP POST e copie a URL de produção dele.

2. Informe a URL ao enviar

   Coloque essa URL na opção Webhook URL do node ou no campo webhook do corpo da sua requisição HTTP.

3. Leia o resultado

   O Wbiztool chama a URL quando a mensagem é enviada ou falha. O corpo é form-encoded e contém apenas msg_id e status, que é SENT ou FAILED.

Veja em Webhook como funcionam novas tentativas e timeouts.

Solução de problemas#