Integrationen: Zapier, Make & n8n
OOHLEMON an Ihre bestehenden Tools anbinden — Webhooks empfangen, Signaturen prüfen, per API steuern. Alles ohne eigenen Server.
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
- Trigger: Webhooks by Zapier → Catch Raw Hook, URL aus Zapier in OOHLEMON eintragen
- Signatur: Code by Zapier (JavaScript) mit dem Snippet oben
- Aktion: Webhooks by Zapier → Custom Request auf die REST-API, Bearer-Token als Header
- Test: In OOHLEMON „Beispiel-Event senden” — die Antwort erscheint direkt im Editor
Make
- Trigger: Webhooks → Custom Webhook, URL in OOHLEMON eintragen
- Signatur: Filter mit
sha256(t + "." + body; "hex"; secret) - 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.
Playlist-Änderung → Google-Sheets-Log
Jede Änderung an einer Playlist landet als Zeile in einer Tabelle — lückenlose Dokumentation, wer wann was ausgespielt hat.
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) — 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