Pular para o conteúdo
WbizTool

WhatsApp no n8n com o node do WbizTool

Adicione o WhatsApp aos seus workflows do n8n: mande mensagem a um novo lead vindo de um webhook, confirme um pedido ou envie um alerta quando uma verificação falhar. Use o community node do WbizTool, com campos prontos, ou o node HTTP Request nativo em qualquer instância do n8n.

Comece grátisn8n-nodes-wbiztool no npm

Teste grátis: 50 mensagens em quaisquer 30 dias, sem cartão.

Como funciona

  1. Instale o community node

    No n8n, vá em Settings → Community Nodes, clique em Install e digite n8n-nodes-wbiztool. Reinicie o n8n se os nodes não aparecerem.

  2. Crie a credencial

    Adicione uma credencial WbizTool API com seu Client ID, sua chave de API e o WhatsApp Client ID do número que vai enviar. Mantenha a Base URL como https://wbiztool.com/api/v1 (sem barra no final). O n8n a testa quando você salva.

  3. Adicione o WbizTool Send Message

    Escolha Phone Number ou Group, mapeie o telefone de um node anterior (por exemplo {{ $json.phone }}), defina o Country Code e escreva a mensagem.

  4. Use o resultado

    O node devolve messageId. Guarde-o para conferir o status ou cancelar a mensagem depois, ou crie um desvio com um node IF.

Exemplos para copiar e colar

Instalar em um n8n auto-hospedado (pasta de custom nodes)
npm install n8n-nodes-wbiztool
Node HTTP Request: POST https://wbiztool.com/api/v1/send_msg/, corpo JSON
{
  "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!"
}

O que você pode fazer

  • Envie texto, imagens e arquivos

    O WbizTool Send Message envia um texto, uma imagem com texto ou um arquivo com texto para um número de telefone ou um grupo. As URLs precisam ser públicas.

  • Grupos e listas

    O WbizTool Send Group Message publica em um grupo pelo nome; o WbizTool Send Multi Message envia uma mensagem para uma lista de números separados por vírgula.

  • Status e cancelamento

    O WbizTool Message Status confere uma mensagem pelo ID, e o WbizTool Cancel Message cancela uma mensagem agendada.

  • Gerencie seus números

    Liste os números de WhatsApp do seu espaço de trabalho, adicione um número ou confira se um número está conectado (use o método General Status: Status by ID falha por enquanto).

  • Saiba quando foi enviada

    Coloque a URL de um node Webhook do n8n na opção Webhook URL. O WbizTool a chama com msg_id e status: SENT, FAILED, CANCELLED ou EXPIRED.

  • Todos os endpoints com o HTTP Request

    Mude a URL e o corpo para chamar qualquer endpoint da API do WbizTool, como schedule_msg ou send_msg/multi.

Bom saber

  • O campo Country Code vem com 91 (Índia) por padrão. Para números de outros países, defina o código certo, senão o 91 é adicionado na frente do número.
  • O node WbizTool Schedule Message ainda não funciona: ele envia as datas como DD-MM-YYYY, mas a API precisa de DD/MM/YYYY. Agende com o node HTTP Request e https://wbiztool.com/api/v1/schedule_msg/.
  • Os endpoints multi e de agendamento respondem HTTP 200 para a maioria dos erros, como text/html: no node HTTP Request, defina Response Format como JSON e confira se status é 1.
  • O WbizTool Message Status só devolve um item para uma mensagem enviada (Sent); uma mensagem na fila, com falha, cancelada ou expirada para o node com um erro. Ative Continue On Fail para criar um desvio.
  • A API funciona no teste grátis (50 mensagens em quaisquer 30 dias). Os planos pagos enviam mensagens ilimitadas dentro do uso justo, até 1.000 por dia por número. Mensagens para grupos também funcionam em todos os planos.
  • O WbizTool envia do seu próprio número de WhatsApp, então as regras do próprio WhatsApp valem: mande mensagens para quem espera ter notícias suas, como seus clientes e leads.

Perguntas frequentes

E se o meu n8n não permitir community nodes?
Use o node HTTP Request nativo: método POST, URL https://wbiztool.com/api/v1/send_msg/, autenticação None e um corpo JSON com client_id, api_key, whatsapp_client, phone e msg. Ele faz o mesmo trabalho.
Quais nodes o pacote adiciona?
Send Message, Send Group Message, Send Multi Message, Schedule Message, Cancel Message, Message Status, Check Credentials, List WhatsApp Clients, Create WhatsApp Client e WhatsApp Client Status.
O node dá certo, mas nada chega. Por quê?
Um node bem-sucedido significa que a mensagem entrou na fila. Ela aguarda até o seu número de WhatsApp estar conectado, então confira o número em Números do WhatsApp, no WbizTool.
Meu texto mapeado quebra o corpo JSON. O que faço?
Aspas ou quebras de linha em um valor mapeado deixam o JSON inválido. Mude Body Content Type para Form Urlencoded e adicione cada campo como um parâmetro.
Posso enviar a mesma mensagem para vários números?
Sim. Use o WbizTool Send Multi Message, ou faça um POST para https://wbiztool.com/api/v1/send_msg/multi/ com os destinatários em phone como uma string separada por vírgulas.

Leia os guias

Veja também

Envie hoje sua primeira mensagem automática de WhatsApp

Crie uma conta, escaneie o QR code e envie uma mensagem em menos de cinco minutos.

Comece grátis

Planos pagos a partir de US$ 25 por mês nos EUA. Preços