Différence entre API et Webhooks
La principale différence entre le fonctionnement général de Webhooks et celui des API réside dans le fait que les API passent des appels sans savoir si elles obtiennent une mise à jour des données en réponse ou non, tandis que Webhooks reçoit des appels via HTTP POST depuis des systèmes externes uniquement lorsque ces derniers disposent de mises à jour.
Les Webhooks peuvent ensuite "activer" l'ensemble du flux de travail d'intégration pour agir sur ces mises à jour. Cependant, l'aspect essentiel est que cette activation a lieu pour une raison (c’est-à-dire parce qu’il existe un besoin réel de mise à jour du processus), et pas seulement parce qu’il est temps de procéder à une nouvelle vérification de la mise à jour.
Ce qui est bien aussi avec Webhooks, c'est qu’ils fournissent d’autres applications et services avec des informations (presque) en temps réel. Cela est également possible avec les API, mais cela demande davantage d'efforts et consomme énormément de ressources. Webhooks rend le temps réel très simple.
Remarque
Cliquez ici pour commencer à utiliser l'API de Regiondo
2. Créez votre propre Webhook
Pour créer votre propre Webhook dans votre compte Regiondo, allez à Marketing > Webhooks.
2.1 Nom du Webhook
Donnez un nom à votre Webhook. Il ne sera rien que pour vous.
Exemple
Notification Google
2.2 Type de déclencheur
Choisissez parmi les 3 déclencheurs suivants: Réservation, Client et Billet.
2.2.1 Réservation - Valeurs de réponse
{
"booking_key": "1-2605248-44215-75508-1556874000",
"product_id": "44215",
"product_supplier_id": "9357",
"option_id": "174184",
"variation_id": "75508",
"order_id": "2605248",
"option_name": "Adulte",
"variation_name": "Tours en Français ",
"ticket_name": "La route de Bordeaux",
"product_name": "La route de Bordeaux",
"qty": "1",
"qty_cancelled": "0",
"event_date_time": "2019-05-03T09:00:00+02:00",
"date_applied_for": "2019-05-03T09:00:00+02:00",
"created_at": "2019-04-30T11:02:45+02:00",
"type": "booking",
"status": "approved",
"external_id": null,
"email": "customer.name@regiondo.com",
"phone_number": null,
"first_name": "Customer",
"last_name": "Name",
"duration_type": "minute",
"duration_value": "50.00",
"order_number": "1556614985033893200",
"contact_data": {
"firstname": "Customer",
"lastname": "Name",
"email": "customer.name@regiondo.com",
"telephone": null,
"is_subscribed": "no"
}
}2.2.2 Client - Valeurs de réponse
{
"customer_email": "customer.name@regiondo.com",
"customer_firstname": "Customer",
"customer_lastname": "Name",
"customer_phone": "",
"customer_birth_date": null,
"customer_street": null,
"customer_postcode": null,
"customer_city": null,
"customer_country": null,
"customer_newsletter_status": 0,
"customer_newsletter_order": null,
"customer_newsletter_datetime": null,
"customer_newsletter_ip": null
}{
"customer_email": "customer.name@regiondo.com",
"customer_firstname": "Customer",
"customer_lastname": "Name",
"customer_phone": "",
"customer_birth_date": null,
"customer_street": "Neumarkter Str. 63",
"customer_postcode": "81673",
"customer_city": "München",
"customer_country": "DE",
"customer_newsletter_status": 0,
"customer_newsletter_order": null,
"customer_newsletter_datetime": null,
"customer_newsletter_ip": null
}2.2.3 Billet - Valeurs de réponse
{
"code": "RE57WGQH0G6S",
"status": "processing",
"validation_status": "not validated",
"data": {
"validated_at": "2019-04-30T11:03:11+02:00",
"product_info": {
"product_name": "La route de Bordeaux",
"variation_name": "Tours en Français ",
"option_name": "Adulte",
"ticket_datetime": "2019-05-03T09:00:00+02:00"
},
"customer_info": {
"customer_name": "Mr. Customer Name",
"customer_email": "customer.name@regiondo.com"
}
}
}{
"code": "RE57WGQH0G6S",
"status": "sent",
"validation_status": "validated",
"data": {
"validated_at": "2019-04-30T11:09:09+02:00",
"product_info": {
"product_name": "La route de Bordeaux",
"variation_name": "Tours en Français ",
"option_name": "Adulte",
"ticket_datetime": "2019-05-03T09:00:00+02:00"
},
"customer_info": {
"customer_name": "Mr. Customer Name",
"customer_email": "customer.name@regiondo.com"
}
}
}3. URL
Ici, vous devez entrer l'URL à appeler lorsque le déclencheur Webhook se produit dans le tableau de bord.
Note
N'oubliez pas de tester l'URL avant de sauvegarder / activer le Webhook.
4. Webhook sur le Actions commerciales – Produits supplémentaires
Il est possible de connecter des produits supplémentaires au webhook, mais il y a une limitation : La TVA n'est pas répercutée.
Le montant du produit supplémentaire sera ajouté au montant TTC de la réservation.
Seul le montant total de la commande est affiché, c'est-à-dire le montant de l'offre + le produit supplémentaire.
Exemple : montant de l'offre 50E + produit supplémentaire 5E = 55 EUROS
Toutes les autres informations seront transmises, telles que :
L'identification du produit, la quantité, les annulations, le statut, le paiement, le numéro de réservation, les informations sur l'acheteur, le prix de la commande TVA incluse.