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
n8n ha verificato i nodi MailInApp. Su n8n Cloud, un proprietario o amministratore dell'istanza apre il pannello dei nodi sulla tela, cerca MailInApp, lo sceglie sotto More from the community e seleziona Install. Da quel momento tutti sull'istanza possono usarlo.
Su un n8n self-hosted, vai in Settings → Community Nodes → Install e inserisci n8n-nodes-mailinapp. Per i dettagli vedi la guida ai nodi della community di n8n.
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 quindici 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, Journey Completed, Experiment Decided, Experiment Results Ready e Response 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. Get Many trattative, prima le spostate più di recente, filtrate per email del contatto, stato o pipeline: trova la trattativa di un contatto e poi aggiornala. |
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.
