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
Dans n8n, allez dans Settings → Community Nodes → Install et saisissez n8n-nodes-mailinapp. Voir le guide des nœuds communautaires de n8n pour les détails.
Vous pouvez l'installer dès maintenant sur une instance n8n auto-hébergée. n8n Cloud ne propose que les nœuds communautaires vérifiés par n8n, et ce paquet ne l'est pas encore. Il respecte les règles de vérification de n8n : la prise en charge sur Cloud suivra dès que n8n l'aura approuvé.
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 douze é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 et Journey 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. |
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.