Webhooks und Zapier — Proyex mit externen Diensten verbinden

Geschrieben von Miro Flemke

Zuletzt aktualisiert Vor etwa 1 Monat

Was sind Webhooks?

Webhooks ermöglichen es, Proyex mit externen Diensten wie Zapier, Make oder eigenen Systemen zu verbinden. Wenn in Proyex ein bestimmtes Ereignis eintritt (z. B. eine Aufgabe wird erstellt), sendet Proyex automatisch eine Benachrichtigung an die von dir hinterlegte URL.

So funktioniert es

  1. Erstelle einen Webhook über die API mit der gewünschten Ziel-URL und dem Ereignis.

  2. Proyex sendet bei jedem Eintreten des Ereignisses eine HTTP-Anfrage mit den relevanten Daten an deine URL.

  3. Dein externer Dienst (z. B. Zapier) empfängt die Daten und führt die gewünschte Aktion aus.

Verfügbare Ereignisse

Aufgaben

  • Aufgabe erstellt — Wird ausgelöst, wenn eine neue Aufgabe angelegt wird

  • Aufgabe aktualisiert — Bei Änderungen an einer bestehenden Aufgabe

  • Aufgabe erledigt — Wenn eine Aufgabe auf „erledigt" gesetzt wird. Feuert nur beim Wechsel, nicht bei späteren Änderungen an einer bereits erledigten Aufgabe

  • Aufgabe gelöscht — Wenn eine Aufgabe entfernt wird

  • Aufgabe zugewiesen — Wenn eine Aufgabe einem Teammitglied zugewiesen wird

Meilensteine

  • Meilenstein abgeschlossen — Wenn ein Meilenstein als erledigt markiert wird

Projekte

  • Projekt abgeschlossen — Wenn alle Aufgaben eines Projekts erledigt sind

Kundenfreigaben

  • Revision freigegeben — Wenn eine Revision für den Kunden sichtbar geschaltet wird

  • Revision beantwortet — Wenn der Kunde eine Revision annimmt oder ablehnt

Dateien

  • Datei hochgeladen — Wenn eine Datei zu einem Projekt oder einer Aufgabe hinzugefügt wird

CRM

  • Deal — erstellt, aktualisiert, Stufe geändert, gewonnen, verloren, in Projekt umgewandelt, gelöscht

  • Unternehmen — erstellt, aktualisiert, gelöscht

  • Kontakt — erstellt, aktualisiert, gelöscht

  • Aktivität — erstellt, abgeschlossen

Verfügbare Events programmatisch abrufen

Statt die Event-Liste fest in deinen Code zu schreiben, kannst du sie zur Laufzeit abrufen: GET /api/v1/hooks/events liefert die vollständige Liste aller subscribierbaren Events zurück. So wirst du automatisch über neue Events informiert, sobald sie verfügbar werden.

Sicherheit

Jeder Webhook wird mit einem geheimen Schlüssel signiert. Damit kann der empfangende Dienst sicherstellen, dass die Anfrage tatsächlich von Proyex stammt.

Protokollierung

Jede Zustellung wird protokolliert. Du kannst nachvollziehen:

  • Ob die Zustellung erfolgreich war oder fehlgeschlagen ist

  • Die Antwort des empfangenden Dienstes

  • Die Anzahl der Versuche (bei Fehlern wird automatisch erneut versucht)

Zapier-Integration

Für die Verbindung mit Zapier nutze die Webhook-URL, die Zapier dir bereitstellt. Richte in Proyex einen Webhook mit dieser URL und dem gewünschten Ereignis ein. In Zapier kannst du dann die empfangenen Daten in beliebigen Aktionen weiterverwenden.

Berechtigungen

Webhooks erfordern einen API-Zugang, der ab dem Professional-Plan verfügbar ist.

Häufige Fragen

Wie viele Webhooks kann ich erstellen?

Es gibt kein Limit — erstelle für jedes Ereignis und jede Ziel-URL einen eigenen Webhook.

Was passiert bei fehlerhafter Zustellung?

Proyex versucht die Zustellung automatisch erneut. Du siehst den Status und eventuelle Fehler im Protokoll.

Kann ich Webhooks vorübergehend deaktivieren?

Ja, Webhooks können aktiviert und deaktiviert werden, ohne sie löschen zu müssen.

Tipps & Hinweise

  • Teste neue Webhooks zuerst mit einem Dienst wie webhook.site, um die Datenstruktur zu prüfen.

  • Nutze die Protokollierung, um Fehler bei der Integration schnell zu finden.

  • Kombiniere Webhooks mit Zapier oder Make, um komplexe Automationen über mehrere Tools hinweg zu erstellen.