Ce que fait un webhook
Un webhook envoie les détails d'un événement de votre boutique vers un autre endroit dès qu'il se produit. Vous choisissez l'événement et sa destination :
- API : Storeep envoie les données de l'événement à une adresse web (URL) de votre serveur, de votre CRM, d'un scénario Zapier ou Make, ou d'un outil de suivi publicitaire.
- E-mail : Storeep envoie les données de l'événement à une adresse e-mail, par exemple pour recevoir un e-mail à chaque nouvelle commande.
Ouvrez Réglages > Webhooks. Vous avez besoin de l'autorisation Réglages.
Beaucoup d'outils ont déjà une application prête à l'emploi, ce qui est plus simple : Google Sheets, réseaux de livraison et pixels publicitaires. Consultez d'abord le marché des applications.
Créer un webhook
Cliquez sur Ajouter un nouveau webhook, remplissez le formulaire et cliquez sur Ajouter.
- Activer : coché par défaut. Lorsqu'il est coché, les événements sont envoyés immédiatement. Décochez-le pour garder le webhook tout en le mettant en pause.
- Nom : une étiquette pour votre liste, par exemple « Nouvelles commandes CRM ».
- Type : API ou E-mail.
- Évènement :
- Commande créée : un client passe une nouvelle commande.
- Commande actualisée : le statut ou les détails d'une commande changent.
- Session créée : un nouveau visiteur arrive sur votre boutique. Type API uniquement.
- Format : Json.
- URL (type API) : l'adresse de destination. La partie
https://est ajoutée pour vous, tapez donc le reste, commeapi.example.com/orders. - Adresse e-mail (type E-mail) : l'adresse où l'e-mail est envoyé.
Un webhook E-mail n'envoie que les événements de commande. Si vous choisissez E-mail avec Session créée, rien n'est envoyé.
Mettre les données de commande dans l'URL
Vous pouvez placer n'importe quel champ des données de l'événement dans l'URL avec des doubles accolades, {{field_name}}. Par exemple :
example.com/postback?cid={{fbclid}}&payout={{order_total}}
Cela envoie l'identifiant de clic Facebook et le total de la commande à une plateforme de suivi publicitaire ou d'affiliation, sans serveur supplémentaire. Un champ qui n'existe pas devient vide. Pour voir les noms des champs, créez un webhook E-mail pour le même événement et regardez les données reçues.
La liste des webhooks
Chaque ligne affiche le Nom, l'URL / E-mail, le Type, l'Évènement, le Format et le Statut (Activé ou Désactivé). Cliquez sur une ligne pour la modifier. Cochez des lignes et choisissez Supprimer les webhooks pour les supprimer définitivement. Il existe un nombre maximal de webhooks par boutique, et un message s'affiche quand vous l'atteignez.
Vous pouvez créer plusieurs webhooks pour le même événement, par exemple un vers votre CRM et un vers votre outil de suivi publicitaire.
Quand un envoi échoue
- Votre serveur doit répondre rapidement avec un code de succès (2xx). Une réponse lente compte comme un échec.
- Si votre serveur est en panne ou occupé (une réponse 5xx ou 429, ou aucune réponse), Storeep réessaie plusieurs fois au cours des minutes suivantes. Seuls les webhooks en échec sont relancés, donc les autres ne reçoivent pas de doublons.
- Si votre serveur refuse la requête (une réponse 4xx comme 404 ou 403), Storeep ne réessaie pas, car l'adresse ou sa sécurité est incorrecte.
- Lorsqu'un webhook échoue plusieurs fois de suite, le propriétaire de la boutique reçoit un seul e-mail : « Action requise : votre webhook Storeep échoue », avec le nom du webhook, l'adresse, l'événement et le dernier code d'erreur. Une fois que le webhook fonctionne à nouveau, un futur problème peut déclencher une nouvelle alerte. Vous pouvez désactiver cet e-mail dans Notifications.
- Les webhooks E-mail sont envoyés une seule fois, sans nouvelle tentative.
Webhooks en pause à cause d'un solde impayé
Si votre boutique a un montant dû impayé et que votre portefeuille ne peut pas le couvrir, les webhooks attendent. Ils sont envoyés une fois que vous avez ajouté des fonds et que le montant est réglé. Voir Portefeuille et facturation.
Conseils
- Si votre serveur demande un mot de passe ou une clé, mettez-le dans les paramètres de l'URL, par exemple
?key=yoursecret. - Session créée se déclenche pour chaque visiteur, ce qui peut faire beaucoup sur une boutique très fréquentée. Ne l'utilisez que si votre serveur peut suivre.
- Pour qu'un outil lise vos commandes et vos produits quand il le souhaite, utilisez plutôt un jeton d'accès.