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.

Zur Dokumentation

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

  1. In Zapier einen neuen Zap anlegen. Als Trigger „Webhooks by Zapier” mit dem Event „Catch Hook” wählen und die angezeigte URL kopieren.
  2. 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.
  3. Das Secret (ool_whsec_…) sicher ablegen — Sie brauchen es für die Signaturprüfung.
  4. In Zapier „Test trigger” klicken, dann im Dashboard „Beispiel-Event senden”.

2Signatur in Zapier prüfen (optional, empfohlen)

  1. Statt „Catch Hook” das Event „Catch Raw Hook” verwenden — es liefert den unveränderten Body und die Header.
  2. 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.
  3. 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

  1. Im Dashboard-Tab „API-Schlüssel” einen Schlüssel mit dem Recht „Lesen + Schreiben” erstellen. Er wird nur einmal angezeigt.
  2. Im Zap die Aktion „Webhooks by Zapier” → „Custom Request” wählen.
  3. 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.
  4. Den JSON-Body unter Data eintragen und Felder aus dem Trigger einsetzen. Mit „Test step” prüfen.

API-Referenz mit allen Beispielen

Make

1Make-Szenario starten, wenn bei OOHLEMON etwas passiert

  1. In Make ein neues Szenario anlegen und das Modul „Webhooks” → „Custom webhook” hinzufügen. Mit „Add” einen Webhook anlegen und die URL kopieren.
  2. Im Dashboard unter Integrationen → Webhooks einen Endpunkt mit dieser URL anlegen und die Events auswählen. Der Endpunkt bekommt automatisch das Make-Badge.
  3. Im Webhook-Modul „Redetermine data structure” starten (bzw. das Szenario mit „Run once”) und im Dashboard ein Beispiel-Event senden. Make übernimmt die Struktur.
  4. Weitere Module anhängen und die Felder zuordnen.

2Signatur in Make prüfen (optional)

  1. Im Webhook unter den erweiterten Einstellungen „Get request headers” und „JSON pass-through” aktivieren. Dann liegt der unveränderte Body im Feld value.
  2. 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

  1. Im Dashboard-Tab „API-Schlüssel” einen Schlüssel mit dem Recht „Lesen + Schreiben” erstellen.
  2. Das Modul „HTTP” → „Make a request” hinzufügen.
  3. URL und Methode aus den API-Beispielen in der API-Referenz eintragen. Unter Headers: Authorization mit Bearer + Schlüssel.
  4. Body type „Raw”, Content type „JSON (application/json)” wählen und den JSON-Body eintragen. „Parse response” aktivieren.

API-Referenz mit allen Beispielen

n8n

1n8n-Workflow starten, wenn bei OOHLEMON etwas passiert

  1. 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.
  2. 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.
  3. Im Dashboard unter Integrationen → Webhooks einen Endpunkt mit der Production-URL anlegen und die Events auswählen.
  4. Zum Testen im Dashboard ein Beispiel-Event senden.

2Signatur in n8n prüfen (empfohlen)

  1. Im Webhook-Node unter Options „Raw Body” aktivieren. Dann liegt der unveränderte Body als Binärfeld data vor.
  2. 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.
  3. 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

  1. Im Dashboard-Tab „API-Schlüssel” einen Schlüssel erstellen (für Display-Befehle mit dem Recht „Lesen + Schreiben”).
  2. In n8n unter Credentials „Header Auth” anlegen: Name Authorization, Value Bearer + Schlüssel. So steht der Schlüssel nicht im Workflow.
  3. Einen Node „HTTP Request” hinzufügen, Authentication „Generic Credential Type” → „Header Auth”. Mit „Import cURL” lassen sich die API-Beispiele direkt übernehmen.
  4. 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.

API-Referenz mit allen Beispielen

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.

Trigger → media.readyAktion → Slack: Nachricht senden

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.

Trigger → playlist.updatedAktion → Google Sheets: Zeile anhängen

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.

Trigger → schedule.updatedAktion → E-Mail senden

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.