Maytapi
Maytapi Integración n8n para WhatsApp API
Nodos personalizados oficiales de Maytapi para la plataforma de automatización de flujos de trabajo n8n. Automatiza la mensajería de WhatsApp, gestiona contactos, grupos, sesiones y más con flujos de trabajo visuales de arrastrar y soltar. Conecta WhatsApp a más de 400 aplicaciones y servicios sin escribir código.
¿Qué es n8n?
n8n es una potente plataforma de automatización de flujos de trabajo de código abierto que te permite conectar diferentes aplicaciones y servicios de forma visual. Crea automatizaciones complejas usando una interfaz de arrastrar y soltar sin escribir código.
Con los nodos oficiales de Maytapi para n8n, puedes integrar WhatsApp en cualquier flujo de trabajo: enviar mensajes, gestionar grupos, manejar contactos, recibir eventos webhook en tiempo real y automatizar todo tu canal de comunicación de WhatsApp.
Configuración Rápida
Instala a través de n8n Community Nodes o npm:
npm install @maytapi/n8n-nodes-maytapiCredenciales necesarias:
- Product ID: Desde la Consola de Maytapi
- API Token: Tu x-maytapi-key
- Phone ID: (Opcional) Instancia de WhatsApp predeterminada
Cómo Funciona
Instala el Paquete
En n8n, ve a Settings → Community Nodes → Install e ingresa @maytapi/n8n-nodes-maytapi. O instálalo manualmente a través de npm y reinicia n8n.
Agrega las Credenciales
Crea una nueva credencial de Maytapi API con tu Product ID y API Token desde la Consola de Maytapi. Opcionalmente, establece un Phone ID predeterminado.
Crea Flujos de Trabajo
Agrega nodos de Maytapi o Maytapi Trigger a tus flujos de trabajo y conéctalos con más de 400 aplicaciones y servicios en n8n.
Dos Nodos Poderosos
El paquete incluye dos nodos dedicados que cubren toda la Maytapi WhatsApp API.
Nodo Maytapi (Acciones)
Realiza operaciones de WhatsApp en tus flujos de trabajo. Soporta 9 categorías de recursos con más de 50 operaciones:
- Mensaje: Envía más de 23 tipos de mensajes (texto, multimedia, encuesta, ubicación, vcard, botones, lista, sticker, reacción, reenvío, eliminar, editar y más)
- Contacto: Obtén contactos, verifica números de teléfono, bloquea/desbloquea, imágenes de perfil
- Chat: Lista conversaciones, archivar, fijar, silenciar, favoritos, borrar historial
- Grupo: Crea grupos, gestiona miembros, administradores, configuración, invitaciones, solicitudes de unión
- Cola: Listar, obtener y borrar colas de mensajes
- Llamada: Rechazar llamadas, crear enlaces de llamadas de voz/video
- Cuenta: Gestiona teléfonos, webhooks, registros, información del producto
- Sesión: Verificar estado, obtener código QR, cerrar sesión, conectar con número de teléfono
- Control de Sesión: Redesplegar, restablecimiento de fábrica, obtener/establecer configuración
Nodo Maytapi Trigger (Webhooks)
Recibe eventos de WhatsApp en tiempo real para activar tus flujos de trabajo. Selecciona qué eventos escuchar:
- Eventos de Mensajes: Nuevos mensajes entrantes/salientes con metadatos completos (tipo, subtipo, remitente, texto, multimedia, marca de tiempo)
- Eventos ACK: Cambios en el estado de entrega de mensajes (enviado, entregado, leído)
- Eventos de Grupo: Uniones de miembros, salidas, invitaciones, eliminaciones, cambios de configuración
- Eventos de Llamada: Llamadas entrantes, salientes, perdidas, rechazadas
- Eventos de Historia: Nuevas historias publicadas por contactos
Los webhooks se configuran automáticamente cuando activas el flujo de trabajo y se limpian cuando lo desactivas.
Operaciones Disponibles
Lista completa de operaciones disponibles en el Nodo Maytapi, agrupadas por recurso.
Operaciones de Mensaje
| Operación | Descripción |
|---|---|
Send Message | Envía mensajes a cualquier chat. Soporta más de 23 tipos de mensajes: texto, multimedia, encuesta, ubicación, vcard, contacto, enlace, producto, botones, lista, sticker, video corto, reenvío, eliminar, reacción, quitar reacción, editar, invitación de grupo, fijar mensaje, destacar, crear evento, respuesta de texto a historia y respuesta multimedia a historia. |
Get Message | Recupera información sobre un mensaje específico por ID |
Get Messages | Recupera mensajes de una conversación con paginación, filtro de autor y filtro de mensajes propios |
Operaciones de Contacto
| Operación | Descripción |
|---|---|
Get Contacts | Lista todos los contactos de WhatsApp |
Get Contact | Obtén información de un contacto específico |
Check Phones | Verifica si los números de teléfono están registrados en WhatsApp |
Block Contact | Bloquea o desbloquea un contacto |
Get Profile Image | Obtén la foto de perfil de un contacto o grupo |
Set Profile Image | Establece la foto de perfil de tu cuenta de WhatsApp |
Operaciones de Chat
| Operación | Descripción |
|---|---|
Get Conversations | Lista todas las conversaciones/chats con paginación |
Get Conversation | Obtén los detalles de una conversación específica con mensajes |
Favorite Chat | Agrega o elimina una conversación de favoritos |
Pin Chat | Fija o desfija una conversación |
Archive Chat | Archiva o desarchiva una conversación |
Mute Chat | Silencia o activa una conversación (8 horas, 1 semana o para siempre) |
Clear Chat | Borra todos los mensajes de una conversación |
Operaciones de Grupo
| Operación | Descripción |
|---|---|
Create Group | Crea un nuevo grupo de WhatsApp con participantes, mensaje de invitación opcional e imagen de perfil |
Get Groups | Lista todos los grupos con carga opcional de participantes, ordenamiento, enlaces de invitación y paginación |
Get Group | Obtén información de un grupo específico con generación opcional de enlace de invitación |
Set Group Image | Establece la foto de perfil del grupo |
Delete Group Image | Elimina la foto de perfil del grupo |
Add Participants | Agrega miembros a un grupo con invitación opcional |
Remove Participant | Elimina un miembro de un grupo |
Promote Admin | Promueve a un participante a administrador |
Demote Admin | Degrada a un administrador a participante |
Set Group Config | Configura los ajustes del grupo: permisos, mensajes temporales, aprobación de adición de miembros, nombre, descripción |
Accept Invite | Acepta una invitación de grupo mediante código de invitación |
Revoke Invite | Revoca y regenera el enlace de invitación del grupo |
Leave Group | Salir de un grupo de WhatsApp |
Get Approval Requests | Lista las solicitudes de unión pendientes de un grupo |
Approve Join Requests | Aprueba solicitudes de unión pendientes |
Reject Join Requests | Rechaza solicitudes de unión pendientes |
Get Group Info by Invite Code | Obtén información del grupo usando el código de invitación |
Operaciones de Cola
| Operación | Descripción |
|---|---|
List Queues | Lista todas las colas de mensajes de teléfonos |
Get Queue | Obtén la cola de mensajes de un teléfono específico |
Clear Queue | Borra la cola de mensajes del teléfono |
Operaciones de Llamada
| Operación | Descripción |
|---|---|
Reject Call | Rechaza una llamada entrante (callId obtenido de la notificación webhook) |
Create Call Link | Crea un enlace de llamada compartible para llamadas de voz o video con marca de tiempo programada |
Operaciones de Cuenta
| Operación | Descripción |
|---|---|
Get Product Info | Obtén información del producto |
Add Phone | Agrega un nuevo teléfono al producto con número de teléfono opcional |
List Phones | Lista todos los teléfonos registrados |
Set Webhook | Configura la URL del webhook para el producto |
Set ACK Preference | Activa o desactiva las notificaciones de confirmación a través de webhook |
Get Logs | Obtén registros de todos los teléfonos |
Get Phone Logs | Obtén registros de un teléfono específico |
Operaciones de Sesión
| Operación | Descripción |
|---|---|
Get Status | Verifica el estado de conexión de la sesión |
Get Screen | Obtén una captura de pantalla de la sesión actual (devuelve imagen binaria) |
Get QR Code | Obtén el código QR para vincular el teléfono (devuelve imagen binaria) |
Logout | Desconecta la sesión de WhatsApp |
Connect with Phone Number | Conéctate usando número de teléfono en lugar de código QR |
Operaciones de Control de Sesión
| Operación | Descripción |
|---|---|
Redeploy | Redesplegar la instancia Docker para reiniciar la sesión |
Factory Reset | Restablecimiento de fábrica del teléfono al estado inicial |
Get Config | Obtén la configuración específica del teléfono |
Set Config | Establece la URL del webhook específica del teléfono y la configuración de entrega ACK |
Eventos del Webhook Trigger
| Tipo de Evento | Descripción |
|---|---|
Message | Nuevos mensajes entrantes/salientes con metadatos completos: tipo de mensaje, subtipo, número del remitente, nombre del remitente, receptor, texto del mensaje, ID del mensaje, marca de tiempo, detalles de la conversación |
ACK | Cambios en el estado de entrega del mensaje: enviado, entregado, leído -- con ID del mensaje y marca de tiempo |
Group | Eventos de miembros del grupo: uniones, salidas, invitaciones, eliminaciones, cambios de configuración -- con ID del grupo, nombre, tipo de acción y detalles del participante |
Call | Eventos de llamada: entrantes, salientes, perdidas, rechazadas -- con ID de la llamada, estado y detalles del llamante |
Story | Eventos de historias: nuevas historias publicadas por contactos -- con ID de la historia, remitente, tipo de historia y contenido |
¿Por Qué Usar los Nodos Maytapi para n8n?
Lleva todo el poder de WhatsApp API a tus flujos de trabajo n8n con nodos diseñados específicamente.
- Cobertura completa de la API con más de 50 operaciones en 9 categorías de recursos
- Triggers webhook en tiempo real para mensajes, estado de entrega, eventos de grupo, llamadas e historias
- No se requiere programación -- constructor visual de flujos de trabajo con arrastrar y soltar
- Flexibilidad de Phone ID -- usa el predeterminado o uno personalizado por operación
- Manejo de errores integrado con lógica de reintentos y mensajes de error detallados
- Conecta WhatsApp a más de 400 aplicaciones: CRM, bases de datos, correo electrónico, Slack y más
Automatiza tu comunicación de WhatsApp con las herramientas que ya utilizas.
Detalles Técnicos
Nombre del Paquete:
@maytapi/n8n-nodes-maytapi
Endpoint de la API:
https://api.maytapi.com/api/{pid}
Autenticación:
- Header:
x-maytapi-key - Product ID en la ruta de la URL
- Parámetro Phone ID opcional por operación
Recursos:
Message, Contact, Chat, Group, Queue, Call, Account, Session, Session Control
¿Listo para potenciar tu comunicación en WhatsApp?
Desbloquea características poderosas para mensajería empresarial y automatización con nuestra API de WhatsApp
Perfecto para empresas, desarrolladores y usuarios avanzados
Preguntas Frecuentes
¿Cómo instalo los nodos Maytapi para n8n?
Ve a Settings → Community Nodes → Install en tu instancia de n8n y busca @maytapi/n8n-nodes-maytapi. O instálalo manualmente a través de npm: npm install @maytapi/n8n-nodes-maytapi y reinicia n8n.
¿Qué credenciales necesito?
Necesitas tu Product ID y API Token de la Consola de Maytapi. Opcionalmente, puedes especificar un Phone ID predeterminado para tu instancia de WhatsApp.
¿Puedo usar múltiples números de WhatsApp?
¡Sí! Puedes establecer un Phone ID predeterminado en las credenciales o anularlo por nodo. La opción "Phone ID Source" te permite elegir entre las credenciales o un Phone ID personalizado para cada operación.
¿Cómo funcionan los webhooks con n8n?
El nodo Maytapi Trigger configura automáticamente los webhooks con Maytapi cuando activas el flujo de trabajo. Puedes seleccionar qué eventos recibir (mensajes, ACK, grupos, llamadas, historias). El webhook se limpia automáticamente cuando desactivas el flujo de trabajo.
¿Qué tipos de mensajes puedo enviar?
La operación Send Message soporta todos los tipos de mensajes de Maytapi: texto, imágenes, videos, documentos, audio, ubicación, tarjetas de contacto, stickers, encuestas, reacciones, botones, mensajes de lista, video corto, reenvío, eliminar, editar, fijar y más.
¿La integración con n8n es gratuita?
El paquete de nodos Maytapi para n8n es gratuito y de código abierto. Solo necesitas una suscripción activa de Maytapi para usar la WhatsApp API. Todos los planes de Maytapi incluyen acceso completo a la API sin costos adicionales por la integración con n8n.