Aller au contenu

Intégrations

Zapier

Connecter Notifuse à Zapier : envoyer vos emails transactionnels depuis n'importe quelle application, déclencher des Zaps sur les événements de contacts, de listes et de segments, ajouter ou abonner des contacts.

Zapier relie Notifuse à des milliers d’autres applications, sans code. Notifuse fournit des déclencheurs et des actions :

  • Les déclencheurs lancent un Zap quand quelque chose se passe dans Notifuse : un contact est créé ou modifié, quelqu’un s’abonne à une liste ou s’en désabonne, un contact entre dans un segment ou en sort. Notifuse envoie chaque événement à Zapier au moment où il se produit ; Zapier n’interroge pas Notifuse à intervalles réguliers.
  • Les Actions permettent à une autre application d’agir dans Notifuse. La principale est l’envoi : un Zap choisit une de vos notifications transactionnelles, et Notifuse l’envoie avec votre modèle d’email, votre expéditeur et votre fournisseur d’email. Les actions peuvent aussi créer ou mettre à jour un contact, ou abonner un contact à une liste.

Avant de commencer

Il vous faut une Clé API et l’URL de l’API de Notifuse. Connecter Zapier dans Paramètres → Intégrations vous donne les deux.

Il vous faut aussi du HTTPS : Zapier n’appelle que des adresses servies en HTTPS avec un certificat émis par une autorité de certification publique, et une instance auto-hébergée doit être joignable depuis Internet.

Étape 1 : connecter Zapier

Ouvrez Paramètres → Intégrations dans l’espace de travail où Zapier doit agir. Cliquez sur Ajouter une intégration, puis choisissez Zapier sous Applications connectées. Seul le propriétaire de l’espace de travail peut le connecter.

Le seul champ est un libellé. Il nomme la connexion dans Notifuse, et rien d’autre n’en dépend. Un espace de travail peut avoir plusieurs connexions Zapier : servez-vous du libellé pour dire à quoi sert chacune. La valeur par défaut, « Zapier », convient si vous n’en avez besoin que d’une.

Cliquez sur Connecter Zapier. Notifuse crée une clé API qui n’a que les permissions dont cette intégration a besoin : Transactionnel, Abonnements webhook, Contacts et Listes en lecture et en écriture, plus Segments en lecture. Vous n’avez rien à cocher.

Regardez Transactionnel avant de connecter. Cette permission permet à un Zap d’envoyer, mais aussi de créer, modifier et supprimer des notifications transactionnelles, de tester des modèles et des fournisseurs, et de relayer par le pont SMTP. Un jeton divulgué pourrait envoyer des emails par votre fournisseur, à vos frais et au détriment de votre réputation d’expéditeur, sans pouvoir lire votre historique des messages. Si une connexion Zapier n’a pas besoin d’envoyer, restreignez la clé (voir Gérer la connexion par la suite).

Le jeton s’affiche une seule fois, dans le panneau qui remplace le formulaire. Copiez-le avant d’appuyer sur Terminé : aucun écran de Notifuse ne peut le réafficher. Le même panneau affiche l’URL de l’API pour l’étape 2, avec un bouton de copie.

Note

Notifuse tire l’adresse de la clé de votre libellé. Il la construit sous la forme zapier-<label>-<random>, en passant le libellé en minuscules et en remplaçant par un tiret tout ce qui n’est ni une lettre, ni un chiffre, ni un tiret bas, ou sous la forme zapier-<random> si vous avez gardé la valeur par défaut. Les adresses de clés API sont uniques sur toute l’installation Notifuse, pas par espace de travail. La partie aléatoire permet à deux espaces de travail de connecter chacun un Zapier « Marketing » sans conflit, et vous n’avez jamais à chercher un nom libre. Le panneau de connexion affiche l’adresse obtenue, tout comme la carte de la connexion ensuite : c’est ainsi que vous faites correspondre une carte à sa ligne dans Paramètres → Équipe et clés API.

Note

Vous pouvez aussi créer la clé à la main dans Paramètres → Équipe et clés API → Nouvelle clé, où vous accordez vous-même les permissions (le tableau ci-dessous indique quoi cocher). Une telle clé est une clé API ordinaire, rattachée à aucune connexion : aucune carte n’apparaît dans Paramètres → Intégrations, et seule la suppression de sa ligne dans Paramètres → Équipe et clés API la révoque. Donnez à Zapier sa propre clé plutôt que d’en réutiliser une. Administrateurs et clés API décrit toutes les permissions.

Ce que la clé peut faire

Connecter Zapier accorde tout cela à votre place. Le tableau montre ce que le jeton permet à Zapier d’atteindre, et ce qu’il faut cocher si vous créez la clé à la main dans Paramètres → Équipe et clés API ou si vous en restreignez une par la suite.

Ce que vous voulez utiliserPermissions nécessaires à la clé
La connexion du compte, le choix de l’espace de travail et les libellés des champs personnalisés dans une actionAucune : toute clé peut le faire
Tout déclencheur (activer et désactiver un Zap)Abonnements webhook en lecture et en écriture
Les données d’exemple de tout déclencheur (ce que Zapier vous montre pendant que vous construisez un Zap)Contacts en lecture
Les déclencheurs de contactsContacts en lecture
Les déclencheurs de listes, et le choix de la listeListes en lecture, et Contacts en lecture
Les déclencheurs de segments, et le choix du segmentSegments en lecture, et Contacts en lecture
L’action Send Transactional Email, et le choix de la notificationTransactionnel en lecture et en écriture
L’enregistrement sur le contact des champs de contact remplis lors d’un envoiContacts en écriture. Sans elle, l’envoi fonctionne, mais seule l’adresse est enregistrée
Un CC ou un BCC lors d’un envoiContacts en lecture en plus, car l’objet est rendu avec les données du contact
L’action Create or Update ContactContacts en écriture
L’action Subscribe Contact to ListListes en lecture et en écriture

Note

La lecture remplit les listes déroulantes, l’écriture exécute l’étape. Chaque liste de choix lit les éléments proposés : avec l’écriture seule, une action ne peut pas être configurée. Avec Listes en écriture mais sans Listes en lecture, l’étape Subscribe Contact to List ne peut pas être enregistrée : son choix de liste renvoie une erreur de permission, et la liste est un champ obligatoire.

Tous les déclencheurs ont besoin de Contacts en lecture, pas seulement ceux des contacts : les exemples que Zapier affiche pendant la construction d’un Zap viennent de vos contacts, quel que soit le déclencheur choisi. Une clé qui n’a pas cette permission remplit ses listes déroulantes mais échoue sur Test trigger.

Attention

Transactionnel, Abonnements webhook et Listes en écriture vont plus loin que leur nom ne le laisse croire. Transactionnel en écriture envoie des emails par votre fournisseur, et permet aussi de modifier et de supprimer vos notifications transactionnelles, de tester des fournisseurs et d’utiliser le pont SMTP. Un déclencheur s’abonne à des événements et fait livrer leur contenu à Zapier. Abonner une adresse à une liste crée ou écrase la fiche de ce contact, et un envoi à cette adresse aussi. Protégez cette clé comme votre base de contacts et vos identifiants d’envoi.

Étape 2 : votre URL de l’API

Le formulaire de connexion de Zapier a un champ API URL. Le panneau Connecter Zapier affiche sa valeur, avant la connexion puis à côté du jeton.

  • Notifuse Cloud : le champ arrive prérempli avec l’API Cloud, https://v3.notifuse.com. Laissez-le tel quel.
  • Auto-hébergé : collez l’adresse qu’affiche le panneau. C’est l’adresse à laquelle vous ouvrez la console Notifuse, schéma et domaine seulement, sans rien après le domaine et sans barre oblique finale. Ne videz pas le champ : une URL de l’API vide désigne Notifuse Cloud, pas « cette instance ».

Votre instance doit être joignable depuis Internet, en HTTPS, avec un certificat émis par une autorité de certification publique. Let’s Encrypt convient.

Attention

Le http:// simple, les certificats autosignés et les autorités de certification internes ne sont pas pris en charge, pas plus qu’une instance joignable uniquement depuis votre réseau. Zapier exige du HTTPS avec un certificat reconnu publiquement. Si votre instance est derrière un pare-feu, sachez que Zapier ne publie une liste fixe d’adresses IP sortantes à autoriser que sur ses offres payantes.

Étape 3 : connecter votre espace de travail

Dans Zapier, créez un Zap, cherchez Notifuse et choisissez un déclencheur ou une action. Quand Zapier vous demande de connecter un compte, collez la clé API et, si vous êtes auto-hébergé, votre URL de l’API.

Chaque déclencheur et chaque action Notifuse demande ensuite quel espace de travail utiliser, dans une liste déroulante.

Note

Une connexion Zapier couvre un seul espace de travail. Une clé API Notifuse appartient à un seul espace de travail : la liste déroulante ne propose donc que celui-là et le sélectionne pour vous. Avec plusieurs espaces de travail, connectez Zapier depuis Paramètres → Intégrations dans chacun et ajoutez une connexion Zapier distincte pour chacun. Zapier nomme les connexions avec le nom de l’espace de travail et l’hôte, ce qui permet de les distinguer facilement.

Gérer la connexion par la suite

La connexion apparaît sous forme de carte dans Paramètres → Intégrations, avec votre libellé, l’adresse de la clé créée et la date de connexion. Vous pouvez la renommer ou la supprimer, avec des effets très différents :

  • La renommer ne change que le libellé de la carte. La clé garde l’adresse sous laquelle elle a été créée : le nom et l’adresse peuvent donc différer ensuite, et c’est pourquoi la carte affiche les deux. Vous n’avez rien à ressaisir dans Zapier.
  • La supprimer révoque la clé. Tous les Zaps qui utilisent cette clé cessent de fonctionner dès que vous confirmez. Une clé révoquée ne peut pas être restaurée, et une nouvelle connexion crée une nouvelle clé qu’il faut coller dans Zapier. Supprimer l’espace de travail révoque ses clés Zapier de la même façon.

Les permissions d’une clé se modifient dans Paramètres → Équipe et clés API. Élargissez ou restreignez la clé Zapier à cet endroit : le changement s’applique dès sa requête suivante et le jeton ne change pas, donc vous n’avez rien à ressaisir dans Zapier. Supprimer la ligne de la clé à cet endroit la révoque aussi, comme la suppression de la carte, mais la carte pointe alors vers une clé qui n’existe plus.

Déclencheurs

DéclencheurSe lance quand
New ContactUn contact est ajouté à l’espace de travail
Updated ContactLes données d’un contact existant changent
New List SubscriberUn contact devient abonné actif d’une liste
Contact Unsubscribed from ListUn contact se désabonne d’une liste
Contact Joined SegmentUn contact commence à correspondre à un segment
Contact Left SegmentUn contact cesse de correspondre à un segment

Les déclencheurs de listes et de segments permettent de choisir une liste ou un segment précis. Choisissez-en un : Notifuse n’envoie alors à Zapier que les événements de cette liste ou de ce segment, au lieu de ceux de toutes les listes de l’espace de travail, ce qui réduit la consommation de tâches de votre Zap et la charge de votre instance.

New List Subscriber couvre trois façons d’arriver

Un contact peut devenir abonné actif d’une liste de trois façons, et seule la première est un nouvel abonnement :

  • Il s’abonne pour la première fois.
  • Il confirme un abonnement en double opt-in qui attendait sa confirmation.
  • Il se réabonne après s’être désabonné, après un rebond ou après un signalement de spam.

New List Subscriber se lance dans les trois cas. Un contact qui revient ne produit jamais d’événement de premier abonnement : un Zap qui n’écouterait que cet événement manquerait tous les abonnés qui reviennent, sans la moindre erreur. Chaque exécution porte l’événement précis, ce qui vous permet de créer une branche dans Zapier pour traiter différemment les nouveaux abonnés et ceux qui reviennent.

Updated Contact ignore les enregistrements sans changement

Updated Contact ne se lance que quand les données d’un contact changent. Enregistrer un contact sans modification, ou une tâche de fond qui touche une fiche, ne produit aucun événement : les mises à jour internes de routine ne lancent pas vos Zaps.

Zapier gère ses propres abonnements webhook

Activer un Zap Notifuse crée un abonnement dans Paramètres → Webhooks, marqué comme créé par Zapier. Désactiver le Zap le supprime.

Attention

Ne supprimez pas à la main un abonnement webhook créé par Zapier. Le Zap qui en dépend ne reçoit plus d’événements et ne recrée pas l’abonnement de lui-même : il faut désactiver puis réactiver le Zap dans Zapier, ce qui fonctionne même si l’abonnement a disparu. Supprimez plutôt le Zap et laissez-le faire le ménage.

Une livraison qui échoue est retentée : un Zap peut donc parfois s’exécuter deux fois pour le même événement. Si votre Zap fait quelque chose qui ne doit pas arriver deux fois, comme débiter une carte ou envoyer un message, ajoutez un filtre Zapier ou une étape de déduplication.

Actions

ActionCe qu’elle fait
Send Transactional EmailEnvoie une de vos notifications transactionnelles à un contact, en remplissant les variables de son modèle depuis le Zap
Create or Update ContactCrée le contact si l’adresse email est nouvelle, le met à jour sinon
Subscribe Contact to ListCrée ou met à jour le contact et l’abonne aux listes choisies, en une seule étape

Les trois actions identifient le contact par son adresse email : les relancer avec la même adresse met à jour le même contact au lieu de créer un doublon.

Les champs de contact personnalisés apparaissent dans ces actions sous les libellés que vous leur avez donnés. Nommez-les d’abord dans Paramètres → Champs personnalisés : les champs sans libellé sont masqués, donc un champ absent dans Zapier n’a généralement pas encore de libellé.

Envoyer, c’est choisir une notification, pas rédiger un email

Send Transactional Email ne transporte pas l’email lui-même. Le modèle, l’expéditeur, le suivi et la gestion du désabonnement restent dans Notifuse. Le Zap choisit la notification à envoyer, son destinataire et les valeurs avec lesquelles son modèle est rendu.

Dans l’étape, choisissez une Notification dans la liste déroulante, associez un Email pour le destinataire et remplissez Template Data avec une ligne par {{ variable }} qu’utilise votre modèle. Une variable que vous ne fournissez pas est rendue vide, sans erreur : si un email arrive avec un trou, vérifiez d’abord l’orthographe de cette ligne par rapport au modèle.

Deux précisions sur Template Data :

  • Les valeurs arrivent sous forme de texte. Afficher une valeur fonctionne. Une comparaison comme {% if total > 100 %} ne correspondra pas, car elle compare avec le texte "120", pas avec le nombre.
  • contact et notification_center_url sont définis par Notifuse et ne peuvent pas être remplacés depuis le Zap. Les lignes qui portent ces noms sont ignorées.

Les notifications sans canal email ne sont pas proposées dans la liste déroulante, puisque leur envoi ne pourrait qu’échouer.

Envoyer écrit aussi le contact

Un envoi crée le contact si l’adresse est nouvelle : vous pouvez écrire à quelqu’un dès sa première commande, sans étape séparée.

Tout champ de contact que vous remplissez écrase la valeur enregistrée. Si vous associez First Name à une source parfois vide, ces exécutions effacent le prénom enregistré. Un champ laissé vide dans le Zap ne touche pas à la valeur enregistrée ; un champ associé l’emporte. Pour seulement envoyer, ne remplissez que l’adresse email.

Utilisez Message External ID pour tout ce qui ne doit pas partir deux fois

Zapier retente une étape qui a échoué, et une nouvelle tentative exécute à nouveau toute l’action. Une notification d’expédition en double est une petite gêne ; une réinitialisation de mot de passe ou une confirmation de commande en double est un vrai problème.

Remplissez Message External ID avec une valeur stable venant du déclencheur, comme un numéro de commande, un identifiant de facture ou l’identifiant de la fiche source. Un envoi avec une valeur que Notifuse a déjà vue renvoie le message d’origine au lieu d’envoyer un second email. Si le champ est vide, chaque exécution envoie.

L’étape ne peut pas vous dire lequel des deux cas s’est produit : un envoi dédupliqué et un nouvel envoi sont identiques dans Zap History, tous deux réussis avec le même identifiant de message.

Attention

Tester l’étape envoie un vrai email. Le bouton Test action de Zapier envoie pour de vrai, comme toute exécution réelle, et non à blanc. Utilisez une adresse qui vous appartient pendant que vous construisez le Zap.

Le statut d’abonnement n’est pas toujours actif

Subscribe Contact to List renvoie le statut obtenu pour chaque liste. Ce statut n’est pas toujours active, ce qui peut ressembler à un bug :

  • Un contact qui s’était désabonné revient en pending, pas en active, et reçoit l’email de confirmation de la liste. Notifuse impose le double opt-in à toute personne qui s’est déjà désinscrite, quels que soient les réglages de la liste. Cette règle de conformité ne peut pas être désactivée. Le Zap n’a pas échoué : le contact doit confirmer avant de recevoir quoi que ce soit. Une liste sans modèle de double opt-in n’a pas d’email de confirmation à envoyer, et ces contacts restent alors pending indéfiniment. Configurez-en un avant de diriger un Zap de réengagement vers une liste.
  • Un tout nouveau contact arrive en active, même sur une liste en double opt-in, et ne reçoit aucun email de confirmation, car la demande vient d’une clé API authentifiée et non d’un formulaire d’abonnement public.

Attention

Avant de diriger un Zap de collecte de prospects vers une liste en double opt-in, sachez que les nouvelles adresses sautent l’étape de confirmation. N’ajoutez des personnes à une liste par Zapier qu’avec leur consentement, comme pour l’import d’un fichier.

Dans trois autres cas, l’action indique un succès sans ajouter de nouvel abonné. Ces cas ne se présentent pas tous de la même façon dans le résultat, ce qui compte si vous filtrez sur ce résultat :

  • Une adresse qui a rebondi ou signalé un spam n’est pas réabonnée. Elle revient avec son statut définitif, bounced ou complained, qu’une étape Filter basée sur Status voit.
  • Un contact déjà actif sur la liste n’est pas modifié. Relancer le Zap ne change rien, et l’abonnement revient en active.
  • Une adresse d’un domaine d’email jetable est écartée sans rien signaler. C’est le seul cas où il n’y a rien à signaler : l’étape réussit avec aucun abonnement et un Status vide. Ni l’abonnement ni le contact ne sont enregistrés.

Note

Filtrez sur la valeur du statut, pas sur sa présence. Continue if Status exists laisse passer une adresse rejetée comme une adresse active, puisque les deux ont un statut, et n’arrête que le cas du domaine jetable. Pour vérifier que « le contact est maintenant abonné », testez que Status vaut active, ou que Memberships n’est pas vide si vous abonnez à plusieurs listes à la fois.

Dépannage

Le test de connexion échoue

  • Vérifiez l’URL de l’API : elle doit commencer par https:// et n’avoir aucun chemin après le domaine. Le panneau de connexion affichait la valeur exacte, et rouvrir la carte ne montre que le libellé. Si vous ne l’avez plus, utilisez le schéma et le domaine de l’adresse à laquelle vous ouvrez la console Notifuse.
  • Ouvrez https://your-domain/api/workspaces.list dans un navigateur. Une erreur d’authentification est la réponse attendue et prouve que l’adresse est joignable ; un délai dépassé, une erreur de connexion ou un avertissement de certificat signifie que Zapier ne peut pas la joindre non plus.
  • Vérifiez que le certificat est émis par une autorité de certification publique, et qu’il n’est ni autosigné ni interne.
  • Si la clé a été révoquée dans Notifuse (en supprimant la connexion Zapier, ou en supprimant sa ligne dans Paramètres → Équipe et clés API), la connexion cesse aussitôt de fonctionner. Zapier signale un échec d’authentification et propose de reconnecter le compte : connectez à nouveau Zapier et collez le nouveau jeton.

Une étape échoue avec une erreur de permission

Le message nomme la permission manquante. Ajoutez-la à la clé depuis Paramètres → Équipe et clés API ; le changement prend effet à la requête suivante et le jeton reste le même. Ne reconnectez pas Zapier pour corriger cela : une nouvelle connexion crée une clé avec les mêmes permissions standard, et l’étape échoue au même endroit.

Si Send Transactional Email échoue sur Transactionnel, ou si son choix de notification est vide et signale une erreur de permission, la connexion date d’avant Notifuse 39.1, la version qui a ajouté l’envoi aux permissions standard. Cochez Transactionnel en lecture et en écriture sur la clé dans Paramètres → Équipe et clés API, et l’étape fonctionne à sa prochaine exécution, sans reconnexion ni changement de jeton.

Un Zap ne reçoit plus d’événements

Ouvrez Paramètres → Webhooks dans Notifuse et regardez l’abonnement de ce Zap :

  • Désactivé, avec une raison indiquée. Notifuse désactive automatiquement un abonnement après une longue série de livraisons échouées et en enregistre la raison. Réactivez-le une fois la cause corrigée, ou désactivez puis réactivez simplement le Zap dans Zapier pour le recréer.
  • Absent. Quelqu’un l’a supprimé à la main, ou le Zap a été désactivé. Désactivez puis réactivez le Zap.

Le journal de livraison de chaque abonnement montre chaque événement envoyé, la réponse de Zapier et le contenu envoyé. C’est le moyen le plus rapide de savoir si Notifuse a envoyé un événement.

Le test du déclencheur ne trouve aucune donnée

Zapier cherche une activité récente correspondante pour construire son exemple. Si une liste n’a pas eu d’abonné récemment, ou un segment de nouveau membre, il n’y a rien à montrer. Créez un contact de test, abonnez-le à la liste et relancez le test.

Limites

  • Une connexion couvre un seul espace de travail. Plusieurs espaces de travail demandent plusieurs connexions.
  • La suppression d’un contact ne déclenche pas de Zap, pas plus que les événements de newsletters ou d’automations.
  • Il n’y a pas encore d’étape de recherche : vous ne pouvez pas retrouver un contact au milieu d’un Zap sans une action qui écrit.
  • Les champs personnalisés doivent avoir un libellé pour apparaître dans une action.
  • Un envoi ne peut pas porter de pièces jointes. L’API les accepte, mais Zapier transmet à une étape une référence au fichier et non le fichier lui-même : il n’y a donc rien à joindre.
  • Un envoi ne peut pas rédiger un email. Il envoie une notification configurée dans Notifuse et ne peut pas fournir son propre contenu. Vous pouvez remplacer l’objet, le texte d’aperçu, le nom de l’expéditeur et l’adresse de réponse pour un message.