Webhookrecept voor Zapier en Make

1. Wat u nodig hebt

Een QR Wait-account waarvan u eigenaar bent (managers en medewerkers zien de integraties niet), een Zapier- of Make-account en het scherm Integraties van de beheerpagina open in een ander tabblad.

2. Zapier

1. Maak in Zapier een Zap met Webhooks by Zapier als trigger en Catch Hook als gebeurtenis. Kopieer de webhook-URL die Zapier toont.
2. Plak die in QR Wait onder Integraties in Endpoint-adres (https), vink de gewenste gebeurtenissen aan en klik op Webhook toevoegen. Bewaar het ondertekeningsgeheim, dat maar één keer wordt getoond.
3. Sluit één keer aan in uw wachtrij met een telefoon, of voeg iemand toe in het medewerkerspaneel, zodat er een echte ticket.joined-gebeurtenis binnenkomt. Testgebeurtenis versturen stuurt alleen een ping zonder ticketvelden: die laat alleen zien dat het adres antwoordt.
4. Test terug in Zapier de trigger en kies die gebeurtenis. Voeg een actie toe, bijvoorbeeld Google Sheets › Create Spreadsheet Row, en koppel de velden: type, queue.name, ticket.no, ticket.size, ticket.joined_at.
5. Publiceer de Zap. Vanaf nu voegt elke gebeurtenis een rij toe.

3. Make

1. Maak in Make een scenario waarvan de eerste module Webhooks › Custom webhook is. Voeg een webhook toe en kopieer het adres.
2. Plak het zoals hierboven in QR Wait onder Integraties en klik op Webhook toevoegen.
3. Make wacht om de structuur van de gegevens te leren: sluit één keer aan in uw wachtrij of voeg iemand toe in het medewerkerspaneel.
4. Voeg de volgende module toe, bijvoorbeeld Google Sheets › Add a Row of een bericht in uw chat, koppel de velden en zet het scenario aan.

4. Wat er binnenkomt

Elke gebeurtenis is een JSON-body zoals deze. Vink in QR Wait alleen de gebeurtenissen aan die u nodig hebt, of filter in Zapier of Make op type.

{
  "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" }
}

Namen, antwoorden op het aanmeldformulier en boekingscodes worden alleen verstuurd als u voor dat adres Namen, antwoorden op het aanmeldformulier en boekingscodes meesturen aanvinkt. Anders bevatten gebeurtenissen alleen nummers en tijden.

Een mislukte levering wordt ongeveer 9 uur lang opnieuw geprobeerd met dezelfde id. Controleer die voordat u een rij toevoegt (met een zoekstap) als een dubbele rij een probleem is.

5. Andersom: mensen toevoegen vanuit Zapier of Make

Wilt u dat een ander hulpmiddel mensen in een wachtrij zet (een formulier op uw website, een boekingstool), maak dan onder API-sleutels een sleutel met toegang Lezen en schrijven en stuur een verzoek vanuit Webhooks by Zapier › POST of de Make-module HTTP › Make a request:

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

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

Het antwoord is het nieuwe nummer, zoals { "no": 43 }. De id's van de wachtrijen komen uit GET /api/v1/queues. De volgende oproepen, iemand als geholpen markeren en alle velden staan in de API-referentie (in het Engels).

6. Veilig houden

• Het adres dat Zapier of Make u geeft, is genoeg om gegevens naar uw Zap of scenario te sturen: deel het niet.
• Zapier en Make controleren de handtekening van QR Wait niet zelf. Moet de ontvangende kant zeker weten dat een gebeurtenis van QR Wait komt, controleer dan de header X-QRWait-Signature zoals de API-referentie laat zien, bijvoorbeeld in een codestap.
• Geef een sleutel alleen de toegang die nodig is en trek hem in op het scherm Integraties zodra hij niet meer wordt gebruikt; daar ziet u wanneer elke sleutel voor het laatst is gebruikt.