Recette webhook pour Zapier et Make

1. Ce qu'il vous faut

Un compte QR Wait dont vous êtes propriétaire (les responsables et le personnel ne voient pas les intégrations), un compte Zapier ou Make, et l'écran Intégrations de la page d'administration ouvert dans un autre onglet.

2. Zapier

1. Dans Zapier, créez un Zap avec Webhooks by Zapier comme déclencheur et Catch Hook comme événement. Copiez l'URL de webhook affichée par Zapier.
2. Dans QR Wait, sous Intégrations, collez-la dans Adresse du point de terminaison (https), cochez les événements voulus et cliquez sur Ajouter un webhook. Conservez le secret de signature, affiché une seule fois.
3. Rejoignez une fois votre file depuis un téléphone, ou ajoutez quelqu'un dans le panneau du personnel, pour qu'un vrai événement ticket.joined arrive. Envoyer un événement de test n'envoie qu'un ping sans les champs du ticket : il montre seulement que l'adresse répond.
4. De retour dans Zapier, testez le déclencheur et choisissez cet événement. Ajoutez une action, par exemple Google Sheets › Create Spreadsheet Row, et associez les champs : type, queue.name, ticket.no, ticket.size, ticket.joined_at.
5. Publiez le Zap. Désormais, chaque événement ajoute une ligne.

3. Make

1. Dans Make, créez un scénario dont le premier module est Webhooks › Custom webhook. Ajoutez un webhook et copiez son adresse.
2. Collez-la dans Intégrations de QR Wait comme ci-dessus et cliquez sur Ajouter un webhook.
3. Make attend pour apprendre la structure des données : rejoignez une fois votre file ou ajoutez quelqu'un dans le panneau du personnel.
4. Ajoutez le module suivant, par exemple Google Sheets › Add a Row ou un message dans votre messagerie, associez les champs et activez le scénario.

4. Ce qui arrive

Chaque événement est un corps JSON comme celui-ci. Cochez dans QR Wait seulement les événements utiles, ou filtrez sur type dans Zapier ou Make.

{
  "id": "d_3f9a1c0b7e2d4a61",
  "type": "ticket.joined",
  "created": "2026-10-10T09:12:30.010Z",
  "account": "antalyabb",
  "queue": { "id": "a1b2c3d4e5", "name": "Konyaaltı Beach", "slug": "konyaalti" },
  "ticket": { "no": 42, "size": 2, "source": "qr", "joined_at": "2026-10-10T09:12:30.004Z" }
}

Les noms, les réponses au formulaire et les codes de réservation ne sont envoyés que si vous cochez Inclure les noms, les réponses au formulaire d'inscription et les codes de réservation pour cette adresse. Sinon, les événements ne contiennent que des numéros et des heures.

Une livraison qui échoue est retentée pendant environ 9 heures avec le même id. Vérifiez-le avant d'ajouter une ligne (avec une étape de recherche) si un doublon posait problème.

5. Dans l'autre sens : ajouter des personnes depuis Zapier ou Make

Pour qu'un autre outil inscrive des personnes dans une file (un formulaire de votre site, un outil de réservation), créez sous Clés d'API une clé avec l'accès Lecture et écriture et envoyez une requête depuis Webhooks by Zapier › POST ou le module HTTP › Make a request de Make :

POST https://qrwait.app/api/v1/queues/<queue id>/tickets
Authorization: Bearer qrw_…
Content-Type: application/json

{ "size": 2, "note": "Website" }

La réponse est le nouveau numéro, par exemple { "no": 43 }. Les identifiants des files s'obtiennent avec GET /api/v1/queues. Appeler le groupe suivant, marquer quelqu'un comme servi et tous les champs sont dans la référence de l'API (en anglais).

6. Restez prudent

• L'adresse fournie par Zapier ou Make suffit pour envoyer des données dans votre Zap ou votre scénario : ne la partagez pas.
• Zapier et Make ne vérifient pas eux-mêmes la signature de QR Wait. Si le destinataire doit être sûr qu'un événement vient de QR Wait, vérifiez l'en-tête X-QRWait-Signature comme l'indique la référence de l'API, par exemple dans une étape de code.
• Ne donnez à une clé que l'accès nécessaire et révoquez-la sur l'écran Intégrations dès qu'elle ne sert plus ; l'écran indique quand chaque clé a été utilisée pour la dernière fois.