Ricetta webhook per Zapier e Make

1. Cosa serve

Un account QR Wait di cui siete titolari (manager e personale non vedono le integrazioni), un account Zapier o Make e la schermata Integrazioni della pagina di amministrazione aperta in un'altra scheda.

2. Zapier

1. In Zapier, create uno Zap con Webhooks by Zapier come trigger e Catch Hook come evento. Copiate l'URL del webhook mostrato da Zapier.
2. In QR Wait, in Integrazioni, incollatelo in Indirizzo dell'endpoint (https), spuntate gli eventi che vi servono e premete Aggiungi webhook. Conservate il segreto di firma, mostrato una sola volta.
3. Mettetevi in coda una volta da un telefono, oppure aggiungete qualcuno dal pannello del personale, così arriva un vero evento ticket.joined. Invia evento di prova invia solo un ping senza i campi del biglietto: mostra soltanto che l'indirizzo risponde.
4. Tornate in Zapier, testate il trigger e scegliete quell'evento. Aggiungete un'azione, per esempio Google Sheets › Create Spreadsheet Row, e mappate i campi: type, queue.name, ticket.no, ticket.size, ticket.joined_at.
5. Pubblicate lo Zap. Da ora ogni evento aggiunge una riga.

3. Make

1. In Make, create uno scenario il cui primo modulo è Webhooks › Custom webhook. Aggiungete un webhook e copiatene l'indirizzo.
2. Incollatelo in Integrazioni di QR Wait come sopra e premete Aggiungi webhook.
3. Make attende per imparare la struttura dei dati: mettetevi in coda una volta o aggiungete qualcuno dal pannello del personale.
4. Aggiungete il modulo successivo, per esempio Google Sheets › Add a Row o un messaggio nella vostra chat, mappate i campi e attivate lo scenario.

4. Cosa arriva

Ogni evento è un corpo JSON come questo. Spuntate in QR Wait solo gli eventi che vi servono, oppure filtrate per type in Zapier o 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" }
}

Nomi, risposte al modulo e codici di prenotazione vengono inviati solo se spuntate Includi nomi, risposte al modulo di iscrizione e codici di prenotazione per quell'indirizzo. Altrimenti gli eventi contengono solo numeri e orari.

Una consegna non riuscita viene ritentata per circa 9 ore con lo stesso id. Controllatelo prima di aggiungere una riga (con un passo di ricerca) se un duplicato vi creerebbe problemi.

5. Al contrario: aggiungere persone da Zapier o Make

Perché un altro strumento metta persone in coda (un modulo del vostro sito, uno strumento di prenotazione), create in Chiavi API una chiave con accesso Lettura e scrittura e inviate una richiesta da Webhooks by Zapier › POST o dal modulo HTTP › Make a request di Make:

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

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

La risposta è il nuovo numero, per esempio { "no": 43 }. Gli id delle code si ottengono con GET /api/v1/queues. Chiamare il gruppo successivo, segnare qualcuno come servito e tutti i campi sono nel riferimento dell'API (in inglese).

6. In sicurezza

• L'indirizzo fornito da Zapier o Make basta per inviare dati al vostro Zap o scenario: non condividetelo.
• Zapier e Make non verificano da soli la firma di QR Wait. Se chi riceve deve essere sicuro che un evento provenga da QR Wait, verificate l'intestazione X-QRWait-Signature come mostra il riferimento dell'API, per esempio in un passo di codice.
• Date a ogni chiave solo l'accesso che le serve e revocatela nella schermata Integrazioni quando non si usa più; la schermata mostra quando ogni chiave è stata usata l'ultima volta.