Zapier- és Make-útmutató webhookokhoz

1. Amire szükséged van

Egy QR Wait-fiók, amelynek tulajdonosa vagy (a vezetők és a munkatársak nem látják az integrációkat), egy Zapier- vagy Make-fiók, valamint az adminfelület Integrációk képernyője egy másik lapon megnyitva.

2. Zapier

1. A Zapierben hozz létre egy Zapet, amelynek eseményindítója a Webhooks by Zapier, eseménye pedig a Catch Hook. Másold ki a Zapier által megjelenített webhook URL-t.
2. A QR Waitben az Integrációk alatt illeszd be a Végpont címe (https) mezőbe, jelöld be a kívánt eseményeket, és nyomd meg a Webhook hozzáadása gombot. Őrizd meg az egyszer megjelenő aláírási titkot.
3. Állj be egyszer a sorodba egy telefonról, vagy vegyél fel valakit a személyzeti panelen, hogy egy valódi ticket.joined esemény érkezzen. A Tesztesemény küldése csak egy sorszámmezők nélküli ping eseményt küld: azt mutatja meg, hogy a cím válaszol.
4. A Zapierben teszteld az eseményindítót, és válaszd ki ezt az eseményt. Adj hozzá egy műveletet, például Google Sheets › Create Spreadsheet Row, és rendeld hozzá a mezőket: type, queue.name, ticket.no, ticket.size, ticket.joined_at.
5. Tedd közzé a Zapet. Mostantól minden esemény új sort ad a táblázathoz.

3. Make

1. A Make-ben hozz létre egy forgatókönyvet (scenario), amelynek első modulja a Webhooks › Custom webhook. Adj hozzá egy webhookot, és másold ki a címét.
2. Illeszd be a QR Wait Integrációk képernyőjén a fent leírt módon, és nyomd meg a Webhook hozzáadása gombot.
3. A Make megvárja, hogy megismerje az adatok szerkezetét: állj be egyszer a sorodba, vagy vegyél fel valakit a személyzeti panelen.
4. Add hozzá a következő modult, például Google Sheets › Add a Row vagy egy üzenetet a csevegődbe, rendeld hozzá a mezőket, és kapcsold be a forgatókönyvet.

4. Mi érkezik

Minden esemény egy ehhez hasonló JSON-törzs. A QR Waitben csak a szükséges eseményeket jelöld be, vagy szűrj a type mezőre a Zapierben vagy a Make-ben.

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

A nevek, az űrlapválaszok és a foglalási kódok csak akkor érkeznek meg, ha az adott címnél bejelölöd a Nevek, űrlapválaszok és foglalási kódok küldése lehetőséget. Enélkül az események csak sorszámokat és időpontokat tartalmaznak.

A sikertelen kézbesítést a rendszer körülbelül 9 órán át újrapróbálja, ugyanazzal az id értékkel. Ha egy ismétlődés gondot okozna, a sor hozzáadása előtt ellenőrizd (egy keresési lépéssel).

5. Fordítva: emberek felvétele a Zapierből vagy a Make-ből

Ha azt szeretnéd, hogy egy másik eszköz (egy weboldali űrlap, egy foglalási rendszer) vegyen fel embereket a sorba, hozz létre egy kulcsot az API-kulcsok alatt Olvasás és írás hozzáféréssel, és küldj kérést a Webhooks by Zapier › POST vagy a Make HTTP › Make a request moduljával:

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

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

A válasz az új sorszám, például { "no": 43 }. A sorok azonosítóit a GET /api/v1/queues adja meg. A következő csoport behívása, a kiszolgáltnak jelölés és az összes mező az API-referenciában található (angol nyelvű).

6. Biztonsági tudnivalók

• A Zapiertől vagy a Make-től kapott cím elég ahhoz, hogy adatot küldjenek a Zapedbe vagy a forgatókönyvedbe: ne oszd meg.
• A Zapier és a Make magától nem ellenőrzi a QR Wait aláírását. Ha a fogadó oldalnak biztosnak kell lennie abban, hogy egy esemény a QR Waittől jött, ellenőrizd az X-QRWait-Signature fejlécet az API-referenciában leírt módon, például egy kódlépésben.
• Egy kulcsnak csak annyi hozzáférést adj, amennyire szüksége van, és ha már nem használod, vond vissza az Integrációk képernyőn; a képernyő mutatja, mikor használták utoljára az egyes kulcsokat.