Menu de la documentation

Zapier

Connectez MailInApp aux milliers d'applications de Zapier : placez les nouveaux leads dans un tableur, publiez les rendez-vous réservés dans Slack, ouvrez une fiche CRM quand une affaire est gagnée, ou ajoutez un contact à MailInApp quand quelque chose se passe ailleurs.

Vidéo en anglais

L'application Zapier MailInApp

MailInApp figure dans le répertoire d'applications de Zapier : zapier.com/apps/mailinapp/integrations. Vous la connectez avec une clé API et choisissez déclencheurs et actions dans des menus, sans URL à copier :

  • Déclencheurs : un pour chaque événement de compte, dont New Lead, Lead Turned Hot, Meeting Booked, Deal Stage Changed, Form Submitted, Purchase Completed, Journey Completed et Response Completed.
  • Actions : Create or Update Contact, Trigger Journey, Create Deal, Update or Move Deal et Send Transactional Email.
  • Recherche : Find Contact, qui s'associe à la création sous la forme « Find or Create Contact ».

Connecter MailInApp à Zapier

  1. Dans MailInApp, allez dans Développeurs et cliquez sur Créer une clé. Donnez-lui le nom de l'intégration, par exemple « Zapier ». Copiez la clé, qui commence par mia_live_. Elle n'est affichée qu'une seule fois. Si Créer une clé est verrouillé, votre forfait n'inclut pas encore de clés API. Le fonctionnement des clés est décrit dans Clés API.
  2. Dans Zapier, créez un Zap et choisissez MailInApp comme application du déclencheur ou de l'action.
  3. Quand Zapier vous demande de connecter un compte, collez la clé dans le champ API Key.
  4. Choisissez un déclencheur ou une action. Les menus, comme les listes, parcours, affaires et pipelines, se remplissent avec les données de votre compte.
  5. Utilisez Test trigger ou Test action, puis activez le Zap.

La clé agit comme l'ensemble de votre compte MailInApp : traitez-la comme un mot de passe. Si vous la révoquez dans Développeurs, Zapier est déconnecté et les déclencheurs qu'elle avait configurés s'arrêtent.

Démarrer un Zap depuis MailInApp

Vous pouvez aussi commencer sans quitter MailInApp. Dans Développeurs, sous vos clés API, la carte Zapier propose :

  • des modèles prêts à l'emploi pour MailInApp, par exemple ajouter les nouveaux leads dans Google Sheets ou publier les rendez-vous réservés dans Slack ;
  • un champ où vous décrivez avec vos mots ce que vous voulez automatiser, et Zapier vous suggère un Zap ;
  • un moyen de créer un Zap de zéro ;
  • une fois connecté à Zapier, vos Zaps qui utilisent MailInApp.

La carte Zapier de la page Développeurs, avec les modèles de Zaps MailInApp

Choisissez un modèle et Zapier s'ouvre par-dessus la page. Connectez-vous à Zapier, ou créez un compte Zapier, et l'éditeur de Zap s'ouvre avec le modèle déjà rempli. Quand il vous demande de connecter MailInApp, collez une clé API comme à l'étape 3 ci-dessus, puis testez le Zap et activez-le.

Tout ce qui s'affiche dans la carte vient de Zapier : les modèles, la connexion et l'éditeur utilisent les textes de Zapier. MailInApp ne transmet ni votre adresse e-mail ni aucune autre donnée à Zapier. C'est vous qui vous connectez à Zapier.

Si votre forfait n'inclut pas de clés API, la carte vous le signale. Vous pouvez quand même parcourir les modèles, mais un Zap ne pourra pas se connecter tant que vous n'aurez pas changé de forfait. Si la carte indique que les modèles Zapier n'ont pas pu se charger, une extension du navigateur les bloque peut-être. Utilisez alors le lien de la carte pour ouvrir MailInApp sur Zapier.

Sans l'application MailInApp (avancé)

Vous n'avez pas besoin de l'application pour utiliser Zapier avec MailInApp. L'application intégrée Webhooks by Zapier fonctionne avec les mêmes événements. C'est le bon choix si vous ne voulez que les interactions d'un seul e-mail, comme chaque réponse à une enquête précise, ou si vous préférez gérer vous-même les URL.

Envoyer les événements MailInApp vers un Zap

  1. Dans Zapier, créez un Zap avec Webhooks by Zapier comme déclencheur et Catch Hook comme événement. Copiez l'URL que Zapier vous donne.
  2. Dans MailInApp, allez dans Développeurs → Webhooks. Collez l'URL comme URL de l'endpoint, cochez les événements que ce Zap doit recevoir et cliquez sur Ajouter un webhook. Conservez le secret de signature si vous comptez vérifier les signatures plus tard.
  3. Cliquez sur Envoyer un test sur le nouveau webhook, puis sur Test trigger dans Zapier. Vous voyez l'événement d'exemple, avec son type et chaque champ de data, comme l'e-mail du contact ou l'étape de l'affaire.
  4. Ajoutez vos étapes d'action en associant les champs utiles, puis activez le Zap.

Chaque événement a la même forme : un id, un type, une date createdAt et un objet data. La page des webhooks liste chaque événement et ses champs. Si un même Catch Hook reçoit plusieurs types d'événements, ajoutez une étape Filter by Zapier sur type, ou créez un webhook par Zap.

Vous ne voulez que les interactions d'un seul e-mail ? Collez plutôt l'URL du Catch Hook dans le webhook de projet de cet e-mail, dans Insights › Paramètres.

Agir sur MailInApp depuis un Zap

Utilisez une action Webhooks by Zapier → Custom Request pour appeler l'API MailInApp avec votre clé API dans un en-tête Authorization: Bearer mia_live_…. Par exemple :

  • Ajouter ou mettre à jour un contact quand un formulaire est rempli ailleurs : POST /api/v1/contacts.
  • Ouvrir une affaire quand un lead réserve un appel dans un autre outil : POST /api/v1/deals. Ajoutez un en-tête Idempotency-Key, comme l'identifiant de la fiche dans l'autre outil, pour qu'une nouvelle tentative du Zap ne crée pas de deuxième affaire.
  • Inscrire un contact dans un parcours dont le déclencheur est Appel d'API : POST /api/v1/journeys/{id}/trigger.
  • Envoyer un reçu ou une notification : POST /api/v1/send avec "type": "transactional". N'envoyez pas d'e-mails marketing depuis un Zap : un Zap ne peut pas prouver que le destinataire a donné son accord.

Quand une livraison échoue

Un Zap en pause ou supprimé, ou une panne de Zapier, compte comme une livraison échouée. MailInApp la retente automatiquement pendant plusieurs heures. L'événement lui-même est toujours enregistré dans MailInApp d'abord : rien n'est perdu côté MailInApp.

Obtenir de l'aide

  • Un Zap ne fonctionne pas, par exemple une étape en erreur ou un déclencheur qui ne se lance pas dans Zapier : demandez de l'aide à Zapier sur zapier.com/app/get-help. Zapier voit l'historique des tâches du Zap, pas nous.
  • Quelque chose ne va pas dans MailInApp lui-même, par exemple une clé impossible à créer, un webhook avec des livraisons échouées ou un événement qui n'arrive jamais : contactez le support MailInApp.