Przepis na webhooki w Zapier i Make

1. Czego potrzebujesz

Konta QR Wait, którego jesteś właścicielem (menedżerowie i obsługa nie widzą integracji), konta Zapier lub Make oraz ekranu Integracje strony administracyjnej otwartego w innej karcie.

2. Zapier

1. W Zapier utwórz Zap z wyzwalaczem Webhooks by Zapier i zdarzeniem Catch Hook. Skopiuj adres webhooka, który pokaże Zapier.
2. W QR Wait w sekcji Integracje wklej go w pole Adres odbiorcy (https), zaznacz potrzebne zdarzenia i kliknij Dodaj webhook. Zachowaj sekret podpisu, który jest pokazywany tylko raz.
3. Dołącz raz do swojej kolejki z telefonu albo dodaj kogoś w panelu obsługi, aby przyszło prawdziwe zdarzenie ticket.joined. Wyślij zdarzenie testowe wysyła tylko ping bez pól biletu: pokazuje jedynie, że adres odpowiada.
4. Wróć do Zapier, przetestuj wyzwalacz i wybierz to zdarzenie. Dodaj akcję, na przykład Google Sheets › Create Spreadsheet Row, i przypisz pola: type, queue.name, ticket.no, ticket.size, ticket.joined_at.
5. Opublikuj Zap. Od teraz każde zdarzenie dodaje wiersz.

3. Make

1. W Make utwórz scenariusz, którego pierwszym modułem jest Webhooks › Custom webhook. Dodaj webhook i skopiuj jego adres.
2. Wklej go jak wyżej na ekranie Integracje w QR Wait i kliknij Dodaj webhook.
3. Make czeka, aby poznać strukturę danych: dołącz raz do swojej kolejki albo dodaj kogoś w panelu obsługi.
4. Dodaj kolejny moduł, na przykład Google Sheets › Add a Row albo wiadomość na czacie, przypisz pola i włącz scenariusz.

4. Co przychodzi

Każde zdarzenie to treść JSON taka jak ta. Zaznacz w QR Wait tylko potrzebne zdarzenia albo filtruj po type w Zapier lub 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" }
}

Imiona, odpowiedzi z formularza i kody rezerwacji są wysyłane tylko wtedy, gdy dla tego adresu zaznaczysz Dołączaj imiona, odpowiedzi z formularza dołączenia i kody rezerwacji. Bez tego zdarzenia zawierają tylko numery i godziny.

Nieudane doręczenie jest ponawiane przez około 9 godzin z tym samym id. Sprawdź je przed dodaniem wiersza (krokiem wyszukiwania), jeśli duplikat byłby problemem.

5. W drugą stronę: dodawanie osób z Zapier lub Make

Aby inne narzędzie dodawało osoby do kolejki (formularz na stronie, system rezerwacji), utwórz w sekcji Klucze API klucz z dostępem Odczyt i zapis i wyślij żądanie z Webhooks by Zapier › POST lub z modułu 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" }

Odpowiedzią jest nowy numer, na przykład { "no": 43 }. Identyfikatory kolejek zwraca GET /api/v1/queues. Wzywanie następnej grupy, oznaczanie obsłużonych i wszystkie pola opisuje dokumentacja API (po angielsku).

6. Bezpieczeństwo

• Adres od Zapier lub Make wystarczy, by wysyłać dane do Twojego Zapa lub scenariusza: nie udostępniaj go.
• Zapier i Make same nie sprawdzają podpisu QR Wait. Jeśli strona odbierająca musi mieć pewność, że zdarzenie pochodzi z QR Wait, sprawdzaj nagłówek X-QRWait-Signature tak, jak pokazuje dokumentacja API, na przykład w kroku z kodem.
• Dawaj kluczowi tylko taki dostęp, jakiego potrzebuje, i unieważniaj go na ekranie Integracje, gdy przestanie być używany; widać tam, kiedy każdy klucz był ostatnio użyty.