Aller au contenu principal

Configuration des webhooks

info

Cette fonctionnalité est disponible pour nos clients Pro et Enterprise.

Aperçu​

ZigZag propose un système de webhooks permettant d'envoyer les événements d'expédition des commandes directement vers un endpoint sur votre serveur.

Cela peut être utile lorsque vous souhaitez effectuer des actions spécifiques, telles que :

  • Le suivi des expéditions
  • L'analyse des performances des transporteurs
  • Le déclenchement d'e-mails marketing après la livraison

Webhooks disponibles​

Il existe 4 types de webhooks différents.

Premier type - tracker.new

Ce type de webhook est envoyé lorsqu'un nouveau suivi est reçu par ZigZag.

Deuxième type - tracker.event.new

Ce type de webhook est envoyé lorsqu'un nouvel événement d'expédition est récupéré pour un suivi.

Important

Pour les webhooks tracker.event.new, si une commande est reçue avec du retard, ZigZag synchronise simultanément tous les événements passés :

  • Tous les événements sont envoyés simultanément par webhook (un webhook par événement).
  • Le dernier statut du suivi est envoyé avec chaque webhook. Chaque webhook contient tous les événements passés dans le champ events.
  • L'ordre d'envoi des webhooks n'est pas garanti.
  • Un objet reason est toujours inclus dans le webhook pour indiquer l'événement qui l'a déclenché. Dans cette situation, chaque webhook aura une valeur reason différente, correspondant à l'événement ayant déclenché le webhook.

Troisième type - notifications.new

Ce type de webhook est envoyé lorsqu'une nouvelle notification ZigZag est envoyée.

Ce webhook doit être configuré comme canal pour chaque notification devant le déclencher.

Il peut notamment être utilisé pour envoyer vos propres e-mails (par exemple, des relances, des enquêtes de satisfaction ou d'autres campagnes marketing) déclenchés par une notification ZigZag (par exemple, "Package delivered").

Quatrième type - feedback.new

Ce type de webhook est envoyé lorsqu'un nouveau retour d'expérience client est enregistré.

Vous pouvez utiliser les webhooks Feedback pour personnaliser les communications futures avec un client en fonction de ses réponses au questionnaire.

Exemples :

  • Ce webhook peut être utilisé dans Klaviyo pour déclencher des notifications uniquement pour les clients satisfaits.
  • Ce webhook peut être utilisé pour envoyer des codes promotionnels x jours après la livraison aux clients ayant subi un retard de livraison.

Comment configurer un webhook​

Documentation technique sur les données transmises par les webhooks

  1. Accédez à Settings -> API & Webhooks.
  2. Cliquez sur Add endpoint pour sélectionner le ou les types de données que vous souhaitez recevoir.
  3. Ajoutez, modifiez et testez l'URL renseignée.
  4. Activez, désactivez, modifiez ou supprimez les webhooks configurés dans la liste (voir la deuxième image du carrousel).

Activer les webhooks dans l'éditeur de notifications​

  1. Accédez à Paramètres du portail -> Paramètres des notifications -> Éditeur.
  2. Cliquez sur Modifier à côté de Canaux pour la notification de votre choix.
info

Sans cette configuration, les webhooks que vous avez créés ne pourront vous transmettre aucune donnée.

Important

Cette procédure doit être effectuée pour chaque notification pour laquelle vous souhaitez recevoir des données.

Cette procédure doit être effectuée pour chaque langue activée dans votre compte.