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-maytapi

Credenciais 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

1
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.

2
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.

3
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 MessageEnvie 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 MessageRecupere informações sobre uma mensagem específica pelo ID
Get MessagesRecupere mensagens de uma conversa com paginação, filtro por autor e filtro fromMe

Operações de Contato

Operação Descrição
Get ContactsListe todos os contatos do WhatsApp
Get ContactObtenha informações de um contato específico
Check PhonesVerifique se números de telefone estão registrados no WhatsApp
Block ContactBloqueie ou desbloqueie um contato
Get Profile ImageObtenha a foto de perfil de um contato ou grupo
Set Profile ImageDefina a foto de perfil da sua conta do WhatsApp

Operações de Chat

Operação Descrição
Get ConversationsListe todas as conversas/chats com paginação
Get ConversationObtenha detalhes de uma conversa específica com mensagens
Favorite ChatAdicione ou remova uma conversa dos favoritos
Pin ChatFixe ou desafixe uma conversa
Archive ChatArquive ou desarquive uma conversa
Mute ChatSilencie ou ative o som de uma conversa (8 horas, 1 semana ou para sempre)
Clear ChatLimpe todas as mensagens de uma conversa

Operações de Grupo

Operação Descrição
Create GroupCrie um novo grupo do WhatsApp com participantes, mensagem de convite opcional e imagem de perfil
Get GroupsListe todos os grupos com carregamento opcional de participantes, ordenação, links de convite e paginação
Get GroupObtenha informações de um grupo específico com geração opcional de link de convite
Set Group ImageDefina a foto de perfil do grupo
Delete Group ImageExclua a foto de perfil do grupo
Add ParticipantsAdicione membros a um grupo com convite opcional
Remove ParticipantRemova um membro de um grupo
Promote AdminPromova um participante a administrador
Demote AdminRebaixe um administrador a participante
Set Group ConfigConfigure as configurações do grupo: permissões, mensagens temporárias, aprovação de adição de membros, nome, descrição
Accept InviteAceite um convite de grupo pelo código de convite
Revoke InviteRevogue e regenere o link de convite do grupo
Leave GroupSaia de um grupo do WhatsApp
Get Approval RequestsListe solicitações de entrada pendentes de um grupo
Approve Join RequestsAprove solicitações de entrada pendentes
Reject Join RequestsRejeite solicitações de entrada pendentes
Get Group Info by Invite CodeObtenha informações do grupo usando o código de convite

Operações de Fila

Operação Descrição
List QueuesListe todas as filas de mensagens dos telefones
Get QueueObtenha a fila de mensagens de um telefone específico
Clear QueueLimpe a fila de mensagens do telefone

Operações de Chamada

Operação Descrição
Reject CallRejeite uma chamada recebida (callId obtido pela notificação de webhook)
Create Call LinkCrie um link compartilhável de chamada de voz ou vídeo com timestamp agendado

Operações de Conta

Operação Descrição
Get Product InfoObtenha informações do produto
Add PhoneAdicione um novo telefone ao produto com número de telefone opcional
List PhonesListe todos os telefones registrados
Set WebhookConfigure a URL de webhook do produto
Set ACK PreferenceAtive ou desative notificações de confirmação via webhook
Get LogsObtenha logs de todos os telefones
Get Phone LogsObtenha logs de um telefone específico

Operações de Sessão

Operação Descrição
Get StatusVerifique o status de conexão da sessão
Get ScreenObtenha uma captura de tela da sessão atual (retorna imagem binária)
Get QR CodeObtenha o código QR para pareamento do telefone (retorna imagem binária)
LogoutDesconecte a sessão do WhatsApp
Connect with Phone NumberConecte usando o número de telefone em vez do código QR

Operações de Controle de Sessão

Operação Descrição
RedeployReimplante a instância Docker para reiniciar a sessão
Factory ResetRestauração de fábrica do telefone para o estado inicial
Get ConfigObtenha a configuração específica do telefone
Set ConfigDefina a URL de webhook específica do telefone e configurações de entrega ACK

Eventos do Webhook Trigger

Tipo de Evento Descrição
MessageNovas 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
ACKAlterações no status de entrega de mensagens: enviada, entregue, lida -- com ID da mensagem e timestamp
GroupEventos 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
CallEventos de chamada: recebidas, realizadas, perdidas, rejeitadas -- com ID da chamada, status e detalhes do chamador
StoryEventos 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/{productId}

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

Explore a 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.

Explore a WhatsApp API para Seu Cliente

Desbloqueie o Potencial Completo da WhatsApp API com Recursos Ilimitados Personalizado para o Sucesso da Sua Marca

Entre em contato conosco para se tornar nosso parceiro. Envie um e-mail para discutir qualquer condição, acordo e preços.