n8n-nodes-msgapi

Nós do n8n para o msg.api: envie e receba mensagens de WhatsApp nos seus fluxos, sem programar.

n8n community nodes for msg.api, a WhatsApp API with a fixed price per number. English summary at the end.

Instalação

n8n self-hosted: em Settings › Community Nodes › Install, digite n8n-nodes-msgapi e confirme.

Mais detalhes na documentação do n8n sobre community nodes.

Credentials

1. No painel do msg.api, abra o seu número e copie a chave de API.
2. No n8n, crie uma credencial msg.api API e cole a chave.
3. Deixe o API URL como https://msg.api.br.

Nós

msg.api Trigger

Inicia o fluxo quando chega uma mensagem no seu número. Ao ativar o fluxo, o nó se cadastra sozinho no msg.api e, ao desativar, se remove. Não é preciso copiar nenhum webhook.

• Eventos: mensagem recebida; voto em enquete (com as opções escolhidas); mensagem da fila anti-ban enviada ou com falha.
• Opções: ignorar mensagens de grupos e incluir as mensagens enviadas pelo próprio número. Por padrão, elas ficam de fora para evitar respostas em loop.

Cada mensagem recebida chega assim:

{
  "event": "message.received",
  "id": "3EB0C767D82B6A0A1F2E",
  "from": "[email protected]",
  "chat": "[email protected]",
  "from_me": false,
  "text": "Olá! Quero saber o preço",
  "media": null
}

msg.api

Recurso	Operações
Message	Send Text, Send File (imagem, vídeo, áudio ou documento, de um arquivo binário ou de um link), Send Poll, React, Mark as Read
Contact	Check (quais números têm WhatsApp), Get, Get Profile Picture
Group	Get Many, Get, Create, Add Participants
Connection	Get Status, Get Profile
Anti-Ban	Get, Update (ligar, desligar, limites por minuto, hora e dia, intervalo entre mensagens, horário ativo e aquecimento de número novo)

Os números vão com DDI e DDD, só dígitos (ex.: 5567999999999). Grupos usam o ID terminado em @g.us.

Com o anti-ban ligado, os textos entram na fila e saem no ritmo de uma pessoa. Para códigos de verificação, ligue Send Immediately.

No Send File, escolha a origem: um arquivo binário de um nó anterior ou um link https (até 25 MB), que o msg.api baixa. Com File Type em Auto-Detect, fotos, vídeos e áudios que o WhatsApp exibe vão como mídia, e o resto como documento.

O nó também pode ser usado como ferramenta do AI Agent.

Cada voto em enquete chega assim (options vazio quando a pessoa tira o voto):

{
  "event": "poll.vote",
  "poll_id": "3EB0A1B2C3D4E5F6A7B8",
  "poll_name": "Quer continuar recebendo?",
  "chat": "[email protected]",
  "from": "[email protected]",
  "from_me": false,
  "options": ["Sair"]
}

Só dá para ler votos de enquetes enviadas depois que o número foi conectado ao msg.api: é quando o msg.api guarda o código que o WhatsApp usa para cifrar os votos.

Exemplo: responder automaticamente

1. msg.api Trigger com o evento Message Received.
2. msg.api › Message › Send Text, com To = {{ $json.chat }} e o texto da resposta.

English

• msg.api Trigger: starts a workflow when a WhatsApp message arrives. It registers and removes its own webhook automatically.
• msg.api: sends texts, files (from binary data or an https link) and polls, manages contacts and groups, and turns the anti-ban on, off or adjusts it.
• Credentials: the API key of your number, from the msg.api panel.

Licença

MIT