n8n
I nodi MailInApp per n8n avviano workflow quando succede qualcosa in MailInApp e permettono ai workflow di aggiungere contatti, spostare trattative, iscrivere contatti ai journey e inviare email transazionali. Sono pubblicati su npm come n8n-nodes-mailinapp.
Installazione
In n8n, vai in Settings → Community Nodes → Install e inserisci n8n-nodes-mailinapp. I dettagli sono nella guida ai nodi della community di n8n.
Puoi installarlo subito su un n8n self-hosted. n8n Cloud offre solo i nodi della community verificati da n8n, e questo pacchetto non lo è ancora. Rispetta le regole di verifica di n8n, quindi arriverà su Cloud appena n8n lo approverà.
Collegare il tuo account
- In MailInApp, vai in Sviluppatori e crea una chiave API. Inizia con
mia_live_e viene mostrata una sola volta. - In n8n, crea una credenziale MailInApp API e incolla la chiave. Lascia Base URL su
https://mailinapp.com.
La chiave agisce per conto di tutto il tuo account MailInApp, quindi trattala come una password. Revocarla in MailInApp disattiva anche tutti gli attivatori che ha configurato.
Il nodo MailInApp Trigger
Scegli uno o più eventi. Quando attivi il workflow, il nodo vi si iscrive in MailInApp. Quando lo disattivi, l'iscrizione viene rimossa. Vedi queste iscrizioni in Sviluppatori → Webhook, contrassegnate come n8n.
Gli eventi sono i dodici eventi dell'account: Interaction Received, Form Submitted, Contact Created, Contact Updated, Lead Turned Hot, New Lead, Meeting Booked, Meeting Cancelled, Deal Created, Deal Stage Changed, Purchase Completed e Journey Completed.
Ogni esecuzione riceve l'evento così come l'ha inviato MailInApp, con id, type, createdAt e data. L'id è lo stesso a ogni consegna dello stesso evento, quindi puoi usarlo per scartare i duplicati. Ogni consegna è firmata. Il nodo rifiuta qualsiasi richiesta senza firma valida o con un timestamp più vecchio di 5 minuti: conoscere l'URL del webhook non basta per avviare il tuo workflow.
Il nodo MailInApp
| Risorsa | Operazioni |
|---|---|
| Contact | Create or Update un indirizzo in una lista di contatti. MailInApp lo verifica al salvataggio. Get restituisce il contatto dell'indirizzo in ogni lista, o in una. |
| Contacts List | Get Many liste con i loro campi e il numero di contatti. |
| Deal | Create una trattativa per un contatto, tramite email. Imposta una Idempotency Key (per esempio un numero d'ordine) così un'esecuzione ripetuta non crea una seconda trattativa. Update una trattativa: spostarla in un'altra fase, comprese vinta e persa, o cambiarne titolo, valore o valuta. |
Send Transactional: il tuo oggetto e HTML o testo, oppure un progetto dello studio con dati di unione. Un invio non riuscito è un errore. Un risultato suppressed (l'indirizzo è andato in bounce o non è valido) è un risultato normale su cui puoi diramare. | |
| Journey | Enroll Contact in un journey il cui attivatore è Chiamata API, e Get Many journey. |
| Pipeline | Get Many pipeline con le loro fasi. |
I menu a tendina mostrano le tue liste, i campi delle liste, i journey, le pipeline e le fasi. Il nodo supporta Continue On Fail di n8n.
Le email di marketing non sono previste: un workflow non può dimostrare che il destinatario ha dato il consenso. Invia il marketing da MailInApp, oppure iscrivi il contatto a un journey.
Con un agente IA
Il nodo MailInApp può essere usato come strumento dall'AI Agent di n8n. Per avere più strumenti, collega l'agente anche al server MCP di MailInApp con un nodo MCP Client Tool: endpoint https://mailinapp.com/api/mcp, con la tua chiave API come credenziale Bearer.
Il pacchetto include un workflow di esempio pronto all'uso (examples/ai-agent-mcp.workflow.json nel pacchetto). Il suo agente può leggere contatti, risultati, risposte ai moduli, segmenti e journey, e abbozzare nuovi journey, ma non ha alcuno strumento che invii email. I journey costruiti da un agente vengono sempre salvati spenti, così una persona li rivede e li attiva.
Senza i nodi
Qualsiasi workflow n8n può usare MailInApp anche tramite l'attivatore generico Webhook, alimentato da un webhook che aggiungi in Sviluppatori → Webhook, e il nodo HTTP Request che chiama l'API.