n8n
Los nodos de MailInApp para n8n inician flujos cuando pasa algo en MailInApp y permiten que los flujos añadan contactos, muevan oportunidades, inscriban contactos en recorridos y envíen correo transaccional. Están publicados en npm como n8n-nodes-mailinapp.
Instalar
En n8n, ve a Settings → Community Nodes → Install y escribe n8n-nodes-mailinapp. Los detalles están en la guía de nodos de la comunidad de n8n.
Puedes instalarlo ya en un n8n autoalojado. n8n Cloud solo ofrece nodos de la comunidad verificados por n8n, y este paquete aún no lo está. Cumple las reglas de verificación de n8n, así que llegará a Cloud en cuanto n8n lo apruebe.
Conectar tu cuenta
- En MailInApp, ve a Desarrolladores y crea una clave de API. Empieza por
mia_live_y solo se muestra una vez. - En n8n, crea una credencial MailInApp API y pega la clave. Deja Base URL en
https://mailinapp.com.
La clave actúa en nombre de toda tu cuenta de MailInApp, así que trátala como una contraseña. Si la revocas en MailInApp, también se desactivan todos los disparadores que configuró.
El nodo MailInApp Trigger
Elige uno o varios eventos. Al activar el flujo, el nodo se suscribe a ellos en MailInApp. Al desactivarlo, la suscripción se elimina. Puedes ver estas suscripciones en Desarrolladores → Webhooks, marcadas como n8n.
Los eventos son los doce eventos de cuenta: Interaction Received, Form Submitted, Contact Created, Contact Updated, Lead Turned Hot, New Lead, Meeting Booked, Meeting Cancelled, Deal Created, Deal Stage Changed, Purchase Completed y Journey Completed.
Cada ejecución recibe el evento tal como lo envió MailInApp, con id, type, createdAt y data. El id es el mismo en cada entrega de un mismo evento, así que puedes usarlo para descartar duplicados. Cada entrega va firmada. El nodo rechaza cualquier solicitud sin una firma válida o con una marca de tiempo de hace más de 5 minutos: conocer la URL del webhook no basta para iniciar tu flujo.
El nodo MailInApp
| Recurso | Operaciones |
|---|---|
| Contact | Create or Update una dirección en una lista de contactos. MailInApp la verifica al guardarla. Get devuelve el contacto de la dirección en cada lista, o en una. |
| Contacts List | Get Many listas con sus campos y número de contactos. |
| Deal | Create una oportunidad para un contacto, por correo. Pon una Idempotency Key (un número de pedido, por ejemplo) para que una ejecución reintentada no cree una segunda oportunidad. Update una oportunidad: moverla a otra etapa, incluidas ganada y perdida, o cambiar su título, valor o moneda. |
Send Transactional: tu propio asunto y HTML o texto, o un proyecto del estudio con datos de combinación. Un envío que falla es un error. Un resultado suppressed (la dirección rebotó o no es válida) es un resultado normal sobre el que puedes ramificar. | |
| Journey | Enroll Contact en un recorrido cuyo disparador es Llamada a la API, y Get Many recorridos. |
| Pipeline | Get Many pipelines con sus etapas. |
Los desplegables te muestran tus listas, campos de lista, recorridos, pipelines y etapas. El nodo admite Continue On Fail de n8n.
No se ofrece correo de marketing: un flujo no puede demostrar que el destinatario lo aceptó. Envía el marketing desde MailInApp o inscribe al contacto en un recorrido.
Con un agente de IA
El nodo MailInApp puede usarse como herramienta del AI Agent de n8n. Para tener más herramientas, conecta también el agente al servidor MCP de MailInApp con un nodo MCP Client Tool: endpoint https://mailinapp.com/api/mcp, con tu clave de API como credencial Bearer.
El paquete incluye un flujo de ejemplo listo para usar (examples/ai-agent-mcp.workflow.json dentro del paquete). Su agente puede leer contactos, resultados, respuestas de formularios, segmentos y recorridos, y redactar recorridos nuevos, pero no tiene ninguna herramienta que envíe correo. Los recorridos que construye un agente siempre se guardan desactivados, para que una persona los revise y los active.
Sin los nodos
Cualquier flujo de n8n también puede usar MailInApp con el disparador genérico Webhook, alimentado por un webhook que añades en Desarrolladores → Webhooks, y con el nodo HTTP Request llamando a la API.