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

Credenciales necesarias:

  • Product ID: Desde la Consola de Maytapi
  • API Token: Tu x-maytapi-key
  • Phone ID: (Opcional) Instancia de WhatsApp predeterminada

Cómo Funciona

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

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

3
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 MessageEnví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 MessageRecupera información sobre un mensaje específico por ID
Get MessagesRecupera mensajes de una conversación con paginación, filtro de autor y filtro de mensajes propios

Operaciones de Contacto

Operación Descripción
Get ContactsLista todos los contactos de WhatsApp
Get ContactObtén información de un contacto específico
Check PhonesVerifica si los números de teléfono están registrados en WhatsApp
Block ContactBloquea o desbloquea un contacto
Get Profile ImageObtén la foto de perfil de un contacto o grupo
Set Profile ImageEstablece la foto de perfil de tu cuenta de WhatsApp

Operaciones de Chat

Operación Descripción
Get ConversationsLista todas las conversaciones/chats con paginación
Get ConversationObtén los detalles de una conversación específica con mensajes
Favorite ChatAgrega o elimina una conversación de favoritos
Pin ChatFija o desfija una conversación
Archive ChatArchiva o desarchiva una conversación
Mute ChatSilencia o activa una conversación (8 horas, 1 semana o para siempre)
Clear ChatBorra todos los mensajes de una conversación

Operaciones de Grupo

Operación Descripción
Create GroupCrea un nuevo grupo de WhatsApp con participantes, mensaje de invitación opcional e imagen de perfil
Get GroupsLista todos los grupos con carga opcional de participantes, ordenamiento, enlaces de invitación y paginación
Get GroupObtén información de un grupo específico con generación opcional de enlace de invitación
Set Group ImageEstablece la foto de perfil del grupo
Delete Group ImageElimina la foto de perfil del grupo
Add ParticipantsAgrega miembros a un grupo con invitación opcional
Remove ParticipantElimina un miembro de un grupo
Promote AdminPromueve a un participante a administrador
Demote AdminDegrada a un administrador a participante
Set Group ConfigConfigura los ajustes del grupo: permisos, mensajes temporales, aprobación de adición de miembros, nombre, descripción
Accept InviteAcepta una invitación de grupo mediante código de invitación
Revoke InviteRevoca y regenera el enlace de invitación del grupo
Leave GroupSalir de un grupo de WhatsApp
Get Approval RequestsLista las solicitudes de unión pendientes de un grupo
Approve Join RequestsAprueba solicitudes de unión pendientes
Reject Join RequestsRechaza solicitudes de unión pendientes
Get Group Info by Invite CodeObtén información del grupo usando el código de invitación

Operaciones de Cola

Operación Descripción
List QueuesLista todas las colas de mensajes de teléfonos
Get QueueObtén la cola de mensajes de un teléfono específico
Clear QueueBorra la cola de mensajes del teléfono

Operaciones de Llamada

Operación Descripción
Reject CallRechaza una llamada entrante (callId obtenido de la notificación webhook)
Create Call LinkCrea 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 InfoObtén información del producto
Add PhoneAgrega un nuevo teléfono al producto con número de teléfono opcional
List PhonesLista todos los teléfonos registrados
Set WebhookConfigura la URL del webhook para el producto
Set ACK PreferenceActiva o desactiva las notificaciones de confirmación a través de webhook
Get LogsObtén registros de todos los teléfonos
Get Phone LogsObtén registros de un teléfono específico

Operaciones de Sesión

Operación Descripción
Get StatusVerifica el estado de conexión de la sesión
Get ScreenObtén una captura de pantalla de la sesión actual (devuelve imagen binaria)
Get QR CodeObtén el código QR para vincular el teléfono (devuelve imagen binaria)
LogoutDesconecta la sesión de WhatsApp
Connect with Phone NumberConéctate usando número de teléfono en lugar de código QR

Operaciones de Control de Sesión

Operación Descripción
RedeployRedesplegar la instancia Docker para reiniciar la sesión
Factory ResetRestablecimiento de fábrica del teléfono al estado inicial
Get ConfigObtén la configuración específica del teléfono
Set ConfigEstablece 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
MessageNuevos 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
ACKCambios en el estado de entrega del mensaje: enviado, entregado, leído -- con ID del mensaje y marca de tiempo
GroupEventos 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
CallEventos de llamada: entrantes, salientes, perdidas, rechazadas -- con ID de la llamada, estado y detalles del llamante
StoryEventos 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/{productId}

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

Explora la 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.

Explora la WhatsApp API para tu Cliente

Desbloquea el Potencial Completo de la WhatsApp API con características ilimitadas Adaptada al Éxito de Tu Marca

Contáctanos para ser nuestro socio. Envía un correo electrónico para hablar sobre cualquier condición, acuerdo y precios.