Webhook-Integration

Integrationsübersicht

Diese Integration ermöglicht es Ihnen, einen Webhook-Endpunkt einzurichten, um Echtzeitdaten von Pushwoosh zu erhalten, insbesondere E-Mail-Statusereignisse, wie z. B. E-Mail gesendet, E-Mail zugestellt, E-Mail zurückgewiesen, E-Mail geöffnet usw.

Art der Integration

Quelle: Daten werden von Pushwoosh über den Webhook an Ihr System gesendet.

Glossar

Webhook-Endpunkt: Eine serverseitige URL, die HTTP-POST-Anfragen von Pushwoosh empfängt. Clients können den genauen Port angeben.

Beispiel ohne Port: https://clientdomainname.com/webhook_endpoint
Beispiel mit angegebenem Port: https://clientdomainname.com:8081/webhook_endpoint

Synchronisierte Entitäten

E-Mail-Statusereignisse, die Daten über Benutzerinteraktionen mit den von Ihnen gesendeten Nachrichten liefern.

Einrichten der Integration

So richten Sie die Integration ein:

Gehen Sie in Ihrem Pushwoosh-Konto zu Einstellungen > Drittanbieter-Integrationen und suchen Sie die Webhook-Integration. Klicken Sie auf Konfigurieren.

Geben Sie im sich öffnenden Fenster die vollständige URL des Webhook-Endpunkts ein und klicken Sie auf Anwenden.

Nach erfolgreicher Konfiguration erhalten Sie Anfragen von Pushwoosh.

So überprüfen Sie, ob die Integration funktioniert

Sobald die Integration eingerichtet ist, erhalten Sie HTTP-POST-Anfragen von Pushwoosh an den angegebenen Webhook-Endpunkt.

Webhook-Request-Body

Feldname	Typ	Erforderlich	Beschreibung	Beispiel
event_name	string	Ja	Der Name des Ereignisses	`"Email Sent"`
message_id	uint64	Nein	Die eindeutige ID der mit dem Ereignis verknüpften Nachricht.	`200XXXX3258`
message_code	string	Ja	Der Code der mit dem Ereignis verknüpften Nachricht.	`"B780-XXXXXX3C-XXXX0375"`
campaign_id	uint64	Nein	Die eindeutige ID der mit dem Ereignis verknüpften Kampagne.	`96XXXX`
platform	string	Ja	Die mit dem Ereignis verknüpfte Geräteplattform (z. B. iOS, Android, E-Mail).	`"Email"`
application_code	string	Ja	Der Code der mit dem Ereignis verknüpften Anwendung.	`"3XXXX-XXXX1"`
hwid	string	Ja	Die Gerätekennung (HWID), die mit dem Ereignis verknüpft ist.	`"example@gmail.com"`
user_id	string	Ja	Die Pushwoosh-Benutzer-ID, die mit dem Ereignis verknüpft ist.	`"15XXXX8"`
payload	string	Nein	Der Inhalt der Nachricht hängt von der Plattform ab. Bei E-Mail-Ereignissen enthält dies den E-Mail-Betreff. Bei anderen Plattformen kann dies unterschiedliche relevante Inhalte enthalten, die für das Ereignis spezifisch sind (z. B. Nachrichteninhalt oder Titel).	`"Don't miss our summer sale!"`
timestamp	int64	Ja	Die Zeit, zu der das Ereignis aufgetreten ist, im UNIX-Zeitstempelformat.	`1723798222`
journey_title	string	Nein	Der Titel der mit dem Ereignis verknüpften Journey.	`"Summer sale"`
journey_point_title	string	Nein	Der Titel des spezifischen Punkts innerhalb der Journey, der mit dem Ereignis verknüpft ist.	`"5_summer sale_new"`

Anfragebeispiel

{
  "event_name": "Email Sent",
  "message_code": "B780-XXXXXX3C-XXXX0375",
  "campaign_id": 96XXXX,
  "platform": "Email",
  "payload": "Don't miss our summer sale!",
  "application_code": "3XXXX-XXXX1",
  "hwid": "example@gmail.com",
  "user_id": "15XXXX8",
  "timestamp": 1723798222,
  "journey_title": "Summer sale",
  "journey_point_title": "5_summer sale_promoemail"
}