-50 % avec le code BLACKFRIDAY50-20 % avec le code BLACKFRIDAY20
Intégrations et APIToutes les formules

Webhooks pour les nouvelles commandes

Un webhook envoie chaque nouvelle commande, et chacun de ses changements, à votre propre système sous forme de message JSON signé. Vous donnez à Menuthere une adresse HTTPS et un secret, puis vous vérifiez la signature de chaque requête. Un bouton de test et un journal des envois permettent de vérifier que tout fonctionne.

Où
Set up by Menuthere support
Formule
Le tableau de bord ne verrouille pas les webhooks selon la formule.
Durée
15 min
Mis à jour

Mettre en place un webhook

Étape 1: Envoyez votre adresse au support

Les webhooks ne sont pas encore dans le tableau de bord : c'est donc le support Menuthere qui les met en place. Envoyez au support l'adresse qui recevra les commandes. Elle doit commencer par https:// et être joignable depuis Internet. Les adresses comme localhost ou un réseau privé ne peuvent pas être appelées.

Étape 2: Conservez le secret de signature

Le support active les webhooks de commande et vous remet un secret de signature. Gardez-le uniquement sur votre serveur. Vous l'utilisez pour vérifier que chaque requête vient bien de Menuthere.

Étape 3: Demandez un événement de test

Demandez au support d'envoyer un événement de test. Il envoie un exemple d'order.created à votre adresse, et le résultat affiche Delivered avec le code de réponse de votre point d'accès, ou ce qui n'a pas fonctionné.

Ce que Menuthere envoie

ÉvénementEnvoyé quand
order.createdUne commande est passée.
order.status_updatedLe statut d'une commande change, par exemple acceptée, plat prêt ou terminée.
payment.status_updatedUne commande est marquée payée, ou son mode de paiement change.
delivery.status_updatedUn livreur est affecté ou l'état de la livraison change.
En-têteValeur
x-menuthere-eventLe nom de l'événement.
x-menuthere-timestampL'heure Unix en secondes, redéfinie à chaque tentative.
x-menuthere-signatureUn HMAC-SHA256 hexadécimal du corps brut de la requête, calculé avec votre secret.

Le corps est une enveloppe avec event, un id unique, created_at et data. Un événement de test porte aussi "test": true : ignorez-le donc dans votre cuisine. Pour order.created, data contient les champs ci-dessous.

ChampContenu
order_id, order_numberL'identifiant de la commande et le numéro affiché à votre équipe.
status, type, placed_at, currencyLe statut actuel, le type de commande, l'heure de la commande et la devise.
totalssubtotal, delivery_charge, packing_charge, gst, discount, grand_total.
customername, phone, address.
tableLe number et le name de la table pour une commande de table, sinon vide.
itemsChaque ligne : name, quantity, unit_price, total_price, variant, notes.
notes, paymentLa note du client, ainsi que le method de paiement et si is_paid.

Vérification et fiabilité

  • Vérifiez la signature par rapport au corps brut. Analyser puis réencoder le JSON modifie les espaces et l'ordre, et la signature ne correspondra pas.
  • Soyez idempotent. Le même id peut arriver deux fois. Servez-vous-en pour éviter un second ticket de cuisine.
  • Répondez vite avec un 2xx. Menuthere attend 8 secondes par tentative et réessaie jusqu'à trois fois, après 1,5 seconde puis 5 secondes. Un délai dépassé, un 5xx, un 408 ou un 429 est réessayé. Tout autre 4xx est considéré comme un refus volontaire et arrête les essais.
  • Consultez Recent deliveries. Le panneau liste les tentatives des dernières 24 heures, les plus récentes en premier, avec le code de réponse et l'heure. Chaque nouvel essai a sa propre ligne.
Bon à savoirUn point d'accès défaillant n'arrête ni ne retarde jamais la commande d'un client.

Questions

Puis-je le diriger vers un serveur de mon propre réseau ?
Pas directement. L'adresse doit être en HTTPS public. Les adresses localhost et de réseau privé sont refusées.
Puis-je indiquer à ma caisse que la commande a été acceptée ?
Le journal des envois est-il conservé indéfiniment ?
Le panneau affiche les tentatives des dernières 24 heures.

Vous ne trouvez pas ? Écrivez à help@mail.menuthere.com ou discutez avec nous, de 9 h à 21 h.Centre d'aideTarifsmenuthere.com