Webhooks dans l'API FoodSoul : le CRM informe automatiquement vos services des nouveaux événements

Désormais, FoodSoul envoie automatiquement des notifications à vos systèmes dès qu’un événement se produit dans le CRM. Par exemple, lorsqu’une nouvelle commande arrive, qu’un client paie ou effectue un remboursement, ou qu’un nouvel invité s’inscrit. Il suffit d’indiquer une seule fois l’adresse de votre service, et les données seront immédiatement transmises à votre système de gestion, à votre bot, à un second CRM ou à votre outil d’analyse.

Quels événements peuvent générer des notifications

1. Nouvelle commande avec fiche complète. Utile pour le système de gestion, la cuisine et l’analyse.
2. Changement de statut de la commande. Convient pour un bot qui informe le client sur sa commande, ainsi que pour le centre d’appels.
3. Changement de statut du paiement, y compris les remboursements. Nécessaire pour la comptabilité et la gestion financière.
4. Nouveau client ou modification de ses données. Pour un CRM externe et les services d’envoi de messages.
5. Crédit, débit et expiration des points de fidélité. Pour le programme de fidélité et la communication avec les invités.
6. Nouvel avis. Pour le responsable et le service qualité.
7. Attribution d’un livreur. Pour la logistique et les notifications au client.
8. Modification de la liste des produits indisponibles. Pour le site, la cuisine et les plateformes de vente.
9. Une succursale a suspendu ou repris la prise de commandes. Pour le contrôle opérationnel et la direction du réseau.

Vous choisissez vous-même les événements à recevoir. Il est possible de n’activer que ceux qui vous intéressent, par exemple “nouvelle commande” et “paiement”. Vous ne trouvez pas l’événement souhaité ? Écrivez-nous — nous serons ravis de l’ajouter.

Comment connecter

1. Activez les webhooks pour la succursale concernée — la clé de signature sera générée automatiquement.
2. Sélectionnez les événements pour lesquels vous souhaitez recevoir des notifications.
3. Indiquez l’adresse de votre service à laquelle FoodSoul enverra les données. Seule une adresse HTTPS est acceptée.
4. Ajoutez la clé de signature au service qui reçoit les notifications et configurez la vérification de la signature. Si vous avez indiqué des adresses différentes lors de la création des webhooks, ajoutez la clé à chaque service.
5. Assurez-vous que le service confirme la réception de la notification dans les 10 secondes, sinon FoodSoul la renverra.

6. Mettez en place une vérification des doublons : une même notification peut être reçue plusieurs fois. Tous les doublons ont le même ID (en-tête X-Webhook-ID). Votre service doit mémoriser les ID des notifications traitées et ignorer les doublons — ainsi, un paiement ne sera pas effectué deux fois.

    

Sécurité : à quoi sert la clé de signature
 

FoodSoul signe chaque notification à l’aide d’une clé de signature — une suite de caractères connue uniquement de vous et de nous. Grâce à cette signature, votre système vérifie que la notification provient bien de FoodSoul et qu’elle n’a pas été modifiée en cours de route.
 

N’importe qui peut envoyer une requête à l’adresse de votre service. Par exemple, un fraudeur pourrait envoyer une fausse notification “commande payée”, et vous pourriez remettre une commande non réglée.
 

Avec la signature, cela n’arrivera pas. Votre serveur calcule la signature avec la même clé et la compare à celle reçue. Si les signatures ne correspondent pas, la notification est falsifiée ou modifiée.

 

En cas de problème

• Si votre service est temporairement indisponible, FoodSoul tentera à nouveau de livrer la notification plusieurs fois pendant 10 heures. Une brève panne ou un redémarrage du serveur n’entraînera pas de perte d’événements.
• Si le problème persiste, l’abonnement sera désactivé et vous recevrez un e-mail : ainsi, vous serez informé du problème.
• Pour réactiver l’abonnement, contactez le support technique. Vous pourrez également y renvoyer les notifications qui n’ont pas été livrées pendant la panne.
   

La description détaillée des événements et du format des données se trouve dans la documentation de l’API.

Cordialement, l’équipe FoodSoul ! Nous travaillons pour vous !