Maytapi
Maytapi Integração n8n para WhatsApp API
Nós personalizados oficiais do Maytapi para a plataforma de automação de fluxos de trabalho n8n. Automatize mensagens do WhatsApp, gerencie contatos, grupos, sessões e muito mais com fluxos de trabalho visuais de arrastar e soltar. Conecte o WhatsApp a mais de 400 aplicativos e serviços sem escrever código.
O que é o n8n?
O n8n é uma poderosa plataforma de automação de fluxos de trabalho de código aberto que permite conectar diferentes aplicativos e serviços visualmente. Crie automações complexas usando uma interface de arrastar e soltar sem escrever código.
Com os nós oficiais do Maytapi para n8n, você pode integrar o WhatsApp em qualquer fluxo de trabalho -- enviar mensagens, gerenciar grupos, lidar com contatos, receber eventos de webhook em tempo real e automatizar todo o seu pipeline de comunicação do WhatsApp.
Configuração Rápida
Instale via n8n Community Nodes ou npm:
npm install @maytapi/n8n-nodes-maytapiCredenciais necessárias:
- Product ID: Do Console do Maytapi
- API Token: Sua x-maytapi-key
- Phone ID: (Opcional) Instância padrão do WhatsApp
Como Funciona
Instale o Pacote
No n8n, vá em Settings → Community Nodes → Install e digite @maytapi/n8n-nodes-maytapi. Ou instale manualmente via npm e reinicie o n8n.
Adicione as Credenciais
Crie uma nova credencial Maytapi API com seu Product ID e API Token do Console do Maytapi. Opcionalmente, defina um Phone ID padrão.
Crie Fluxos de Trabalho
Adicione os nós Maytapi ou Maytapi Trigger aos seus fluxos de trabalho e conecte-os com mais de 400 outros aplicativos e serviços no n8n.
Dois Nós Poderosos
O pacote inclui dois nós dedicados cobrindo toda a Maytapi WhatsApp API.
Nó Maytapi (Ações)
Execute operações do WhatsApp nos seus fluxos de trabalho. Suporta 9 categorias de recursos com mais de 50 operações:
- Mensagem: Envie mais de 23 tipos de mensagem (texto, mídia, enquete, localização, vcard, botões, lista, sticker, reação, encaminhar, excluir, editar e mais)
- Contato: Obtenha contatos, verifique números de telefone, bloqueie/desbloqueie, imagens de perfil
- Chat: Liste conversas, arquive, fixe, silencie, favorite, limpe o histórico
- Grupo: Crie grupos, gerencie membros, administradores, configurações, convites, solicitações de entrada
- Fila: Liste, obtenha e limpe filas de mensagens
- Chamada: Rejeite chamadas, crie links de chamada de voz/vídeo
- Conta: Gerencie telefones, webhooks, logs, informações do produto
- Sessão: Verifique o status, obtenha o código QR, desconecte, conecte com número de telefone
- Controle de Sessão: Reimplante, restauração de fábrica, obtenha/defina configurações
Nó Maytapi Trigger (Webhooks)
Receba eventos do WhatsApp em tempo real para acionar seus fluxos de trabalho. Selecione quais eventos deseja monitorar:
- Eventos de Mensagem: Novas mensagens recebidas/enviadas com metadados completos (tipo, subtipo, remetente, texto, mídia, timestamp)
- Eventos ACK: Alterações no status de entrega de mensagens (enviada, entregue, lida)
- Eventos de Grupo: Entradas de membros, saídas, convites, remoções, alterações de configurações
- Eventos de Chamada: Chamadas recebidas, realizadas, perdidas, rejeitadas
- Eventos de Story: Novos stories publicados por contatos
Os webhooks são configurados automaticamente quando você ativa o fluxo de trabalho e removidos quando você o desativa.
Operações Disponíveis
Lista completa de operações disponíveis no Nó Maytapi, agrupadas por recurso.
Operações de Mensagem
| Operação | Descrição |
|---|---|
Send Message | Envie mensagens para qualquer chat. Suporta mais de 23 tipos de mensagem: texto, mídia, enquete, localização, vcard, contato, link, produto, botões, lista, sticker, vídeo curto, encaminhar, excluir, reação, remover reação, editar, convite de grupo, fixar mensagem, favoritar, criar evento, resposta de story em texto e resposta de story em mídia. |
Get Message | Recupere informações sobre uma mensagem específica pelo ID |
Get Messages | Recupere mensagens de uma conversa com paginação, filtro por autor e filtro fromMe |
Operações de Contato
| Operação | Descrição |
|---|---|
Get Contacts | Liste todos os contatos do WhatsApp |
Get Contact | Obtenha informações de um contato específico |
Check Phones | Verifique se números de telefone estão registrados no WhatsApp |
Block Contact | Bloqueie ou desbloqueie um contato |
Get Profile Image | Obtenha a foto de perfil de um contato ou grupo |
Set Profile Image | Defina a foto de perfil da sua conta do WhatsApp |
Operações de Chat
| Operação | Descrição |
|---|---|
Get Conversations | Liste todas as conversas/chats com paginação |
Get Conversation | Obtenha detalhes de uma conversa específica com mensagens |
Favorite Chat | Adicione ou remova uma conversa dos favoritos |
Pin Chat | Fixe ou desafixe uma conversa |
Archive Chat | Arquive ou desarquive uma conversa |
Mute Chat | Silencie ou ative o som de uma conversa (8 horas, 1 semana ou para sempre) |
Clear Chat | Limpe todas as mensagens de uma conversa |
Operações de Grupo
| Operação | Descrição |
|---|---|
Create Group | Crie um novo grupo do WhatsApp com participantes, mensagem de convite opcional e imagem de perfil |
Get Groups | Liste todos os grupos com carregamento opcional de participantes, ordenação, links de convite e paginação |
Get Group | Obtenha informações de um grupo específico com geração opcional de link de convite |
Set Group Image | Defina a foto de perfil do grupo |
Delete Group Image | Exclua a foto de perfil do grupo |
Add Participants | Adicione membros a um grupo com convite opcional |
Remove Participant | Remova um membro de um grupo |
Promote Admin | Promova um participante a administrador |
Demote Admin | Rebaixe um administrador a participante |
Set Group Config | Configure as configurações do grupo: permissões, mensagens temporárias, aprovação de adição de membros, nome, descrição |
Accept Invite | Aceite um convite de grupo pelo código de convite |
Revoke Invite | Revogue e regenere o link de convite do grupo |
Leave Group | Saia de um grupo do WhatsApp |
Get Approval Requests | Liste solicitações de entrada pendentes de um grupo |
Approve Join Requests | Aprove solicitações de entrada pendentes |
Reject Join Requests | Rejeite solicitações de entrada pendentes |
Get Group Info by Invite Code | Obtenha informações do grupo usando o código de convite |
Operações de Fila
| Operação | Descrição |
|---|---|
List Queues | Liste todas as filas de mensagens dos telefones |
Get Queue | Obtenha a fila de mensagens de um telefone específico |
Clear Queue | Limpe a fila de mensagens do telefone |
Operações de Chamada
| Operação | Descrição |
|---|---|
Reject Call | Rejeite uma chamada recebida (callId obtido pela notificação de webhook) |
Create Call Link | Crie um link compartilhável de chamada de voz ou vídeo com timestamp agendado |
Operações de Conta
| Operação | Descrição |
|---|---|
Get Product Info | Obtenha informações do produto |
Add Phone | Adicione um novo telefone ao produto com número de telefone opcional |
List Phones | Liste todos os telefones registrados |
Set Webhook | Configure a URL de webhook do produto |
Set ACK Preference | Ative ou desative notificações de confirmação via webhook |
Get Logs | Obtenha logs de todos os telefones |
Get Phone Logs | Obtenha logs de um telefone específico |
Operações de Sessão
| Operação | Descrição |
|---|---|
Get Status | Verifique o status de conexão da sessão |
Get Screen | Obtenha uma captura de tela da sessão atual (retorna imagem binária) |
Get QR Code | Obtenha o código QR para pareamento do telefone (retorna imagem binária) |
Logout | Desconecte a sessão do WhatsApp |
Connect with Phone Number | Conecte usando o número de telefone em vez do código QR |
Operações de Controle de Sessão
| Operação | Descrição |
|---|---|
Redeploy | Reimplante a instância Docker para reiniciar a sessão |
Factory Reset | Restauração de fábrica do telefone para o estado inicial |
Get Config | Obtenha a configuração específica do telefone |
Set Config | Defina a URL de webhook específica do telefone e configurações de entrega ACK |
Eventos do Webhook Trigger
| Tipo de Evento | Descrição |
|---|---|
Message | Novas mensagens recebidas/enviadas com metadados completos: tipo de mensagem, subtipo, número do remetente, nome do remetente, destinatário, texto da mensagem, ID da mensagem, timestamp, detalhes da conversa |
ACK | Alterações no status de entrega de mensagens: enviada, entregue, lida -- com ID da mensagem e timestamp |
Group | Eventos de membros do grupo: entradas, saídas, convites, remoções, alterações de configurações -- com ID do grupo, nome, tipo de ação e detalhes dos participantes |
Call | Eventos de chamada: recebidas, realizadas, perdidas, rejeitadas -- com ID da chamada, status e detalhes do chamador |
Story | Eventos de story: novos stories publicados por contatos -- com ID do story, remetente, tipo do story e conteúdo |
Por que Usar os Nós Maytapi para n8n?
Traga todo o poder da WhatsApp API para seus fluxos de trabalho n8n com nós desenvolvidos especificamente para isso.
- Cobertura completa da API com mais de 50 operações em 9 categorias de recursos
- Triggers de webhook em tempo real para mensagens, status de entrega, eventos de grupo, chamadas e stories
- Sem necessidade de código -- construtor visual de fluxos de trabalho com arrastar e soltar
- Flexibilidade de Phone ID -- use o padrão ou um Phone ID personalizado por operação
- Tratamento de erros integrado com lógica de tentativas e mensagens de erro detalhadas
- Conecte o WhatsApp a mais de 400 aplicativos: CRMs, bancos de dados, e-mail, Slack e mais
Automatize sua comunicação no WhatsApp com as ferramentas que você já utiliza.
Detalhes Técnicos
Nome do Pacote:
@maytapi/n8n-nodes-maytapi
Endpoint da API:
https://api.maytapi.com/api/{pid}
Autenticação:
- Header:
x-maytapi-key - Product ID no caminho da URL
- Parâmetro Phone ID opcional por operação
Recursos:
Mensagem, Contato, Chat, Grupo, Fila, Chamada, Conta, Sessão, Controle de Sessão
Pronto para turbinar sua comunicação no WhatsApp?
Desbloqueie recursos poderosos para mensagens empresariais e automação com nossa API do WhatsApp
Perfeito para empresas, desenvolvedores e usuários avançados
Perguntas Frequentes
Como instalo os nós Maytapi para n8n?
Vá em Settings → Community Nodes → Install na sua instância do n8n e procure por @maytapi/n8n-nodes-maytapi. Ou instale manualmente via npm: npm install @maytapi/n8n-nodes-maytapi e reinicie o n8n.
Quais credenciais eu preciso?
Você precisa do seu Product ID e API Token do Console do Maytapi. Opcionalmente, você pode especificar um Phone ID padrão para sua instância do WhatsApp.
Posso usar múltiplos números de WhatsApp?
Sim! Você pode definir um Phone ID padrão nas credenciais ou substituí-lo por nó. A opção "Phone ID Source" permite escolher entre credenciais ou Phone ID personalizado para cada operação.
Como os webhooks funcionam com o n8n?
O nó Maytapi Trigger configura automaticamente os webhooks com o Maytapi quando você ativa o fluxo de trabalho. Você pode selecionar quais eventos deseja receber (mensagens, ACK, grupos, chamadas, stories). O webhook é removido automaticamente quando você desativa o fluxo de trabalho.
Quais tipos de mensagem posso enviar?
A operação Send Message suporta todos os tipos de mensagem do Maytapi: texto, imagens, vídeos, documentos, áudio, localização, cartões de contato, stickers, enquetes, reações, botões, mensagens de lista, vídeo curto, encaminhar, excluir, editar, fixar e mais.
A integração com o n8n é gratuita?
O pacote de nós Maytapi para n8n é gratuito e de código aberto. Você só precisa de uma assinatura ativa do Maytapi para usar a WhatsApp API. Todos os planos do Maytapi incluem acesso completo à API sem taxas adicionais para a integração com o n8n.