Documentation menu

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.

L'application Zapier MailInApp

L'application officielle MailInApp pour Zapier est en cours d'examen chez Zapier et n'apparaît pas encore dans son répertoire d'applications. Une fois publiée, vous la connecterez avec une clé API et choisirez 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 et Journey 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 ».

Cette page renverra vers la fiche de l'application dès sa publication. En attendant, tout ce qui suit fonctionne dès aujourd'hui avec l'application intégrée Webhooks by Zapier.

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, comme chaque réponse à une enquête précise ? Collez plutôt l'URL du Catch Hook dans le webhook de projet de cet e-mail, sur sa page Réponses.

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.