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 14 categorias de recursos com 138 operações:
- Mensagem: Envie 38 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
- Etiqueta: Crie, edite e exclua etiquetas, marque chats
- Presença: Leia e envie o status online, digitando e gravando
- Catálogo: Produtos, coleções, pedidos e perfil comercial
- Grupo: Crie grupos, gerencie membros, administradores, configurações, convites, solicitações de entrada
- Comunidade: Crie comunidades, gerencie membros, administradores e subgrupos
- Canal: Crie canais, publique, pesquise, siga e leia estatísticas
- Story: Publique stories, veja quem os viu e gerencie a privacidade
- 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 38 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 |
Delete Profile Image | Exclua a foto de perfil da sua conta do WhatsApp |
Get Blocked Contacts | Liste os contatos bloqueados |
Add Contact | Adicione um contato à agenda do telefone |
Edit Contact | Edite um contato salvo |
Remove Contact | Remova um contato da agenda |
LID to Phone | Converta um identificador @lid em número de telefone |
Phone to LID | Converta um número de telefone no identificador @lid |
Phone to Username | Obtenha o nome de usuário do WhatsApp de um número |
Username to Phone | Converta um nome de usuário do WhatsApp em número de telefone |
Get Profile Name | Obtenha o nome de perfil do seu número |
Set Profile Name | Altere o nome de perfil do seu número |
Get Profile About | Obtenha o texto "Recado" do seu número ou de um contato |
Set Profile About | Defina o texto "Recado" do seu número |
Get Profile Username | Obtenha o nome de usuário do WhatsApp do seu número |
Set Profile Username | Defina o nome de usuário do WhatsApp do seu número |
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 |
Set Disappearing Messages | Defina o temporizador de mensagens temporárias de uma conversa (desligado, 24h, 7 dias, 90 dias) |
Operações de etiquetas
| Operação | Descrição |
|---|---|
Get Labels | Liste todas as etiquetas do número |
Get Labeled Chats | Liste os chats com uma etiqueta |
Get Label Colors | Liste as cores de etiqueta disponíveis |
Create Label | Crie uma nova etiqueta |
Edit Label | Renomeie uma etiqueta ou altere sua cor |
Delete Labels | Exclua etiquetas da conta do WhatsApp |
Add Label to Chat | Adicione uma etiqueta a um chat |
Remove Label from Chat | Remova uma etiqueta de um chat |
Operações de presença
| Operação | Descrição |
|---|---|
Get Presence | Obtenha o estado online/digitando de um contato |
Subscribe Presence | Assine as atualizações de presença de um contato |
Send Presence | Envie o status digitando, gravando ou online para um chat |
Operações de catálogo
| Operação | Descrição |
|---|---|
Get Products | Liste os produtos do catálogo do seu número ou de um contato |
Get Product | Obtenha um produto pelo ID |
Add Product | Adicione um produto ao catálogo |
Edit Product | Edite um produto do catálogo |
Remove Product | Remova um produto do catálogo |
Add Product Image | Adicione uma imagem a um produto |
Remove Product Image | Remova uma imagem de um produto |
Get Collections | Liste as coleções de produtos |
Get Collection | Obtenha uma coleção com seus produtos |
Add Collection | Crie uma coleção de produtos |
Edit Collection | Renomeie ou atualize uma coleção |
Remove Collection | Exclua uma coleção |
Add Collection Products | Adicione produtos a uma coleção |
Remove Collection Products | Remova produtos de uma coleção |
Get Orders | Liste os pedidos recebidos enquanto a sessão está ativa |
Get Order | Obtenha um pedido com seus itens |
Get Business Profile | Obtenha o perfil comercial do seu número ou de um contato |
Set Business Profile | Atualize o perfil comercial do seu número |
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 |
Accept Invite V4 | Aceite um convite de grupo (V4) recebido pelo webhook |
Operações de comunidade
| Operação | Descrição |
|---|---|
Create Community | Crie uma nova comunidade |
Get Communities | Liste todas as comunidades com seus subgrupos |
Get Community | Obtenha uma comunidade |
Add Participants | Adicione membros a uma comunidade |
Remove Participant | Remova um membro de uma comunidade |
Promote Admin | Promova um membro a administrador da comunidade |
Demote Admin | Rebaixe um administrador da comunidade |
Add Sub-Groups | Vincule grupos existentes a uma comunidade |
Remove Sub-Groups | Desvincule grupos de uma comunidade |
Revoke Invite | Revogue e gere novamente o link de convite da comunidade |
Get Unjoined Sub-Groups | Liste os subgrupos dos quais você ainda não participa |
Join Sub-Group | Entre em um subgrupo de uma comunidade |
Deactivate Community | Desative uma comunidade (irreversível) |
Operações de canal
| Operação | Descrição |
|---|---|
Create Channel | Crie um novo canal |
Get Channels | Liste os canais que você administra ou segue |
Get Channel | Obtenha um canal |
Delete Channel | Exclua um canal que você administra |
Set Channel Config | Atualize o nome, a descrição ou a imagem do canal |
Get Invite Code | Obtenha o link de convite de um canal |
Search by Country | Descubra canais por código de país |
Search by Text | Pesquise canais por texto |
Get Channel Messages | Leia as mensagens de um canal |
Subscribe | Siga um canal |
Unsubscribe | Deixe de seguir um canal |
Subscribe by Invite Code | Siga um canal usando o código de convite |
Unsubscribe by Invite Code | Deixe de seguir um canal usando o código de convite |
Get Info by Invite Code | Obtenha as informações de um canal a partir do código de convite |
Get Statistics | Obtenha as estatísticas de seguidores e alcance de um canal |
Demote Admin | Remova os direitos de administrador de um canal |
Accept Admin Invite | Aceite um convite para ser administrador do canal |
Revoke Admin Invite | Revogue um convite pendente de administrador do canal |
Operações de stories
| Operação | Descrição |
|---|---|
Create Story | Publique um story de texto, mídia ou áudio |
Get My Stories | Liste seus stories com quem os viu |
Get Contacts Stories | Liste os stories publicados pelos seus contatos |
Get Story Privacy | Veja quem pode ver seus stories |
Set Story Privacy | Defina quem pode ver seus stories |
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 |
Get Calls | Liste o histórico de chamadas |
Get Call | Obtenha uma chamada pelo ID |
Start Call | Inicie uma chamada de aviso que toca e encerra automaticamente (sem áudio) |
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 |
Get New Chat Limit | Obtenha o limite de novos chats que o WhatsApp aplica ao número |
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 138 operações em 14 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, Etiqueta, Presença, Catálogo, Grupo, Comunidade, Canal, Story, 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.