Wie nutze ich Webhooks in pixx.io?

ℹ️

Verfügbar ab dem Tarif Team. Dieser Artikel richtet sich an Administratoren.

📄

Kurzfassung: Webhooks benachrichtigen externe Systeme automatisch, sobald in pixx.io ein bestimmtes Ereignis eintritt – etwa eine neue Datei oder ein gelöschter Kommentar. pixx.io sendet dabei eine POST-Anfrage an eine von dir hinterlegte URL, anstatt dass dein System ständig selbst nachfragen muss, ob sich etwas geändert hat.

Wo richte ich Webhooks ein?

Unter "Einstellungen → Webhooks" siehst du alle bestehenden Webhooks (Name und Ziel-URL) und legst über "Neuer Webhook" einen neuen an.

Welche Angaben braucht ein Webhook?

Name: frei wählbar, nur zur eigenen Orientierung in der Liste.

URL (Pflichtfeld): die Adresse, an die pixx.io die POST-Anfrage schickt – z. B. die Webhook-Adresse eines Make-Szenarios.

Secret (Pflichtfeld, nur Buchstaben und Zahlen): dient der Signaturprüfung auf Empfängerseite, damit das empfangende System echte pixx.io-Anfragen von gefälschten unterscheiden kann.

Beschreibung (optional): Freitext, z. B. Zweck des Webhooks.

Webhook Events: die Ereignisse, bei denen der Webhook ausgelöst wird.

Ereignisse auswählen

Die Ereignisse sind nach Themenbereich gruppiert (55 Kategorien mit insgesamt 781 Einzelereignissen, u. a. zu Dateien, Kollektionen, Kommentaren, DirectLinks, Nutzern, Portalen, Lizenzen, Metadatenfeldern und Synonymen). Jede Kategorie lässt sich aufklappen und enthält einzelne, konkrete Ereignisse – die Kategorie "comment" zum Beispiel die Ereignisse "commentCreated" und "commentDeleted". Du kannst entweder eine ganze Kategorie oder nur einzelne Ereignisse daraus auswählen; eine ausgefüllte Minus-Markierung an der Kategorie-Checkbox zeigt eine Teilauswahl an.

💡

Praxistipp: Abonniere so granular wie möglich. Wer z. B. gleich die gesamte Kategorie "Datei"-Ereignisse abonniert, bekommt bei jeder kleinen Änderung an einer Datei (Dateiname, Bewertung, einzelnes Metadatenfeld …) einen eigenen Request – das erzeugt unnötige Last auf deinem Endpunkt. Gezielt einzelne Ereignisse auszuwählen spart Traffic und vereinfacht die Auswertung beim Empfänger.

ℹ️

Beachte: Die Kommentar-Webhooks ("commentCreated"/"commentDeleted") liefern nur die ID der Datei und des Kommentars, nicht den Kommentartext selbst. Um den vollständigen Text zu erhalten, brauchst du zusätzlich einen API-Aufruf, der die Kommentar-ID nachlädt.

Mit welchen Tools lassen sich Webhooks empfangen?

Ein Webhook allein liefert nur Informationen – die eigentliche Automatisierung entsteht erst im Zusammenspiel mit einem Empfänger:

Automatisierungsplattformen ohne eigenen Server: Für Make.com stellt pixx.io eine eigene App mit vorgefertigten Modulen bereit (Details im Artikel pixx.io mit Make.com verbinden und automatisieren). Auch der generische "Custom Webhook"-Trigger von Make funktioniert direkt mit der pixx.io-Webhook-URL. Plattformen wie Zapier oder n8n bieten ebenfalls einen generischen Webhook-Trigger mit eigener URL, die sich 1:1 in das URL-Feld des pixx.io-Webhooks eintragen lässt.

Eigenes Skript/Backend: Wer lieber selbst entwickelt, verarbeitet die eingehende POST-Anfrage direkt in einem eigenen PHP-/Node-/Python-Skript und ruft bei Bedarf die pixx.io-API zurück, um z. B. Metadaten zu schreiben oder einen Kommentar anzulegen.

💡

Praxistipp: Ein häufiger Anwendungsfall ist die automatische Nachbearbeitung neuer Dateien: Der Webhook "fileCreated" löst einen externen KI-Dienst aus, der Alt-Text oder Schlagworte generiert; das Ergebnis wird anschließend per API-Aufruf zurück in die Custom-Metadaten oder Schlagworte geschrieben.

💡

Praxistipp: Die vollständige, durchsuchbare Liste aller 781 Ereignisse inklusive CSV-Download findest du im pixx.io Developer Hub.

Wo richte ich Webhooks ein?

Welche Angaben braucht ein Webhook?

Ereignisse auswählen

Mit welchen Tools lassen sich Webhooks empfangen?

Verwandte Artikel