Skip to main content
Une intégration transmet ce qui se passe dans Zippendo à un autre outil que vous utilisez. Lorsqu’une expédition est créée, qu’une commande arrive ou qu’un colis reçoit un nouveau scan de suivi, Zippendo transmet l’information à Slack, Klaviyo, Zapier et aux autres. Les intégrations ne font pas entrer de commandes (c’est le rôle d’un canal de vente), et ce n’est pas un webhook vers un serveur qui vous appartient. Besoin de conditions, de délais ou de plusieurs étapes, par exemple « publier sur Slack uniquement lorsque le colis part à l’étranger » ? Utilisez plutôt les Automatisations.
Les intégrations sont incluses dans toutes les formules.

Où la trouver

Cliquez sur Applications et intégrations dans la barre latérale. La page comporte deux onglets : Le Catalogue comporte deux parties :
  • Les Applications sont des outils auxquels Zippendo envoie des événements : Klaviyo, Slack, Customer.io, Mailchimp, SendGrid, Zapier et Make. Cette page les couvre.
  • Les Intégrations sont des systèmes qui se connectent à Zippendo et lui demandent de faire quelque chose : un système d’entrepôt comme PeakWMS qui imprime des étiquettes, ou un assistant IA connecté via MCP.
Catalogue avec des cartes pour Klaviyo, Slack, Customer.io, Mailchimp, SendGrid, Zapier et MakeCatalogue avec des cartes pour Klaviyo, Slack, Customer.io, Mailchimp, SendGrid, Zapier et Make

Le catalogue liste toutes les applications que vous pouvez connecter

Chaque carte d’application affiche le nom de l’application et une courte description, ainsi que :
  • Utiliser dans les automatisations ouvre Automatisations, où vous pouvez utiliser l’application comme étape.
  • En savoir plus ouvre dans un nouvel onglet le guide de configuration de cette application sur ce site.
  • Connecter démarre une nouvelle connexion. Dès que l’application a une connexion, le bouton indique Ajouter une connexion.

Ce que demande chaque application

Les champs marqués d’un * dans l’application sont obligatoires.

Connecter une application

1

Ouvrez le catalogue

Cliquez sur Applications et intégrations dans la barre latérale, puis sur l’onglet Catalogue. Si l’onglet Connecté indique Rien de connecté pour le moment, cliquez sur Ouvrir le catalogue.
2

Cliquez sur Connecter sur l'application

Une fenêtre portant le nom de l’application s’ouvre, par exemple Connecter Zippendo à Slack.
3

Vérifiez les accès

La première étape, Vérifier les accès, liste ce que Zippendo fera sous Zippendo souhaite : envoyer les événements que vous choisissez, inclure ce que ces événements contiennent (nom du client, e-mail et téléphone, adresse de livraison, lignes de commande, colis et numéros de suivi), utiliser les identifiants que vous saisissez (stockés chiffrés et jamais réaffichés), et enregistrer chaque envoi dans le journal des envois. Cliquez sur Continuer.
4

Renseignez les détails de la connexion

Sous Détails de la connexion, saisissez un Nom de la connexion que vous reconnaîtrez plus tard, par exemple « Slack de l’équipe d’emballage » (jusqu’à 100 caractères). Renseignez ensuite les champs propres à l’application, indiqués dans le tableau ci-dessus.
5

Choisissez les événements

Sous Zippendo enverra à et le nom de l’application, cochez chaque événement que l’application doit recevoir, ou cliquez sur Tout sélectionner. Vous pouvez aussi laisser toutes les cases vides : rien n’est alors envoyé automatiquement, mais vous pouvez quand même utiliser la connexion dans une automatisation et envoyer un événement de test.
6

Cliquez sur Connecter

Connecter reste grisé tant que le nom de la connexion et tous les champs obligatoires ne sont pas remplis. Lorsque cela fonctionne, vous voyez Intégration connectée, et l’application apparaît dans l’onglet Connecté.
Fenêtre de connexion pour Slack avec un nom de connexion, l'URL du webhook entrant et des cases d'événementsFenêtre de connexion pour Slack avec un nom de connexion, l'URL du webhook entrant et des cases d'événements

Les détails de la connexion : un nom, les champs propres à l'application et les événements à envoyer

Événements que vous pouvez envoyer

Les événements sont regroupés sous Expéditions, Commandes et Suivi. Chaque application n’affiche que les événements qu’elle peut utiliser. Ce sont les mêmes événements que ceux des webhooks. Les webhooks de suivi des transporteurs sont autre chose : voir Webhooks de suivi des transporteurs.

Vos connexions

Dans l’onglet Connecté, chaque carte d’application a un badge vert Connecté et le nombre de connexions, par exemple « 2 connexions ». Vous pouvez connecter la même application plusieurs fois, par exemple un canal Slack par équipe : cliquez sur Ajouter une connexion sur la carte.
Onglet Connecté avec une carte Slack affichant une connexion et quatre icônesOnglet Connecté avec une carte Slack affichant une connexion et quatre icônes

Une application connectée avec sa connexion et les quatre icônes

Chaque connexion est une ligne avec son nom et le nombre d’événements qu’elle envoie, par exemple « 3 événements ». En pause après le nombre signifie que la connexion a été désactivée via l’API Zippendo. Une connexion en pause n’envoie rien, et il n’existe pas d’interrupteur pour cela dans l’application. Survolez les icônes pour voir leur fonction :

Envoyer un événement de test

Cliquez sur l’avion en papier. Événement de test envoyé signifie que Zippendo a mis le test en file d’attente, et non que l’application l’a accepté. Ouvrez le journal des envois quelques secondes plus tard pour voir comment l’application a répondu. Si vous voyez Impossible d’envoyer l’événement de test ou un autre message à la place, le test n’a pas pu être mis en file d’attente : lisez le message et réessayez. Un événement de test ne contient ni client ni commande. Les applications qui classent les événements sous l’e-mail d’un client (Mailchimp, SendGrid et Klaviyo) peuvent donc afficher un test en échec même si vos identifiants sont corrects. La page de chaque application indique à quoi s’attendre.

Journal des envois

Cliquez sur l’icône de prise. La fenêtre Journal des envois liste les envois récents de cette connexion, du plus récent au plus ancien. Elle indique Aucun envoi pour le moment jusqu’au premier événement ou test.
Fenêtre Journal des envois indiquant Aucun envoi pour le momentFenêtre Journal des envois indiquant Aucun envoi pour le moment

Le journal des envois reste vide jusqu'au premier événement ou test

Chaque ligne affiche :
  • une coche verte si l’application a accepté l’événement, ou une croix rouge si elle ne l’a pas fait
  • l’événement sous la forme dans laquelle Zippendo l’envoie, par exemple shipment.dispatched (un test apparaît sous la forme integration.test)
  • le code avec lequel l’application a répondu : un nombre de la série 200 signifie accepté, 401 ou 403 signifie que l’application a refusé vos identifiants, 404 signifie que l’adresse web n’existe plus
  • la durée de l’envoi et le moment où il a eu lieu
  • le texte d’erreur propre à l’application en cas d’échec
Lorsqu’un envoi échoue, Zippendo réessaie jusqu’à 5 fois en quelques minutes. Chaque tentative est une ligne distincte.

Modifier une connexion

Cliquez sur l’icône de curseurs. Une fenêtre portant le nom de l’application s’ouvre, par exemple Modifier votre connexion Slack. Elle contient les mêmes champs que lors de la connexion.
  • Modifiez librement le Nom de la connexion et les événements cochés.
  • Les champs d’identifiants sont vides au départ, car Zippendo ne les réaffiche jamais. Laissez-les tous vides pour conserver ce qui est enregistré.
  • Si vous saisissez quoi que ce soit dans un champ d’identifiants, tout ce qui est enregistré pour cette connexion est remplacé par ce que vous venez de saisir. Si vous modifiez l’un d’eux, renseignez-les donc tous.
Cliquez sur Enregistrer les modifications. Vous voyez Intégration mise à jour.
Fenêtre de modification d'une connexion Slack avec le nom de la connexion, un champ de webhook vide et les événementsFenêtre de modification d'une connexion Slack avec le nom de la connexion, un champ de webhook vide et les événements

Modifier une connexion : la renommer, remplacer ses identifiants ou changer ses événements

Déconnecter une application

Cliquez sur la corbeille. La fenêtre Déconnecter l’intégration avertit : Déconnecter cette intégration ? Zippendo cesse de lui envoyer des événements et supprime son historique d’envois. Saisissez DELETE dans le champ et cliquez sur Déconnecter. Vous voyez Intégration déconnectée. Les automatisations qui utilisaient cette connexion ne peuvent plus envoyer à l’application tant que vous n’avez pas choisi une autre connexion dans ces automatisations.
Fenêtre Déconnecter l'intégration demandant de saisir DELETEFenêtre Déconnecter l'intégration demandant de saisir DELETE

Saisissez DELETE pour déconnecter

Vous avez terminé lorsque l’application figure dans l’onglet Connecté et que le journal des envois affiche une coche verte pour un événement, ou Aucun envoi pour le moment juste après la connexion.

Messages que vous pouvez voir

Pour les problèmes côté application, voir Dépannage des intégrations.

Voir aussi