Webhook-Rezept für Zapier und Make

1. Was Sie brauchen

Ein QR-Wait-Konto, dessen Inhaber Sie sind (Manager und Personal sehen die Integrationen nicht), ein Zapier- oder Make-Konto und den Bildschirm Integrationen der Admin-Seite in einem anderen Tab.

2. Zapier

1. Legen Sie in Zapier einen Zap an mit Webhooks by Zapier als Trigger und Catch Hook als Ereignis. Kopieren Sie die Webhook-URL, die Zapier anzeigt.
2. Fügen Sie sie in QR Wait unter Integrationen in Adresse des Endpunkts (https) ein, wählen Sie die gewünschten Ereignisse und klicken Sie auf Webhook hinzufügen. Bewahren Sie das Signatur-Geheimnis auf, das nur einmal angezeigt wird.
3. Stellen Sie sich einmal mit einem Handy in Ihre Warteschlange oder fügen Sie im Bedienpanel jemanden hinzu, damit ein echtes ticket.joined-Ereignis ankommt. Testereignis senden schickt nur ein ping ohne Ticketfelder: Es zeigt, dass die Adresse antwortet.
4. Testen Sie in Zapier den Trigger und wählen Sie dieses Ereignis. Fügen Sie eine Aktion hinzu, zum Beispiel Google Sheets › Create Spreadsheet Row, und ordnen Sie die Felder zu: type, queue.name, ticket.no, ticket.size, ticket.joined_at.
5. Veröffentlichen Sie den Zap. Ab jetzt fügt jedes Ereignis eine Zeile hinzu.

3. Make

1. Legen Sie in Make ein Szenario an, dessen erstes Modul Webhooks › Custom webhook ist. Fügen Sie einen Webhook hinzu und kopieren Sie seine Adresse.
2. Fügen Sie sie wie oben in QR Wait unter Integrationen ein und klicken Sie auf Webhook hinzufügen.
3. Make wartet, um die Struktur der Daten zu lernen: Stellen Sie sich einmal in Ihre Warteschlange oder fügen Sie im Bedienpanel jemanden hinzu.
4. Fügen Sie das nächste Modul hinzu, zum Beispiel Google Sheets › Add a Row oder eine Nachricht in Ihren Chat, ordnen Sie die Felder zu und schalten Sie das Szenario ein.

4. Was ankommt

Jedes Ereignis ist ein JSON-Body wie dieser. Wählen Sie in QR Wait nur die Ereignisse, die Sie brauchen, oder filtern Sie in Zapier oder Make nach 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" }
}

Namen, Antworten im Anmeldeformular und Buchungscodes werden nur gesendet, wenn Sie für diese Adresse Namen, Antworten im Anmeldeformular und Buchungscodes mitsenden ankreuzen. Ohne das enthalten Ereignisse nur Nummern und Zeiten.

Eine fehlgeschlagene Zustellung wird etwa 9 Stunden lang mit derselben id wiederholt. Prüfen Sie sie vor dem Anlegen einer Zeile (mit einem Suchschritt), wenn ein Duplikat stören würde.

5. Andersherum: Personen aus Zapier oder Make hinzufügen

Damit ein anderes Werkzeug Personen in eine Warteschlange stellt (ein Formular auf Ihrer Website, ein Buchungstool), erstellen Sie unter API-Schlüssel einen Schlüssel mit Zugriff Lesen und Schreiben und senden Sie eine Anfrage aus Webhooks by Zapier › POST oder dem Make-Modul 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" }

Die Antwort ist die neue Nummer, etwa { "no": 43 }. Die IDs der Warteschlangen liefert GET /api/v1/queues. Den Nächsten aufrufen, jemanden als bedient markieren und alle Felder stehen in der API-Referenz (auf Englisch).

6. Sicher aufbewahren

• Die Adresse, die Zapier oder Make Ihnen gibt, genügt, um Daten in Ihren Zap oder Ihr Szenario zu schicken: Geben Sie sie nicht weiter.
• Zapier und Make prüfen die Signatur von QR Wait nicht von selbst. Muss die Empfängerseite sicher sein, dass ein Ereignis von QR Wait kommt, prüfen Sie den Header X-QRWait-Signature wie in der API-Referenz gezeigt, etwa in einem Code-Schritt.
• Geben Sie einem Schlüssel nur den Zugriff, den er braucht, und widerrufen Sie ihn auf dem Bildschirm Integrationen, sobald er nicht mehr genutzt wird; dort steht, wann jeder Schlüssel zuletzt verwendet wurde.