Integrationen: Zapier, Make & n8n
OOHLEMON an Ihre bestehenden Tools anbinden — Webhooks empfangen, Signaturen prüfen, per API steuern. Ganz ohne eigenen Server: Copy & Paste genügt.
Es gibt zwei Richtungen: OOHLEMON informiert Sie (Webhooks) und Sie steuern OOHLEMON (REST-API). Zapier, Make und n8n verbinden beides zu Automatisierungen — ohne eigenen Server, mit kopierfertigem Code für die Signaturprüfung.
Bevor Sie starten
- Die API und Webhooks sind Teil des Pro-Pakets (in der 14-tägigen Testphase vollständig nutzbar).
- Webhook-Endpunkte anlegen darf nur, wer das Team besitzt oder Admin ist.
- Für Steuerung über die API brauchen Sie einen Schlüssel mit dem Recht „Lesen + Schreiben” (nur Lesen reicht für reine Auswertungen).
- Datenschutz: Zustellung erfolgt mindestens einmal und ohne garantierte Reihenfolge — deduplizieren Sie über die Event-ID. Ziele außerhalb der EU (z. B. Zapier) sind Datenübermittlungen in Drittländer; wer das vermeiden will, fährt mit self-hosted n8n.
Trigger: Webhooks
OOHLEMON schickt bei Ereignissen eine signierte HTTP-Anfrage an Ihre URL. In Zapier/Make/n8n fangen Sie diese ab und starten damit den Workflow.
Aktion: REST-API
Umgekehrt rufen Sie die API auf: Displays auflisten, Playlist neu laden, Player neu starten. Mit Bearer-Schlüssel.
Schritt für Schritt — je Plattform
Zapier
1Zap starten, wenn bei OOHLEMON etwas passiert
- In Zapier einen neuen Zap anlegen. Als Trigger „Webhooks by Zapier” mit dem Event „Catch Hook” wählen und die angezeigte URL kopieren.
- Im Dashboard unter Integrationen → Webhooks einen Endpunkt mit dieser URL anlegen und die gewünschten Events auswählen. Der Endpunkt bekommt automatisch das Zapier-Badge.
- Das Secret (ool_whsec_…) sicher ablegen — Sie brauchen es für die Signaturprüfung.
- In Zapier „Test trigger” klicken, dann im Dashboard „Beispiel-Event senden”.
2Signatur in Zapier prüfen (optional, empfohlen)
- Statt „Catch Hook” das Event „Catch Raw Hook” verwenden — es liefert den unveränderten Body und die Header.
- Als zweiten Schritt „Code by Zapier” → „Run JavaScript” einfügen und unter Input Data drei Felder anlegen: body (Raw Body), signature (Header OOHLEMON-Signature) und secret (Ihr ool_whsec_…). Dann den Code einfügen.
- Danach „Filter by Zapier”: nur weiter, wenn valid wahr ist. Die geprüften Felder (type, object_id, object_name) stehen den folgenden Schritten zur Verfügung.
Code by Zapier — Run JavaScript
const crypto = require('crypto');
const body = inputData.body; // raw body (Catch Raw Hook)
const header = inputData.signature || ''; // OOHLEMON-Signature header
const secret = inputData.secret; // ool_whsec_…
const parts = header.split(',').map((p) => p.trim().split('='));
const t = (parts.find(([k]) => k === 't') || [])[1];
const signatures = parts.filter(([k]) => k === 'v1').map(([, v]) => v);
const expected = crypto.createHmac('sha256', secret).update(`${t}.${body}`).digest('hex');
const fresh = Math.abs(Date.now() / 1000 - Number(t)) <= 300;
const matches = signatures.some((sig) =>
sig.length === expected.length &&
crypto.timingSafeEqual(Buffer.from(sig), Buffer.from(expected)));
const valid = Boolean(t) && fresh && matches;
const event = valid ? JSON.parse(body) : null;
output = {
valid,
type: event ? event.type : null,
test: event ? event.test === true : null,
object_id: event ? event.data.object.id : null,
object_name: event ? event.data.object.name : null,
};3OOHLEMON aus einem Zap steuern
- Im Dashboard-Tab „API-Schlüssel” einen Schlüssel mit dem Recht „Lesen + Schreiben” erstellen. Er wird nur einmal angezeigt.
- Im Zap die Aktion „Webhooks by Zapier” → „Custom Request” wählen.
- Methode und URL aus den API-Beispielen in der API-Referenz übernehmen. Unter Headers: Authorization mit dem Wert Bearer + Schlüssel, Content-Type mit application/json.
- Den JSON-Body unter Data eintragen und Felder aus dem Trigger einsetzen. Mit „Test step” prüfen.
Make
1Make-Szenario starten, wenn bei OOHLEMON etwas passiert
- In Make ein neues Szenario anlegen und das Modul „Webhooks” → „Custom webhook” hinzufügen. Mit „Add” einen Webhook anlegen und die URL kopieren.
- Im Dashboard unter Integrationen → Webhooks einen Endpunkt mit dieser URL anlegen und die Events auswählen. Der Endpunkt bekommt automatisch das Make-Badge.
- Im Webhook-Modul „Redetermine data structure” starten (bzw. das Szenario mit „Run once”) und im Dashboard ein Beispiel-Event senden. Make übernimmt die Struktur.
- Weitere Module anhängen und die Felder zuordnen.
2Signatur in Make prüfen (optional)
- Im Webhook unter den erweiterten Einstellungen „Get request headers” und „JSON pass-through” aktivieren. Dann liegt der unveränderte Body im Feld value.
- Die Signatur mit Variablen und einem Filter vergleichen wie im Snippet. Erst danach den Body mit „JSON → Parse JSON” in Felder zerlegen.
Make — Variablen und Filter
// 1) Tools > Set variable "sig"
{{first(map(1.headers; "value"; "name"; "oohlemon-signature"))}}
// 2) Tools > Set multiple variables
t = {{replace(first(split(sig; ",")); "t="; "")}}
v1 = {{replace(last(split(sig; ",")); "v1="; "")}}
// 3) Filter (Text operators: Equal to)
{{sha256(t.1.value; "hex"; "ool_whsec_…")}} = {{v1}}
// t.1.value = pill "t", a literal ".", pill "1.value"
// 4) JSON > Parse JSON
{{1.value}}3OOHLEMON aus einem Make-Szenario steuern
- Im Dashboard-Tab „API-Schlüssel” einen Schlüssel mit dem Recht „Lesen + Schreiben” erstellen.
- Das Modul „HTTP” → „Make a request” hinzufügen.
- URL und Methode aus den API-Beispielen in der API-Referenz eintragen. Unter Headers: Authorization mit Bearer + Schlüssel.
- Body type „Raw”, Content type „JSON (application/json)” wählen und den JSON-Body eintragen. „Parse response” aktivieren.
n8n
1n8n-Workflow starten, wenn bei OOHLEMON etwas passiert
- In n8n einen Workflow mit dem Node „Webhook” anlegen: HTTP Method POST, Path frei wählbar (z. B. oohlemon-media-ready), Respond „Immediately”. Unter Options „Raw Body” einschalten, falls Sie die Signatur prüfen.
- Workflow speichern und aktivieren. Die Production-URL aus dem Webhook-Node kopieren — die Test-URL (webhook-test) funktioniert nur, solange n8n auf ein Test-Event wartet.
- Im Dashboard unter Integrationen → Webhooks einen Endpunkt mit der Production-URL anlegen und die Events auswählen.
- Zum Testen im Dashboard ein Beispiel-Event senden.
2Signatur in n8n prüfen (empfohlen)
- Im Webhook-Node unter Options „Raw Body” aktivieren. Dann liegt der unveränderte Body als Binärfeld data vor.
- Direkt danach einen Node „Code” (JavaScript, „Run Once for All Items”) einfügen und das Snippet einsetzen. Secret und Event-Typ in den beiden TODO-Zeilen eintragen.
- Selbst gehostetes n8n erlaubt das Modul crypto erst mit der Umgebungsvariable NODE_FUNCTION_ALLOW_BUILTIN=crypto.
n8n — Code-Node (Run Once for All Items)
// OOHLEMON webhook: verify signature (t=...,v1=..., HMAC-SHA256, 5 min tolerance)
// Mode: Run Once for All Items. Self-hosted n8n needs NODE_FUNCTION_ALLOW_BUILTIN=crypto.
const SECRET = 'ool_whsec_TODO'; // TODO: webhook secret from OOHLEMON (Settings > Integrations > Webhooks)
const ONLY_TYPE = 'media.ready'; // TODO: event type to pass on, or null for all events
const TOLERANCE_SECONDS = 300;
const crypto = require('crypto');
const item = $input.first();
const header = item.json.headers['oohlemon-signature'] || '';
let raw;
try {
raw = (await this.helpers.getBinaryDataBuffer(0, 'data')).toString('utf8');
} catch (error) {
throw new Error('Raw body missing: enable the option "Raw Body" in the Webhook node.');
}
const parts = header.split(',').map((part) => part.trim().split('='));
const t = (parts.find(([key]) => key === 't') || [])[1];
const signatures = parts.filter(([key]) => key === 'v1').map(([, value]) => value);
const expected = crypto.createHmac('sha256', SECRET).update(`${t}.${raw}`).digest('hex');
const fresh = Math.abs(Date.now() / 1000 - Number(t)) <= TOLERANCE_SECONDS;
const matches = signatures.some((sig) =>
sig.length === expected.length &&
crypto.timingSafeEqual(Buffer.from(sig), Buffer.from(expected)));
if (!t || !fresh || !matches) throw new Error('Invalid OOHLEMON signature');
const event = JSON.parse(raw);
// ping (connection check) and other types stop here without an error
if (event.type === 'ping' || (ONLY_TYPE && event.type !== ONLY_TYPE)) return [];3OOHLEMON aus einem n8n-Workflow steuern
- Im Dashboard-Tab „API-Schlüssel” einen Schlüssel erstellen (für Display-Befehle mit dem Recht „Lesen + Schreiben”).
- In n8n unter Credentials „Header Auth” anlegen: Name Authorization, Value Bearer + Schlüssel. So steht der Schlüssel nicht im Workflow.
- Einen Node „HTTP Request” hinzufügen, Authentication „Generic Credential Type” → „Header Auth”. Mit „Import cURL” lassen sich die API-Beispiele direkt übernehmen.
- IDs aus dem Trigger als Ausdruck einsetzen und mit „Test step” prüfen.
Extra bequem: Im Dashboard (Integrationen → Apps) liegt ein importierbarer Beispiel-Workflow bereit — per Strg+V in einen leeren n8n-Workflow einfügen, alle Nodes erscheinen.
Drei Rezepte zum Start
Neues Medium → Slack-Nachricht
Sobald ein Video oder Bild fertig verarbeitet ist, informiert ein Slack-Bot das Team. Kein manuelles Nachfragen mehr, ob der neue Clip schon online ist.
Playlist-Änderung → Google-Sheets-Log
Jede Änderung an einer Playlist landet als Zeile in einer Tabelle — ein Änderungsprotokoll: welche Playlist, welche Medien hinzugekommen oder entfernt sind, welche Displays betroffen sind.
Zeitplan-Update → E-Mail an Filialleitung
Wenn sich der Zeitplan für einen Standort ändert, bekommt die Filiale automatisch eine Info — ohne dass jemand im Dashboard nachsehen muss.
Was heute geht — und was nicht
Geht: Displays lesen und ändern, Player-Befehle senden, Medien/Playlists/Zeitpläne/Kampagnen lesen, Webhooks empfangen.
Noch nicht: Medien per API anlegen (Coming soon) — ein n8n-Beispielszenario nutzt deshalb eine veröffentlichte Webseiten-Tabelle plus reload_playlist. Ehrlich dokumentiert, damit Sie nicht auf etwas bauen, das nicht existiert.
Wenn etwas nicht klappt
- „Signatur ungültig”: Wird der rohe Body geprüft (nicht das geparste JSON)? Stimmt das Secret? Ist der Header-Vergleich exakt „t=…,v1=…”?
- Zustellung erfolgt mindestens einmal, die Reihenfolge ist nicht garantiert — deduplizieren Sie in Ihrem Workflow über die Event-ID (sonst z. B. doppelte Slack-Posts).
- Ein Endpunkt wird nach 3 Tagen ohne erfolgreiche Zustellung automatisch deaktiviert — im Dashboard wieder aktivieren.
- Im Zustell-Log unter Integrationen → Webhooks sehen Sie jede Zustellung und können per Klick erneut senden.
Lieber gleich im Dashboard?
Alle Integrations-Tabs (Webhooks, API-Schlüssel, Zapier/Make/n8n-Rezepte mit Copy-Buttons) finden Sie unter Integrationen.