Configurer un webhook
Dans resmio, les webhooks sont un mécanisme de déclenchement léger permettant d’informer les systèmes externes en temps réel des modifications apportées aux réservations et aux commandes en ligne.
Généralités
En termes simples, les webhooks permettent de connecter resmio à des systèmes externes et de les informer automatiquement d’événements spécifiques.
Par exemple, des réservations ou des commandes réussies.
Un webhook est une notification automatique par requête HTTP que resmio envoie à une URL que vous avez configurée dès qu’un événement spécifique se produit.
Les cas d’utilisation suivants sont envisageables :
- Flux de travail basés sur des événements (un système doit réagir à des événements spécifiques sans en connaître les détails)
- Notifications internes (vous ou votre équipe devez être informés qu’un événement s’est produit)
- Comptage et synchronisation des statuts (une application tierce se contente de compter les événements)
- Surveillance et processus techniques
Les destinataires typiques des webhooks resmio sont des plateformes d’automatisation comme Zapier, Make ou n8n, des serveurs internes, des systèmes de notification (Slack, Teams) ou des outils de reporting comme Google Sheets, qui réagissent aux événements sans traiter les données de réservation ou de commande.
| Élément | Description |
|---|---|
| Méthode | HTTP POST |
| Authentification | Basic Auth |
| Format | JSON |
| Payload | id, facility_id, action |
| Objectif | Déclencheur pour systèmes externes |
| Données détaillées | Récupérer via l’API |
La configuration et la mise à jour des webhooks s’effectuent facilement et directement depuis votre compte resmio.
- Connectez-vous au système et allez dans
Paramètres > Intégrations > Développeurs > Webhooks - Ajoutez un nouveau webhook en cliquant sur le bouton + Ajouter un webhook.
- Les informations suivantes doivent être fournies pour le webhook :
- une URL de destination pour la requête HTTP
- un Nom d’utilisateur (pour l’autorisation)
- le Mot de passe (pour l’autorisation)
- l’Action/l’événement souhaité(e)
Paramètres > Intégrations > Une fois votre webhook enregistré dans resmio, le système envoie automatiquement une requête HTTP POST à votre URL lorsque l’action sélectionnée se produit. Votre application reçoit la requête et peut y réagir en conséquence (par exemple, enregistrer des données, démarrer un processus spécifique, etc.).
L’authentification s’effectue via Basic Auth (nom d’utilisateur et mot de passe). Ces données sont transmises dans l’en-tête HTTP. Votre serveur vérifie les identifiants avant le traitement.
Actuellement, un total de six actions de webhook sont disponibles dans resmio.
| Domaine | Déclencheur | Signification |
|---|---|---|
| Réservations (booking) | booking_created | Une nouvelle réservation a été créée. |
| Réservations (booking) | booking_updated | Une réservation existante a été modifiée (ex. heure, nombre de personnes). |
| Réservations (booking) | booking_deleted | Une réservation a été annulée ou supprimée. |
| Commandes en ligne (productorder) | productorder_created | Une nouvelle commande en ligne a été reçue. |
| Commandes en ligne (productorder) | productorder_updated | Une commande existante a été modifiée. |
| Commandes en ligne (productorder) | productorder_deleted | Une commande a été annulée ou supprimée. |
La requête webhook ne contient actuellement qu’une charge utile (payload) minimale.
Un exemple pratique :
{
"id": 51918313,
"facility_id": "the-fish",
"action": "BOOKING_CREATED"
}
Les champs inclus sont les suivants :
id
L’ID interne de la réservation ou de la commande, attribué par resmio
facility_id
L’identifiant unique du compte resmio (restaurant).
action
L’événement déclenché, voir le tableau ci-dessus pour toutes les actions de webhook.
Le webhook sert principalement de déclencheur, et non de transport complet de données.
