n8n
Les nœuds MailInApp pour n8n lancent des workflows quand quelque chose se passe dans MailInApp, et permettent aux workflows d'ajouter des contacts, de déplacer des affaires, d'inscrire des contacts dans des parcours et d'envoyer des e-mails transactionnels. Ils sont publiés sur npm sous le nom n8n-nodes-mailinapp.
Installation
n8n a vérifié les nœuds MailInApp. Sur n8n Cloud, un propriétaire ou administrateur de l'instance ouvre le panneau des nœuds sur le canevas, cherche MailInApp, le choisit sous More from the community et sélectionne Install. Tout le monde sur l'instance peut ensuite l'utiliser.
Sur un n8n auto-hébergé, allez dans Settings → Community Nodes → Install et saisissez n8n-nodes-mailinapp. Voir le guide des nœuds communautaires de n8n pour les détails.
Connecter votre compte
- Dans MailInApp, allez dans Développeurs et créez une clé API. Elle commence par
mia_live_et n'est affichée qu'une fois. - Dans n8n, créez un identifiant MailInApp API et collez la clé. Laissez Base URL sur
https://mailinapp.com.
La clé agit au nom de tout votre compte MailInApp : traitez-la comme un mot de passe. La révoquer dans MailInApp désactive aussi tous les déclencheurs qu'elle a configurés.
Le nœud MailInApp Trigger
Choisissez un ou plusieurs événements. Quand vous activez le workflow, le nœud s'y abonne dans MailInApp. Quand vous le désactivez, l'abonnement est supprimé. Vous voyez ces abonnements dans Développeurs → Webhooks, marqués n8n.
Les événements sont les quinze événements de compte : 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 et Response Completed.
Chaque exécution reçoit l'événement tel que MailInApp l'a envoyé, avec id, type, createdAt et data. L'id est identique pour chaque livraison d'un même événement : utilisez-le pour écarter les doublons. Chaque livraison est signée. Le nœud refuse toute requête sans signature valide ou dont l'horodatage a plus de 5 minutes : connaître l'URL du webhook ne suffit pas à lancer votre workflow.
Le nœud MailInApp
| Ressource | Opérations |
|---|---|
| Contact | Create or Update une adresse dans une liste de contacts. MailInApp la vérifie à l'enregistrement. Get le contact de cette adresse dans chaque liste, ou dans une seule. |
| Contacts List | Get Many listes avec leurs champs et leur nombre de contacts. |
| Deal | Create une affaire pour un contact, par e-mail. Renseignez une Idempotency Key (un numéro de commande, par exemple) pour qu'une exécution relancée ne crée pas de deuxième affaire. Update une affaire : la déplacer vers une autre étape, gagnée et perdue comprises, ou changer son titre, sa valeur ou sa devise. Get Many affaires, les plus récemment déplacées d'abord, filtrées par e-mail du contact, statut ou pipeline : retrouvez l'affaire d'un contact, puis mettez-la à jour. |
Send Transactional : votre propre objet et HTML ou texte, ou un projet du studio avec des données de fusion. Un envoi qui échoue est une erreur. Un résultat suppressed (adresse en rebond ou invalide) est un résultat normal sur lequel vous pouvez faire bifurquer le workflow. | |
| Journey | Enroll Contact dans un parcours dont le déclencheur est Appel d'API, et Get Many parcours. |
| Pipeline | Get Many pipelines avec leurs étapes. |
Les listes déroulantes proposent vos listes, champs de liste, parcours, pipelines et étapes. Le nœud prend en charge l'option Continue On Fail de n8n.
L'e-mail marketing n'est pas proposé : un workflow ne peut pas prouver que le destinataire a donné son accord. Envoyez vos e-mails marketing depuis MailInApp, ou inscrivez le contact dans un parcours.
Avec un agent IA
Le nœud MailInApp peut servir d'outil à l'AI Agent de n8n. Pour un éventail d'outils plus large, connectez aussi l'agent au serveur MCP de MailInApp avec un nœud MCP Client Tool : endpoint https://mailinapp.com/api/mcp, avec votre clé API comme identifiant Bearer.
Le paquet contient un workflow d'exemple prêt à l'emploi (examples/ai-agent-mcp.workflow.json dans le paquet). Son agent peut lire les contacts, les résultats, les réponses aux formulaires, les segments et les parcours, et rédiger de nouveaux parcours, mais il n'a aucun outil qui envoie des e-mails. Les parcours construits par un agent sont toujours enregistrés désactivés : une personne les relit et les active.
Sans les nœuds
N'importe quel workflow n8n peut aussi utiliser MailInApp via le déclencheur générique Webhook, alimenté par un webhook ajouté dans Développeurs → Webhooks, et le nœud HTTP Request qui appelle l'API.
