Integrationen: Zapier, Make & n8n

OOHLEMON an Ihre bestehenden Tools anbinden — Webhooks empfangen, Signaturen prüfen, per API steuern. Alles ohne eigenen Server.

Zur Dokumentation

Es gibt zwei Richtungen: OOHLEMON informiert Sie (Webhooks) und Sie steuern OOHLEMON (REST-API). Zapier, Make und n8n verbinden beides zu Automatisierungen — ganz ohne Programmierung.

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.

1Webhook-Endpunkt anlegen

Im Dashboard unter Integrationen → Webhooks erstellen Sie einen Endpunkt: URL eintragen, Event-Typen auswählen (oder * für alle). Sie erhalten ein Secret — das brauchen Sie für die Signaturprüfung. Ein Test-Ping prüft die Verbindung sofort.

Berechtigt sind Team-Owner und Admins. Endpunkte gelten für Ihr Team bzw. Ihr persönliches Konto.

2Signatur prüfen (wichtig!)

Jede Zustellung trägt den Header OOHLEMON-Signature im Format t=<unix>,v1=<hex>. So prüfen Sie sie:

// Node.js — Signatur prüfen
c
o
n
s
t
 
c
r
y
p
t
o
 
=
 
r
e
q
u
i
r
e
(
'
c
r
y
p
t
o
'
)
;




f
u
n
c
t
i
o
n
 
v
e
r
i
f
y
S
i
g
n
a
t
u
r
e
(
r
a
w
B
o
d
y
,
 
s
i
g
n
a
t
u
r
e
H
e
a
d
e
r
,
 
s
e
c
r
e
t
)
 
{


 
 
c
o
n
s
t
 
p
a
r
t
s
 
=
 
O
b
j
e
c
t
.
f
r
o
m
E
n
t
r
i
e
s
(


 
 
 
 
s
i
g
n
a
t
u
r
e
H
e
a
d
e
r
.
s
p
l
i
t
(
'
,
'
)
.
m
a
p
(
p
 
=
>
 
p
.
s
p
l
i
t
(
'
=
'
)
)


 
 
)
;


 
 
c
o
n
s
t
 
t
i
m
e
s
t
a
m
p
 
=
 
N
u
m
b
e
r
(
p
a
r
t
s
.
t
)
;


 
 
c
o
n
s
t
 
e
x
p
e
c
t
e
d
 
=
 
c
r
y
p
t
o


 
 
 
 
.
c
r
e
a
t
e
H
m
a
c
(
'
s
h
a
2
5
6
'
,
 
s
e
c
r
e
t
)


 
 
 
 
.
u
p
d
a
t
e
(
`
$
{
p
a
r
t
s
.
t
}
.
$
{
r
a
w
B
o
d
y
}
`
)


 
 
 
 
.
d
i
g
e
s
t
(
'
h
e
x
'
)
;




 
 
/
/
 
5
-
m
i
n
u
t
e
 
t
o
l
e
r
a
n
c
e


 
 
i
f
 
(
M
a
t
h
.
a
b
s
(
D
a
t
e
.
n
o
w
(
)
 
/
 
1
0
0
0
 
-
 
t
i
m
e
s
t
a
m
p
)
 
>
 
3
0
0
)
 
r
e
t
u
r
n
 
f
a
l
s
e
;


 
 
/
/
 
T
i
m
i
n
g
-
s
a
f
e
 
c
o
m
p
a
r
e


 
 
r
e
t
u
r
n
 
c
r
y
p
t
o
.
t
i
m
i
n
g
S
a
f
e
E
q
u
a
l
(
B
u
f
f
e
r
.
f
r
o
m
(
e
x
p
e
c
t
e
d
)
,
 
B
u
f
f
e
r
.
f
r
o
m
(
p
a
r
t
s
.
v
1
)
)
;


}

Wichtig: Prüfen Sie immer den rohen Body, nicht das geparste JSON — sonst stimmt die Signatur nicht. Bei Zapier nutzen Sie dafür einen „Catch Raw Hook”, bei Make bearbeiten Sie den Body als Text, in n8n liefert der Webhook-Node den Raw-Body als Binary.

3Plattform wählen

Zapier

  1. Trigger: Webhooks by Zapier → Catch Raw Hook, URL aus Zapier in OOHLEMON eintragen
  2. Signatur: Code by Zapier (JavaScript) mit dem Snippet oben
  3. Aktion: Webhooks by Zapier → Custom Request auf die REST-API, Bearer-Token als Header
  4. Test: In OOHLEMON „Beispiel-Event senden” — die Antwort erscheint direkt im Editor

Make

  1. Trigger: Webhooks → Custom Webhook, URL in OOHLEMON eintragen
  2. Signatur: Filter mit sha256(t + "." + body; "hex"; secret)
  3. Aktion: HTTP → Make a request auf die REST-API

n8n

Ein importierbarer Beispiel-Workflow liegt im Dashboard bereit (Integrationen → Apps): Notiz, Webhook, Code-Node „Verify signature“ und ein HTTP-Request gegen /api/v1/me. Per Strg+V in einen leeren Workflow einfügen — alle Nodes erscheinen.

Der Code-Node prüft die Signatur timing-sicher, lässt nur konfigurierte Event-Typen durch und beendet Pings still. Ideal für Self-Hosting.

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 — lückenlose Dokumentation, wer wann was ausgespielt hat.

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) — das n8n-Beispielszenario nutzt deshalb eine veröffentlichte Webseiten-Tabelle plus reload_playlist. Ehrlich dokumentiert, damit Sie nicht auf etwas bauen, das nicht existiert.

Lieber gleich im Dashboard?

Alle Integrations-Tabs (Webhooks, API-Schlüssel, Zapier/Make/n8n-Rezepte mit Copy-Buttons) finden Sie unter Integrationen.

Zu den Integrationen