Návod na webhooky pro Zapier a Make

1. Co potřebujete

Účet QR Wait, jehož jste vlastníkem (správci a obsluha integrace nevidí), účet Zapier nebo Make a v jiné záložce otevřenou obrazovku Integrace v administraci.

2. Zapier

1. V Zapieru vytvořte Zap s triggerem Webhooks by Zapier a událostí Catch Hook. Zkopírujte adresu URL webhooku, kterou Zapier zobrazí.
2. V QR Wait ji v sekci Integrace vložte do pole Adresa koncového bodu (https), zaškrtněte požadované události a stiskněte Přidat webhook. Podpisový tajný klíč, který se zobrazí jen jednou, si uschovejte.
3. Jednou se zařaďte do své fronty z telefonu nebo někoho přidejte v panelu obsluhy, aby dorazila skutečná událost ticket.joined. Poslat testovací událost odešle jen ping bez polí lístku: ukáže, že adresa odpovídá.
4. Zpět v Zapieru otestujte trigger a vyberte tuto událost. Přidejte akci, například Google Sheets › Create Spreadsheet Row, a namapujte pole: type, queue.name, ticket.no, ticket.size, ticket.joined_at.
5. Zap publikujte. Od této chvíle každá událost přidá řádek.

3. Make

1. V Make vytvořte scénář, jehož prvním modulem je Webhooks › Custom webhook. Přidejte webhook a zkopírujte jeho adresu.
2. Vložte ji v QR Wait do sekce Integrace jako výše a stiskněte Přidat webhook.
3. Make čeká, až pozná strukturu dat: jednou se zařaďte do své fronty nebo někoho přidejte v panelu obsluhy.
4. Přidejte další modul, například Google Sheets › Add a Row nebo zprávu do svého chatu, namapujte pole a scénář zapněte.

4. Co dorazí

Každá událost je tělo JSON, jako je toto. V QR Wait zaškrtněte jen události, které potřebujete, nebo v Zapieru či Make filtrujte podle 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" }
}

Jména, odpovědi z formuláře pro zařazení a rezervační kódy se odesílají pouze tehdy, když pro danou adresu zaškrtnete Zahrnout jména, odpovědi z formuláře a rezervační kódy. Bez toho události obsahují pouze čísla a časy.

Neúspěšné doručení se po dobu přibližně 9 hodin opakuje se stejným id. Pokud by vám duplikát vadil, zkontrolujte jej před přidáním řádku (krok vyhledání).

5. Opačný směr: přidávání lidí ze Zapieru nebo Make

Aby mohl jiný nástroj zařazovat lidi do fronty (formulář na webu, rezervační nástroj), vytvořte v sekci Klíče API klíč s přístupem Čtení a zápis a odešlete požadavek z Webhooks by Zapier › POST nebo z modulu Make 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" }

Odpovědí je nové číslo, například { "no": 43 }. ID front získáte z GET /api/v1/queues. Vyvolání další skupiny, označení jako obsloužené a všechna pole najdete v referenční dokumentaci API (anglicky).

6. Bezpečnost

• Adresa, kterou vám Zapier nebo Make poskytne, stačí k odesílání dat do vašeho Zapu nebo scénáře: nesdílejte ji.
• Zapier a Make samy podpis QR Wait nekontrolují. Pokud musí mít přijímající strana jistotu, že událost pochází z QR Wait, ověřte hlavičku X-QRWait-Signature podle referenční dokumentace API, například v kroku s kódem.
• Klíči dejte jen ten přístup, který potřebuje, a jakmile se přestane používat, odvolejte jej na obrazovce Integrace; obrazovka ukazuje, kdy byl každý klíč naposledy použit.