1. Trigger anlegen
- Klicke Create → Zaps und wähle beim Trigger die App Webhooks by Zapier.
- Trigger event: Catch Raw Hook → Continue. Nur Catch Raw Hook liefert den unveränderten Body und die Header – mit Catch Hook ist keine Signaturprüfung möglich.
- Im Reiter Test zeigt Zapier die Webhook-Adresse (
https://hooks.zapier.com/hooks/catch/…/…/). Kopiere sie mit Copy.
2. Kanal in QuickTribe anlegen und testen
- Einstellungen → Integrationen → Kanal hinzufügen → Webhook (JSON), Adresse eintragen, Ereignisse wählen, Speichern und den Signaturschlüssel kopieren.
- Klicke in QuickTribe auf Testnachricht senden und danach in Zapier auf Test trigger. Es erscheinen Felder wie Raw Body und die Header, voraussichtlich als Headers Http X Quicktribe Signature, Headers Http X Quicktribe Event und Headers Http X Quicktribe Delivery – die genauen Namen siehst du nach dem Test.
3. Signatur prüfen mit Code by Zapier
Füge einen Schritt Code by Zapier hinzu, Event: Run JavaScript oder Run Python. Unter Input Data ordnest du zu:raw = Raw Body, signature = Headers Http X Quicktribe Signature, delivery = Headers Http X Quicktribe Delivery. Dann den Code einfügen und mit Test step prüfen.
crypto bzw. hmac und hashlib gehören dazu. Der Schlüssel steht im Code und ist für alle sichtbar, die den Zap bearbeiten dürfen.
Zapier sagt nicht ausdrücklich zu, dass Raw Body bytegenau im Code-Schritt ankommt. Schlägt die Prüfung trotz richtigem Schlüssel fehl, prüfe das zuerst mit einer Testnachricht.
4. Filtern und weiterverarbeiten
- Schritt Filter by Zapier → Only continue if… → Feld valid → (Boolean) Is true.
- Danach die eigentlichen Aktionen mit den Feldern aus dem Code-Schritt, z. B. Slack → Send Channel Message oder Google Sheets → Create Spreadsheet Row mit
event,title,textundlinkUrl. - Den Zap veröffentlichen bzw. einschalten (je nach Editor Publish oder Schalter On).
Gut zu wissen
- Zapier antwortet immer mit 200. Ist der Zap aus oder gelöscht, antwortet die Adresse mit 404 – das kann laut Zapier einige Stunden dauern. QuickTribe pausiert den Kanal dann; nach dem Einschalten in QuickTribe Fortsetzen.
- Catch Raw Hook nimmt Bodys bis 2 MB an; QuickTribe-Nachrichten sind höchstens 64 KB groß.
- Bei hoher Last kann Zapier mit 200 antworten und trotzdem erst Minuten später verarbeiten.