Rețetă de webhook pentru Zapier și Make

1. De ce ai nevoie

Un cont QR Wait al cărui proprietar ești (managerii și operatorii nu văd integrările), un cont Zapier sau Make și ecranul Integrări din pagina de administrare deschis într-o altă filă.

2. Zapier

1. În Zapier, creează un Zap cu Webhooks by Zapier ca declanșator și Catch Hook ca eveniment. Copiază URL-ul de webhook afișat de Zapier.
2. În QR Wait, la Integrări, lipește-l în Adresa endpointului (https), bifează evenimentele dorite și apasă Adaugă webhook. Păstrează secretul de semnare, care se afișează o singură dată.
3. Intră o dată în coadă de pe un telefon sau adaugă pe cineva în panoul operatorului, ca să sosească un eveniment ticket.joined real. Trimite un eveniment de test trimite doar un ping fără câmpurile bonului: arată că adresa răspunde.
4. Înapoi în Zapier, testează declanșatorul și alege acel eveniment. Adaugă o acțiune, de exemplu Google Sheets › Create Spreadsheet Row, și asociază câmpurile: type, queue.name, ticket.no, ticket.size, ticket.joined_at.
5. Publică Zap-ul. De acum, fiecare eveniment adaugă un rând.

3. Make

1. În Make, creează un scenariu al cărui prim modul este Webhooks › Custom webhook. Adaugă un webhook și copiază-i adresa.
2. Lipește-o în Integrări din QR Wait, ca mai sus, și apasă Adaugă webhook.
3. Make așteaptă să afle structura datelor: intră o dată în coadă sau adaugă pe cineva în panoul operatorului.
4. Adaugă modulul următor, de exemplu Google Sheets › Add a Row sau un mesaj în chatul tău, asociază câmpurile și activează scenariul.

4. Ce sosește

Fiecare eveniment este un corp JSON ca acesta. Bifează în QR Wait doar evenimentele de care ai nevoie sau filtrează după type în Zapier ori 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" }
}

Numele, răspunsurile din formularul de înscriere și codurile de programare se trimit doar dacă bifezi Include numele, răspunsurile din formularul de înscriere și codurile de programare pentru acea adresă. Fără această opțiune, evenimentele conțin doar numere și ore.

O livrare eșuată este reîncercată timp de aproximativ 9 ore, cu același id. Verifică-l înainte de a adăuga un rând (un pas de căutare) dacă un duplicat ar conta.

5. Invers: adaugă persoane din Zapier sau Make

Ca să lași alt instrument să pună persoane într-o coadă (un formular de pe site, un instrument de rezervări), creează o cheie la Chei API cu acces Citire și scriere și trimite o cerere din Webhooks by Zapier › POST sau din HTTP › Make a request în Make:

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

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

Răspunsul este noul număr de ordine, de exemplu { "no": 43 }. ID-urile cozilor vin de la GET /api/v1/queues. Chemarea grupului următor, marcarea cuiva ca deservit și toate câmpurile sunt descrise în documentația API (în engleză).

6. Păstrează-l în siguranță

• Adresa pe care ți-o dă Zapier sau Make este suficientă pentru a trimite date în Zap-ul sau scenariul tău: nu o distribui.
• Zapier și Make nu verifică singure semnătura QR Wait. Dacă partea care primește trebuie să fie sigură că un eveniment vine de la QR Wait, verifică antetul X-QRWait-Signature așa cum arată documentația API, de exemplu într-un pas de cod.
• Dă unei chei doar accesul de care are nevoie și revoc-o din ecranul Integrări când nu mai e folosită; ecranul arată când a fost folosită ultima dată fiecare cheie.