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 14 categorías de recursos con 138 operaciones:
- Mensaje: Envía 38 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
- Etiqueta: Crea, edita y elimina etiquetas, etiqueta chats
- Presencia: Lee y envía el estado en línea, escribiendo y grabando
- Catálogo: Productos, colecciones, pedidos y perfil de empresa
- Grupo: Crea grupos, gestiona miembros, administradores, configuración, invitaciones, solicitudes de unión
- Comunidad: Crea comunidades, gestiona miembros, administradores y subgrupos
- Canal: Crea canales, publica, busca, sigue y consulta estadísticas
- Historia: Publica historias, consulta espectadores y gestiona la privacidad
- 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 38 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 |
Delete Profile Image | Elimina la foto de perfil de tu cuenta de WhatsApp |
Get Blocked Contacts | Lista los contactos bloqueados |
Add Contact | Añade un contacto a la agenda del teléfono |
Edit Contact | Edita un contacto guardado |
Remove Contact | Elimina un contacto de la agenda |
LID to Phone | Convierte un identificador @lid en número de teléfono |
Phone to LID | Convierte un número de teléfono en su identificador @lid |
Phone to Username | Obtén el nombre de usuario de WhatsApp de un número |
Username to Phone | Convierte un nombre de usuario de WhatsApp en número de teléfono |
Get Profile Name | Obtén el nombre de perfil de tu número |
Set Profile Name | Cambia el nombre de perfil de tu número |
Get Profile About | Obtén el texto "Info" de tu número o de un contacto |
Set Profile About | Define el texto "Info" de tu número |
Get Profile Username | Obtén el nombre de usuario de WhatsApp de tu número |
Set Profile Username | Define el nombre de usuario de WhatsApp de tu número |
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 |
Set Disappearing Messages | Define el temporizador de mensajes temporales de una conversación (apagado, 24 h, 7 días, 90 días) |
Operaciones de etiquetas
| Operación | Descripción |
|---|---|
Get Labels | Lista todas las etiquetas del número |
Get Labeled Chats | Lista los chats con una etiqueta |
Get Label Colors | Lista los colores de etiqueta disponibles |
Create Label | Crea una etiqueta nueva |
Edit Label | Renombra una etiqueta o cambia su color |
Delete Labels | Elimina etiquetas de la cuenta de WhatsApp |
Add Label to Chat | Añade una etiqueta a un chat |
Remove Label from Chat | Quita una etiqueta de un chat |
Operaciones de presencia
| Operación | Descripción |
|---|---|
Get Presence | Obtén el estado en línea/escribiendo de un contacto |
Subscribe Presence | Suscríbete a las actualizaciones de presencia de un contacto |
Send Presence | Envía el estado escribiendo, grabando o en línea a un chat |
Operaciones de catálogo
| Operación | Descripción |
|---|---|
Get Products | Lista los productos del catálogo de tu número o de un contacto |
Get Product | Obtén un producto por su ID |
Add Product | Añade un producto al catálogo |
Edit Product | Edita un producto del catálogo |
Remove Product | Elimina un producto del catálogo |
Add Product Image | Añade una imagen a un producto |
Remove Product Image | Elimina una imagen de un producto |
Get Collections | Lista las colecciones de productos |
Get Collection | Obtén una colección con sus productos |
Add Collection | Crea una colección de productos |
Edit Collection | Renombra o actualiza una colección |
Remove Collection | Elimina una colección |
Add Collection Products | Añade productos a una colección |
Remove Collection Products | Quita productos de una colección |
Get Orders | Lista los pedidos recibidos mientras la sesión está activa |
Get Order | Obtén un pedido con sus artículos |
Get Business Profile | Obtén el perfil de empresa de tu número o de un contacto |
Set Business Profile | Actualiza el perfil de empresa de tu número |
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 |
Accept Invite V4 | Acepta una invitación de grupo (V4) recibida por webhook |
Operaciones de comunidad
| Operación | Descripción |
|---|---|
Create Community | Crea una comunidad nueva |
Get Communities | Lista todas las comunidades con sus subgrupos |
Get Community | Obtén una comunidad |
Add Participants | Añade miembros a una comunidad |
Remove Participant | Elimina un miembro de una comunidad |
Promote Admin | Asciende a un miembro a administrador de la comunidad |
Demote Admin | Degrada a un administrador de la comunidad |
Add Sub-Groups | Vincula grupos existentes a una comunidad |
Remove Sub-Groups | Desvincula grupos de una comunidad |
Revoke Invite | Revoca y regenera el enlace de invitación de la comunidad |
Get Unjoined Sub-Groups | Lista los subgrupos a los que aún no te has unido |
Join Sub-Group | Únete a un subgrupo de una comunidad |
Deactivate Community | Desactiva una comunidad (irreversible) |
Operaciones de canal
| Operación | Descripción |
|---|---|
Create Channel | Crea un canal nuevo |
Get Channels | Lista los canales que administras o sigues |
Get Channel | Obtén un canal |
Delete Channel | Elimina un canal que administras |
Set Channel Config | Actualiza el nombre, la descripción o la imagen del canal |
Get Invite Code | Obtén el enlace de invitación de un canal |
Search by Country | Descubre canales por código de país |
Search by Text | Busca canales por texto |
Get Channel Messages | Lee los mensajes de un canal |
Subscribe | Sigue un canal |
Unsubscribe | Deja de seguir un canal |
Subscribe by Invite Code | Sigue un canal con su código de invitación |
Unsubscribe by Invite Code | Deja de seguir un canal con su código de invitación |
Get Info by Invite Code | Obtén la información de un canal a partir del código de invitación |
Get Statistics | Obtén las estadísticas de seguidores y alcance de un canal |
Demote Admin | Quita los permisos de administrador de un canal |
Accept Admin Invite | Acepta una invitación para ser administrador del canal |
Revoke Admin Invite | Revoca una invitación pendiente de administrador del canal |
Operaciones de historias
| Operación | Descripción |
|---|---|
Create Story | Publica una historia de texto, multimedia o audio |
Get My Stories | Lista tus historias con sus espectadores |
Get Contacts Stories | Lista las historias publicadas por tus contactos |
Get Story Privacy | Consulta quién puede ver tus historias |
Set Story Privacy | Define quién puede ver tus historias |
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 |
Get Calls | Lista el historial de llamadas |
Get Call | Obtén una llamada por su ID |
Start Call | Inicia una llamada saliente de aviso que suena y termina sola (sin audio) |
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 |
Get New Chat Limit | Obtén el límite de chats nuevos que WhatsApp aplica al número |
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 138 operaciones en 14 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, Label, Presence, Business Catalog, Group, Community, Channel, Story, 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.