Trois façons de connecter TapTime à d’autres systèmes, réunies sous une même rubrique. Seul le propriétaire de l’entreprise peut les gérer. Pour les alertes dans le chat et pour Zapier, Make, n8n ou Pipedream, consultez leurs guides dédiés — ils utilisent les mêmes événements.
Panneau Intégrations Webhooks et API
| Outil | Quand l’utiliser |
|---|---|
| Webhook | Votre propre système ou un CRM doit être informé de chaque réservation, commande ou changement de fidélité, avec tous les détails. |
| Postback | Une régie publicitaire, un affilié ou un outil de suivi vous a fourni une URL de postback à appeler à chaque conversion. |
| API REST | Votre système veut récupérer les réservations quand il le souhaite, ou les confirmer et les annuler. |
Les événements que vous pouvez envoyer
| Événement | Quand |
|---|---|
| booking.requested | Un client a demandé une réservation qui attend votre confirmation |
| booking.confirmed | Une réservation est confirmée |
| booking.cancelled | Le client ou l’établissement a annulé |
| booking.no_show | Le client ne s’est pas présenté |
| booking.completed | La visite est terminée |
| order.placed | La commande d’un client vous est parvenue (depuis votre page ou le QR code d’une table) |
| order.paid | Une commande a été payée, y compris en caisse |
| loyalty.member_joined | Un client a reçu son premier tampon sur un programme |
| loyalty.stamp_added | Un tampon a été ajouté |
| loyalty.reward_issued | Une carte a été complétée et sa récompense émise |
| loyalty.reward_redeemed | Une récompense a été remise |
Webhooks
-
1
Ajouter un webhook
Collez l’adresse https de votre point de terminaison et choisissez les événements — réservations, commandes, fidélité, ou tous.
-
2
Envoyer un test
Un événement d’exemple part immédiatement, et la réponse de votre point de terminaison s’affiche.
-
3
Vérifiez la signature
Chaque requête a un en-tête TapTime-Signature : t=<time>,v1=<HMAC-SHA256 de « t.body » avec votre secret de signature>. Comparez-la avant de faire confiance à la requête.
Le corps est en JSON : l’identifiant, le type et l’heure de l’événement, et la réservation, la commande ou la carte de fidélité complète sous data.booking, data.order ou data.loyalty — avec le client, l’heure, la table, la prestation ou les articles, le statut et la provenance (balises UTM et identifiants de clic).
- Répondez avec n’importe quel statut 2xx. Toute autre réponse entraîne 8 nouvelles tentatives sur environ un jour.
- Chaque événement a un identifiant : si vous le recevez deux fois, ignorez le second.
- Répondez 410 Gone et TapTime cesse de retenter cet événement.
- Les redirections ne sont pas suivies, et les adresses de réseaux privés sont refusées.
Postbacks serveur à serveur
Collez l’URL de postback fournie par votre outil de suivi et cliquez sur les variables pour insérer les détails de la réservation, par exemple https://tracker.example/postback?cid={click_id}&payout={value}&status={status}. Les variables disponibles comprennent {click_id}, {event}, {booking_id}, {value}, {currency}, {party_size}, {utm_source}, {utm_campaign}, {gclid} et {fbclid}. L’identifiant de clic de l’outil de suivi parvient à la réservation lorsque votre lien de réservation contient click_id, clickid ou subid.
API REST
-
1
Créer une clé API
Donnez-lui un nom et choisissez lecture seule, ou lecture et écriture pour permettre de confirmer, d’annuler et de marquer les absences.
-
2
Copiez-la tout de suite
La clé n’est affichée qu’une fois. Conservez-la sur votre serveur — jamais dans une page web ou une application.
-
3
Appelez l’API
Envoyez-la sous la forme Authorization: Bearer <key> à https://api.tapti.me/v1/company.
| Requête | Renvoie |
|---|---|
| GET /v1/company | L’entreprise à laquelle appartient la clé |
| GET /v1/company/reservations, /appointments | Les réservations, filtrées par status, branchId, from, to ou updatedSince, 100 par page |
| GET /v1/company/reservations/{id} | Une réservation |
| POST /v1/company/reservations/{id}/status | Modifier le statut (clés en écriture) |
| GET /v1/company/orders, /orders/{id} | Les commandes avec leurs articles et totaux, filtrées par status, source, fulfilment, from, to ou paidSince |
| GET /v1/company/loyalty/programs, /cards, /rewards | Les programmes de fidélité, les cartes des membres et les récompenses obtenues |
| GET /v1/company/events?after={cursor} | Chaque événement de réservation, de commande et de fidélité dans l’ordre — interrogez-le régulièrement pour rester synchronisé ; ajoutez type=order,loyalty pour n’en recevoir qu’une partie |
| POST /v1/company/webhooks, DELETE /v1/company/webhooks/{id} | Abonner une URL à des événements et la désabonner — ce qu’utilisent les applications Zapier, Make, n8n et Pipedream |
En cas d’échec
Le Journal des envois de chaque point de terminaison liste ses 25 derniers envois avec le code de statut et la réponse de votre système. Les envois en échec sont retentés automatiquement ; « Renvoyer » en relance un immédiatement.
Questions fréquentes
Un webhook peut-il être envoyé vers Zapier ou Make ?
Oui — utilisez Intégrations → Automatisation, qui vérifie que l’adresse appartient bien à la plateforme et affiche ses propres étapes. Créez un « Catch Hook » (Zapier), un « Custom webhook » (Make), un nœud Webhook (n8n) ou un déclencheur HTTP (Pipedream), collez son adresse et cliquez sur Envoyer un test pour que l’outil apprenne les champs.
J’ai perdu mon secret de signature.
Le propriétaire peut l’afficher à nouveau depuis le point de terminaison, ou le renouveler. Le renouvellement en génère immédiatement un nouveau, et l’ancien cesse de fonctionner.
Merci — cela nous aide à améliorer ces guides.
Écrivez-nous en indiquant la page sur laquelle vous étiez. Une vraie personne lit chaque message et répond dans la langue dans laquelle vous avez écrit.
Écrivez-nous