Webhooks — envoyer les changements de la boutique à une autre application
Un endpoint de webhook est une adresse web (elle doit commencer par https://) qu'Ordexs appelle dès que quelque chose se produit dans votre boutique, pour qu'une autre application en soit informée en quelques secondes. Gérez-les dans Paramètres → Développeurs → Webhooks ; Intégrations → Webhooks les explique et renvoie vers cet écran.
Ce qui peut être envoyé. Les nouvelles commandes, les modifications de commandes, les changements de statut, les annulations, les commandes dont l'adresse doit être vérifiée, les notes ajoutées aux commandes, les produits créés, modifiés ou archivés, les variations de stock, les clients nouveaux ou modifiés, les commandes envoyées au transporteur, les changements de suivi du transporteur (en cours de livraison, livrée, montant encaissé, retournée), les paniers abandonnés (un client a laissé ses coordonnées sans commander, et leurs modifications ultérieures), et les nouveaux avis produits. Choisissez ceux que vous voulez, ou Tous les événements (qui inclut aussi ceux qu'Ordexs ajoutera plus tard).
En ajouter un. Appuyez sur Ajouter un endpoint, choisissez Réel ou Test, collez l'adresse, ajoutez éventuellement une description, et choisissez les événements. Ordexs refuse les adresses qui pointent vers un réseau privé ou vers une adresse Ordexs. Les forfaits permettent 2 endpoints sur Starter, 5 sur Growth et 20 sur Scale.
Le secret de signature. Chaque endpoint reçoit un secret, affiché une seule fois à sa création. L'autre application l'utilise pour vérifier que les requêtes viennent bien de votre boutique. Changer le secret (dans le menu de l'endpoint) en crée un nouveau ; vous pouvez garder l'ancien actif pendant 24 heures ou 3 jours pour que l'application bascule sans rien manquer.
Tester. Envoyer un événement de test dans le menu de l'endpoint envoie immédiatement une requête de test.
Le journal des envois. Voir les livraisons sous un endpoint liste ce qui a été envoyé, si c'est arrivé, le code de réponse, le nombre de tentatives nécessaires et la date de la prochaine tentative. Voir ce qui a été envoyé affiche le contenu exact, et Renvoyer l'envoie à nouveau. Le journal est conservé 7 jours sur Starter, 14 sur Growth et 30 sur Scale.
Quand les envois échouent. Si l'autre application ne répond pas par un succès, Ordexs réessaie après environ 1 minute, 5 minutes, 30 minutes, 2 heures, 6 heures, puis toutes les 12 heures, pendant 3 jours maximum. Un endpoint dont tous les envois échouent depuis 3 jours est Désactivé automatiquement : le propriétaire reçoit un e-mail, et les propriétaires et administrateurs reçoivent une notification. Corrigez l'adresse, puis choisissez Réactiver dans le menu de l'endpoint. Mettre en pause arrête volontairement un endpoint.