Fügen Sie Webhooks zu Ihrem Projekt hinzu, um Ereignisse zu Bewertungen und Nachrichten zu empfangen.
Webhooks benachrichtigen Ihre Systeme, wenn etwas in Ihrem Projekt passiert – zum Beispiel, wenn ein Kunde eine Bewertung hinterlässt oder wenn eine Nachricht gesendet wird. Sie geben eine URL an, und die Plattform sendet die relevanten Daten an diese URL, sobald das Ereignis eintritt. Dies ermöglicht es Ihnen, Bewertungen und Nachrichten mit Ihren eigenen Tools, Dashboards oder Workflows zu synchronisieren.
Wo Sie Webhooks finden
Gehen Sie in der Seitenleiste zu Einstellungen und klicken Sie dann auf API. Scrollen Sie zum Abschnitt Webhooks. Dort können Sie eine oder mehrere Webhook-URLs hinzufügen. Jeder Webhook empfängt alle Ereignisse für Ihr Projekt, es sei denn, Sie filtern nach Ereignistyp.
Einen Webhook hinzufügen
- Scrollen Sie unter Einstellungen > API zum Abschnitt Webhooks.
- Klicken Sie auf Webhook erstellen (oder Hinzufügen, wenn Sie bereits Webhooks haben).
- Geben Sie die vollständige URL ein, unter der Sie Ereignisse empfangen möchten. Sie muss mit https:// beginnen.
- Klicken Sie auf Erstellen.
Ihr Webhook ist sofort aktiv. Sie können ihn jederzeit mit dem Schalter neben seiner URL ein- oder ausschalten. Wenn ein Webhook ausgeschaltet ist, werden keine Ereignisse an diese URL gesendet.
Ereignistypen
Jeder Webhook sendet eine Benachrichtigung, wenn eines dieser Ereignisse eintritt:
| Ereignis | Wann es ausgelöst wird |
|---|---|
| review-created | Ein Kunde reicht eine Bewertung oder Rezension ein (einschließlich, wenn er zum ersten Mal auf einen Bewertungslink klickt). |
| review-updated | Eine bestehende Bewertung wird aktualisiert (zum Beispiel fügt der Kunde Feedback hinzu oder bearbeitet es). |
| review-deleted | Eine Bewertung wird entfernt. |
| message-created | Eine Nachricht zur Bewertungsanfrage wird erstellt oder geplant. |
| message-updated | Eine Nachricht wird aktualisiert (zum Beispiel, wenn sie gesendet oder zugestellt wird). |
| message-deleted | Eine Nachricht wird entfernt oder abgebrochen. |
Bewertungsereignisse: Erstellt vs. Aktualisiert
Eine Bewertung wird erstellt, sobald ein Kunde auf einen Bewertungslink in einer E-Mail oder SMS klickt. Wenn er auf Ihrer Bewertungsseite landet, ist die Bewertung bereits gespeichert – noch bevor er Text eingibt oder das Formular absendet. Wenn er dann Feedback oder eine geschriebene Bewertung im Formular hinzufügt, löst diese Aktualisierung ein zweites Ereignis aus.
Für einen einzigen Kundenbesuch können Sie also Folgendes erhalten:
- review-created – Wenn er auf den Bewertungslink klickt und die Seite geladen wird.
- review-updated – Wenn er das Formular mit zusätzlichem Feedback oder Text absendet.
Wenn Sie nur wissen müssen, wann ein Kunde seine vollständige Bewertung (einschließlich Text) abgeschlossen hat, verwenden Sie das Ereignis review-updated. Das Ereignis review-created wird ausgelöst, wenn nur die Sternebewertung erfasst wird.
Was Ihr Endpunkt empfängt
Jede Benachrichtigung enthält den Ereignistyp und die vollständigen Daten für diese Bewertung oder Nachricht. Ihr Endpunkt empfängt die Daten in einem Standardformat und sollte schnell antworten, um den Empfang zu bestätigen. Wenn Ihr Endpunkt nicht erfolgreich antwortet, versucht die Plattform es einige Male erneut. Nach mehreren fehlgeschlagenen Versuchen kann der Webhook automatisch ausgeschaltet werden, um wiederholte Fehler zu vermeiden.
Webhooks sind eine kostenpflichtige Funktion. Wenn Sie die Option zum Hinzufügen von Webhooks nicht sehen, müssen Sie möglicherweise Ihren Tarif upgraden.
Webhooks verwalten
- Ausschalten – Verwenden Sie den Schalter neben einem Webhook, um ihn zu pausieren. Während er ausgeschaltet ist, werden keine Ereignisse gesendet. Schalten Sie ihn wieder ein, wenn Sie bereit sind.
- Bearbeiten – Ändern Sie die URL oder wählen Sie, welche Ereignistypen empfangen werden sollen. Standardmäßig empfängt ein Webhook alle Ereignisse. Beim Bearbeiten können Sie Ereignisse abwählen, die Sie nicht benötigen, sodass nur die relevanten gesendet werden.
- Löschen – Entfernen Sie einen Webhook aus dem Aktionsmenü, wenn Sie ihn nicht mehr benötigen.