Package Information
Documentation
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
- No painel do msg.api, abra o seu número e copie a chave de API.
- No n8n, crie uma credencial msg.api API e cole a chave.
- 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; 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": "5567999999999@s.whatsapp.net",
"chat": "5567999999999@s.whatsapp.net",
"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 a partir de um arquivo binário), 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 |
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.
O nó também pode ser usado como ferramenta do AI Agent.
Exemplo: responder automaticamente
- msg.api Trigger com o evento Message Received.
- 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 and polls, and manages contacts and groups.
- Credentials: the API key of your number, from the msg.api panel.