Componente megaAPI para n8n#
Este documento apresenta o componente megaAPI criado para o n8n, com o objetivo de facilitar a integração com a megaAPI (API para WhatsApp). Por meio desse componente, é possível criar chatbots, agentes de IA, ou qualquer projeto que tenha necessidade de utilizar de forma simplificada.O fluxo de trabalho ocorre da seguinte forma:Envio de dados: O usuário configura um nó Execute Workflow para acionar o cenário “componente megaAPI”.Processamento: O cenário “componente megaAPI” recebe as informações, processa o que deve ser feito (envio de mensagens, disparo de eventos etc.).Retorno: O cenário retorna a resposta da execução, incluindo dados dos webhooks recebidos.Como utilizar#
Baixar o workflow: Faça o download do arquivo do componente megaAPI (link disponível abaixo).Importar no n8n: No seu ambiente n8n, crie um novo cenário (workflow) e importe o arquivo baixado.Nomear o cenário: É fundamental que o nome do cenário seja exatamente componente megaAPI para que tudo funcione corretamente.Atenção: O componente não permite a execução simultânea de múltiplas funcionalidades. Por exemplo, não é possível enviar o evento “digitando” e disparar uma mensagem na mesma execução do workflow.
Links Importantes#
Changelog v2.0#
| Recurso | Status |
|---|
| Envio de mensagens de texto | ✅ |
| Envio de arquivos (imagem, áudio, vídeo, documentos) via URL ou Base64 | ✅ |
| Tratamento completo do webhook da megaAPI | ✅ |
| Disparos de eventos (digitando, gravando áudio, online, pausa) | ✅ |
| Melhorias no retorno das mensagens | ✅ |
| Status das mensagens enviadas | ✅ |
| Correção na função que trata a mensagem da IA, para envio de mensagens de texto no whatsapp | ✅ |
| Retorno do Base64 das midias enviadas | ✅ |
Abaixo estão os parâmetros esperados pelo cenário componente megaAPI:host (string)
Host da instância de conexão da megaAPI. Exemplo: apincode01.megaapi.com.brinstancia (string)
Instância de conexão da megaAPI. Exemplo: megacode-MLhOPtJ2iGEhjuEEtoken (string)
Token de autenticação da megaAPI, geralmente fornecido junto com a instância.tipo_de_envio (string)
Tipo de envio da mensagem (Tipos.: texto, arquivo, evento, webhook).whatsapp (string)
Número de WhatsApp de destino, incluindo código do país. Exemplo: 556195556218mensagem (string)
Texto da mensagem a ser enviada. Exemplo: teste videourl (string)
URL do arquivo (imagem, áudio, vídeo ou documento) para envio.base64 (string)
String em Base64 do arquivo a ser enviado (caso não utilize URL).Atenção:
Preencha apenas um dos dois campos.Se for enviar um arquivo via URL, utilize o campo url.
Se for enviar um arquivo em Base64, utilize o campo base64.⚠️ Não preencha ambos ao mesmo tempo.
Nome do arquivo que será enviado.arquivo (string)
Tipo de arquivo que esta sendo enviado (Tipos.: imagem, video, audio, pdf, xlsx, word, php, bin, html, sql).tipo_de_evento (string)
Tipo de evento a ser disparado (Tipos.: digitando, gravando, online, pausa).webhook (string)
Payload completo do webhook recebido, no formato JSON(string).Conclusão#
Com o componente megaAPI para n8n, é possível integrar de forma simples a megaAPI para envio de mensagens, disparos de eventos e recebimento de webhooks do WhatsApp. Siga as etapas de download, importação e configuração do cenário (com o nome componente megaAPI) para aproveitar todos os recursos já disponíveis nesta versão v1.0.Em caso de dúvidas, consulte o tutorial em vídeo no YouTube e fique atento aos próximos changelogs para novas funcionalidades e melhorias.