1. Custom webhook anlegen
- Lege ein neues Szenario an, klicke auf das große Plus und wähle Webhooks → Custom webhook.
- Klicke neben Webhook auf Add und gib einen Webhook name ein, z. B. „QuickTribe Team“.
- Unter Show advanced settings:
- Get request headers: Yes – nur dann kommen die Signatur-Header im Szenario an (als Liste
__IMTHEADERS__mitnameundvalue). - JSON pass-through: Yes – der Body wird als Text weitergereicht statt in Felder zerlegt. Das braucht die Signaturprüfung.
- Optional API Key authentication: Make prüft dann den Header
x-make-apikey(siehe Alternative).
- Get request headers: Yes – nur dann kommen die Signatur-Header im Szenario an (als Liste
- Save. Make zeigt die Adresse an (
https://hook.<region>.make.com/<id>); kopiere sie mit Copy address to clipboard.
2. Kanal in QuickTribe anlegen und Testnachricht senden
- Einstellungen → Integrationen → Kanal hinzufügen → Webhook (JSON), Adresse eintragen, Ereignisse wählen, Speichern und den Signaturschlüssel kopieren.
- Der Make-Webhook wartet nach dem Anlegen auf die erste Nachricht. Klicke in QuickTribe auf Testnachricht senden – Make bestimmt daraus die Datenstruktur. Später lässt sie sich im Modul neu bestimmen (je nach Make-Version Redetermine data structure bzw. Detect new values).
3. Signatur prüfen
Make kann HMAC-SHA256 mit der Funktionsha256(text; "hex"; schlüssel) berechnen. Aufbau: Custom webhook (1) → Tools → Set multiple variables (2) → Filter → JSON → Parse JSON (3) → Weiterverarbeitung.
Im Modul Set multiple variables:
In einem zweiten Set variable-Modul (Variablen desselben Moduls sind dort noch nicht verfügbar) berechnest du
expected = sha256( Feld t . Feld value aus Modul 1 ; "hex"; "DEIN_SIGNATURSCHLUESSEL"). In Make wird Text einfach aneinandergereiht: erst das Feld t, dann ein Punkt, dann der Body-Text.
Den Filter vor Parse JSON setzt du so (alle Bedingungen mit UND):
expected– Text operators: Equal to –v1{{parseNumber(now) - parseNumber(t)}}– Numeric operators: Less than or equal to –300{{parseNumber(t) - parseNumber(now)}}– Numeric operators: Less than or equal to –300
event, title, fields, data und link zuordenbar werden.
Make sagt nicht zu, dass der weitergereichte Body-Text bytegenau dem Original entspricht, und hat keinen Vergleich in konstanter Zeit. Prüfe mit Run once und einer Testnachricht, ob
expected und v1 übereinstimmen. Den Namen des Body-Felds (oft value) siehst du im Ausgabebündel des ersten Laufs. Klappt die Prüfung nicht, nutze die Alternative unten.map() exakt; Make liefert sie in der Regel kleingeschrieben – im ersten Bündel nachsehen. Schreibe Header nie als 1.headers.x-quicktribe-signature (Make liest das als Rechnung), sondern immer über map(…).
Alternative: API-Schlüssel statt Signatur
- Schalte im Custom webhook API Key authentication ein und kopiere den Schlüssel.
- Trage in QuickTribe beim Kanal unter Zusätzlicher Header (optional) den Header-Name
x-make-apikeyund als Header-Wert diesen Schlüssel ein.
4. Szenario einschalten
- Mit Run once und einer Testnachricht aus QuickTribe testen – Make verarbeitet dabei genau eine Nachricht.
- Unter den Zeitplan-Einstellungen Immediately as data arrives wählen (bei Webhook-Triggern Standard).
- Das Szenario mit dem Schalter ON einschalten.
Beispiel-Weiterverarbeitung
Hinter Parse JSON z. B. ein Router mit Filtern aufevent: member.joined → Google Sheets → Add a row; payment.failed → Email → Send an email an die Buchhaltung mit title, text und link.url.
Gut zu wissen
- Make nimmt höchstens 300 Anfragen in 10 Sekunden an; darüber antwortet es mit 429 – QuickTribe wiederholt dann später.
- Ein Webhook, der über 5 Tage keinem Szenario zugeordnet ist, wird deaktiviert und antwortet mit 410 – QuickTribe pausiert den Kanal. Nach dem erneuten Zuordnen in QuickTribe Fortsetzen.
- Ist das Szenario ausgeschaltet, sammelt Make eingehende Nachrichten in einer Warteschlange; beim Einschalten fragt Make, ob sie verarbeitet werden sollen.