Pular para o conteúdo
Central de Ajuda BotMestre Acessar o painel

Automação

n8n

Ligue o BotMestre ao n8n para montar automações com WhatsApp, contatos e eventos das suas lojas.

A página n8n (/dashboard/n8n) liga o BotMestre ao n8n, a ferramenta de automação por fluxos. Com ela, uma mensagem recebida, um pedido pago ou um carrinho abandonado pode disparar um workflow no n8n — e o n8n pode enviar mensagens, criar contatos e verificar números pelo seu WhatsApp. Fica no menu Automação ▾ → n8n.

Você usa o seu n8n: o n8n Cloud (pago, direto no site do n8n) ou um n8n instalado no seu servidor (gratuito). O BotMestre não hospeda o n8n — a licença do n8n não permite oferecê-lo dentro de outro sistema para os clientes montarem fluxos.

1. Gere a chave de acesso

  1. Abra Automação ▾ → n8n.
  2. Clique em Gerar chave para o n8n.
  3. Copie a API Key e guarde: por segurança ela aparece uma única vez.
  4. Copie também a URL da API, mostrada ao lado.

A chave gerada ali só pode enviar mensagens, ler o histórico, cuidar de contatos, listar conexões, finalizar atendimentos e assinar eventos. Ela não cria disparos, não mexe em grupos e não envia SMS. Para ver ou revogar chaves, use Configuração ▾ → Documentação → API Keys.

2. Escolha como conectar

Node BotMestre (quando aparecer como disponível)

Quando o cartão Node BotMestre no n8n mostrar a versão publicada:

  1. No n8n, abra Settings → Community Nodes → Install e digite n8n-nodes-botmestre.
  2. Crie a credencial BotMestre API com a API Key e a URL da API.
  3. Comece o workflow pelo BotMestre Trigger e escolha os eventos. Ao ativar o workflow, o BotMestre passa a enviar esses eventos para ele sozinho; ao desativar, para.
  4. Use o node BotMestre para enviar texto, mídia, enquete, "digitando…", criar ou buscar contatos, verificar se números têm WhatsApp e finalizar atendimentos. Ele também pode ser usado como ferramenta de um AI Agent do n8n.

Toda entrega do BotMestre Trigger vai assinada e é conferida antes de rodar o workflow.

Modelos prontos (funcionam em qualquer n8n)

Os modelos usam só os nodes que já vêm no n8n (Webhook, If e HTTP Request), então funcionam até no n8n Cloud sem instalar nada.

  1. Em Conexão usada nos modelos, escolha o WhatsApp que vai enviar as mensagens.
  2. Clique em Baixar no modelo.
  3. No n8n: Workflows → Import from file e escolha o arquivo.
  4. Nos nodes HTTP Request, crie a credencial Header Auth chamada BotMestre API Key: Name Authorization, Value Bearer seguido da sua API Key.
  5. Ative o workflow.
Modelo O que faz Evento
Pedido pago → agradecimento Agradece no WhatsApp quando uma loja integrada confirma o pagamento Loja: pedido pago
Resposta por palavra-chave Responde quem escreve "preço", citando a mensagem; ignora grupos Mensagem recebida
Formulário do site → contato + boas-vindas Seu site manda nome e telefone ao n8n; ele cria o contato com a etiqueta "site" e dá boas-vindas — (quem chama é o seu site)

3. Eventos enviados ao n8n

Para os modelos que dependem de um evento do BotMestre:

  1. No n8n, abra o node Webhook do workflow ativo e copie a Production URL.
  2. No BotMestre, clique em Ligar evento no modelo (ou em Enviar eventos ao n8n), cole a URL e confira os eventos marcados.
  3. Clique em Salvar.

Use a Production URL. A "Test URL" (com /webhook-test/) só recebe enquanto o editor do n8n está ouvindo e o painel recusa ela.

A lista Eventos enviados ao n8n mostra cada URL cadastrada — inclusive as criadas pelo BotMestre Trigger — com os eventos, a última entrega e o estado:

Estado O que significa
Ativo Os eventos estão sendo entregues.
N falhas seguidas O n8n não respondeu ou recusou as últimas entregas. Confira se o workflow está ativo.
Desativado após falhas Depois de 100 falhas seguidas o envio para. Corrija o n8n e clique em Reativar.
Pausado Você pausou. Clique em Reativar para voltar.
Assinado As entregas levam assinatura HMAC (as do BotMestre Trigger).

O botão de avião envia um evento de teste (webhook.test) e mostra se o n8n respondeu.

Perguntas frequentes

Os eventos de loja chegam de quais plataformas? De todas as conectadas em Integrações de loja, no mesmo formato.

Troquei a API Key da credencial e o gatilho parou. Desative e ative o workflow de novo: a ativação recadastra o envio com a chave nova.

O n8n mostra 401 "Invalid BotMestre signature". A entrega não bateu com a chave da credencial ou chegou com mais de 5 minutos de atraso. Desative e ative o workflow.

Posso usar o Make ou o Zapier? Sim: a mesma chave e os mesmos eventos funcionam com qualquer ferramenta que receba webhooks e chame uma API — veja Documentação da API.

Cobrança

O nó BotMestre 0.2 tem o recurso Charge (criar, criar recorrência, consultar, listar, reenviar, dar baixa, cancelar) e o BotMestre Trigger dispara em Charge: Created e Charge: Paid — por exemplo, para renovar o acesso de um cliente de IPTV quando ele paga. Veja Cobrança.