Webhook-Antworten - E-Mail-Kampagnen & Kontakte

Was ist ein Webhook?

 

Webhooks sind Anfragen, die beim Eintreten eines Ereignisses an eine URL gesendet werden. Bei den Ereignissen kann es sich um einen Hardbounce, das Öffnen einer E-Mail, das Löschen eines Kontakts usw. handeln.

 

Wenn ein Ereignis oder eine Statusänderung eintritt, wird in Echtzeit eine HTTP POST-Message an die jeweilige URL gesendet, die Informationen zu dem Ereignis enthält.

 

Webhook-Antworten

 

Antworten werden im JSON-Format gesendet und mit POST an die angegebene URL weitergeleitet.

 

Nachstehend finden Sie eine Liste der verschiedenen Webhook-Ereignisse mit den erwarteten Antworten.

 

 

Hinweis

 

ts_sent, ts_event Zeitzone UTC
date_sent, date_event Lokale Zeitzone
date Zeitzone CET/CEST

 

Als Spam markiert

 

BEZEICHNUNG TYP BESCHREIBUNG
event string "spam"
email string Empfänger-E-Mail-Adresse
ID integer Interne Webhook-ID
date_sent string Versanddatum der Kampagne (Jahr-Monat-Tag, Stunde:Minute:Sekunde)
date_event string Eintrittsdatum des Ereignisses (Jahr-Monat-Tag, Stunde:Minute:Sekunde)
ts_sent integer Zeitstempel des Kampagnenversands in Sekunden
ts_event integer Zeitstempel des Ereigniseintritts in Sekunden
camp_id integer Interne Kampagnen-ID
campaign name string Interner Kampagnenname
reason string Spam-Grund
ts integer Zeitstempel der Generierung des Webhook-Calls in Sekunden
tag string Internes Kampagnen-Tag

 

Beispiel-Antwort

 

{"id":139911,"camp_id":253,"email":"abc@example.com","campaign name":"Campaign ABC","date_sent":"2019-07-30 08:00:51","date_event":"2019-07-30 08:00:51","event":"spam","tag":"abc","reason":"lorem ipsum","ts_sent":1564466451,"ts_event":1564466451,"ts":1564466452}

 

Geöffnet

 

BEZEICHNUNG TYP BESCHREIBUNG
event string "opened"
email string Empfänger-E-Mail-Adresse
ID integer Interne Webhook-ID
date_sent string Versanddatum der Kampagne (Jahr-Monat-Tag, Stunde:Minute:Sekunde)
date_event string Eintrittsdatum des Ereignisses (Jahr-Monat-Tag, Stunde:Minute:Sekunde)
ts_sent integer Zeitstempel des Kampagnenversands in Sekunden
ts_event integer Zeitstempel des Ereigniseintritts in Sekunden
camp_id integer Interne Kampagnen-ID
campaign name string Interner Kampagnenname
tag string Internes Kampagnen-Tag
ts integer Zeitstempel der Generierung des Webhook-Calls in Sekunden

 

Beispiel-Antwort

 

{"id":139911,"camp_id":253,"email":"abc@example.com","campaign name":"Campaign ABC","date_sent":"2019-07-30 11:30:50","date_event":"2019-07-30 11:39:15","event":"opened","tag":"abc","ts_sent":1564479050,"ts_event":1564479555,"ts":1564466956} 

 

Angeklickt

 

BEZEICHNUNG TYP BESCHREIBUNG
event string "clicked"
email string Empfänger-E-Mail-Adresse
ID integer Interne Webhook-ID
date_sent string Versanddatum der Kampagne (Jahr-Monat-Tag, Stunde:Minute:Sekunde)
date_event string Eintrittsdatum des Ereignisses (Jahr-Monat-Tag, Stunde:Minute:Sekunde)
ts_sent integer Zeitstempel des Kampagnenversands in Sekunden
ts_event integer Zeitstempel des Ereigniseintritts in Sekunden
camp_id integer Interne Kampagnen-ID
campaign name string Interner Kampagnenname
tag string Internes Kampagnen-Tag
ts integer Zeitstempel der Generierung des Webhook-Calls in Sekunden
URL string Angeklickte URL

 

Beispiel-Antwort

 

{"id":139911,"camp_id":253,"email":"abc@example.com","campaign name":"Campaign ABC","date_sent":"2019-07-30 11:30:50","date_event":"2019-07-30 11:39:15","event":"clicked","tag":"abc","ts_sent":1564479050,"ts_event":1564479555,"URL":"https://example.com","ts":1564466956} 

 

Hardbounce

 

BEZEICHNUNG TYP BESCHREIBUNG
event string "hard_bounce"
email string Empfänger-E-Mail-Adresse
ID integer Interne Webhook-ID
date_sent string Versanddatum der Kampagne (Jahr-Monat-Tag, Stunde:Minute:Sekunde)
date_event string Eintrittsdatum des Ereignisses (Jahr-Monat-Tag, Stunde:Minute:Sekunde)
ts_sent integer Zeitstempel des Kampagnenversands in Sekunden
ts_event integer Zeitstempel des Ereigniseintritts in Sekunden
camp_id integer Interne Kampagnen-ID
campaign name string Interner Kampagnenname
sending_ip string Zum Versand der Nachricht verwendete IP-Adresse
reason string Grund für den Hardbounce
ts integer Zeitstempel der Generierung des Webhook-Calls in Sekunden
tag string Internes Kampagnen-Tag

 

Beispiel-Antwort

 

{"id":139911,"camp_id":253,"email":"abc@example.com","campaign name":"Campaign ABC","date_sent":"2019-07-30 08:00:51","date_event":"2019-07-30 08:00:51","event":"hard_bounce","tag":"abc","reason":"lorem ipsum","ts_sent":1564466451,"ts_event":1564466451,"sending_ip":"111.11.11.1","ts":1564466452} 

 

Softbounce

 

BEZEICHNUNG TYP BESCHREIBUNG
event string "soft_bounce"
email string Empfänger-E-Mail-Adresse
ID integer Interne Webhook-ID
date_sent string Versanddatum der Kampagne (Jahr-Monat-Tag, Stunde:Minute:Sekunde)
date_event string Eintrittsdatum des Ereignisses (Jahr-Monat-Tag, Stunde:Minute:Sekunde)
ts_sent integer Zeitstempel des Kampagnenversands in Sekunden
ts_event integer Zeitstempel des Ereigniseintritts in Sekunden
camp_id integer Interne Kampagnen-ID
campaign name string Interner Kampagnenname
reason string Grund für den Softbounce
sending_ip string Zum Versand der Nachricht verwendete IP-Adresse
ts integer Zeitstempel der Generierung des Webhook-Calls in Sekunden
tag string Internes Kampagnen-Tag

 

Beispiel-Antwort

 

{"id":139911,"camp_id":253,"email":"abc@example.com","campaign name":"Campaign ABC","date_sent":"2019-07-30 08:00:51","date_event":"2019-07-30 08:00:51","event":"soft_bounce","tag":"abc","reason":"lorem ipsum","ts_sent":1564466451,"ts_event":1564466451,"sending_ip":"111.11.11.1","ts":1564466452}

 

Zugestellt

 

BEZEICHNUNG TYP BESCHREIBUNG
event string "delivered"
email string Empfänger-E-Mail-Adresse
ID integer Interne Webhook-ID
date_sent string Versanddatum der Kampagne (Jahr-Monat-Tag, Stunde:Minute:Sekunde)
date_event string Eintrittsdatum des Ereignisses (Jahr-Monat-Tag, Stunde:Minute:Sekunde)
ts_sent integer Zeitstempel des Kampagnenversands in Sekunden
ts_event integer Zeitstempel des Ereigniseintritts in Sekunden
sending_ip string Zum Versand der Nachricht verwendete IP-Adresse
camp_id integer Interne Kampagnen-ID
campaign name string Interner Kampagnenname
ts integer Zeitstempel der Generierung des Webhook-Calls in Sekunden
tag string Internes Kampagnen-Tag

 

Beispiel-Antwort

 

{"id":139911,"camp_id":253,"email":"abc@example.com","campaign name":"Campaign ABC","date_sent":"2019-07-30 08:00:51","date_event":"2019-07-30 08:00:51","event":"delivered","tag":"abc","ts_sent":1564466451,"ts_event":1564466451,"sending_ip":"111.11.11.1","ts":1564466452}

 

Abgemeldet

 

BEZEICHNUNG TYP BESCHREIBUNG
event string "unsubscribe"
email string Empfänger-E-Mail-Adresse
ID integer Interne Webhook-ID
date_sent string Versanddatum der Kampagne (Jahr-Monat-Tag, Stunde:Minute:Sekunde)
date_event string Eintrittsdatum des Ereignisses (Jahr-Monat-Tag, Stunde:Minute:Sekunde)
ts_sent integer Zeitstempel des Kampagnenversands in Sekunden
ts_event integer Zeitstempel des Ereigniseintritts in Sekunden
camp_id integer Interne Kampagnen-ID
campaign name string Interner Kampagnenname
list_id array of integers Die ID(s) der internen Liste(n), von der oder denen der Empfänger abgemeldet wurde
ts integer Zeitstempel der Generierung des Webhook-Calls in Sekunden
tag string Internes Kampagnen-Tag

 

Beispiel-Antwort

 

{"id":139911,"camp_id":253,"email":"abc@example.com","campaign name":"Campaign ABC","date_sent":"2019-07-30 11:30:50","date_event":"2019-07-30 11:39:15","event":"unsubscribe","tag":"abc","list_id":[63,61],"ts_sent":1564479050,"ts_event":1564479555,"ts":1564466956} 

 

Kontakt zu einer Liste hinzugefügt

 

BEZEICHNUNG TYP BESCHREIBUNG
event string "list_addition"
email string E-Mail-Adresse des hinzugefügten Empfängers
ID integer Interne Webhook-ID
key string Interner Key
list_id array of integers Die ID(s) der internen Liste(n), von der oder denen der Empfänger abgemeldet wurde
date string Eintrittsdatum des Ereignisses (Jahr-Monat-Tag, Stunde:Minute:Sekunde)
ts integer Zeitstempel der Generierung des Webhook-Calls in Sekunden

 

Beispiel-Antwort

 

{"id":139911,"email":"lu.sykora@demo.domain","event":"list_addition","key":"fsn920nfsv6h0gfkkqrb5","list_id":[63,61],"date":"2019-07-30 08:48:11","ts":1564469292}

 

Kontakt aktualisiert

 

BEZEICHNUNG TYP BESCHREIBUNG
event string "contact_updated"
email string E-Mail-Adresse des hinzugefügten Empfängers
ID integer Interne Webhook-ID
key string Interner Key
date string Eintrittsdatum des Ereignisses (Jahr-Monat-Tag, Stunde:Minute:Sekunde)
ts integer Zeitstempel der Generierung des Webhook-Calls in Sekunden
content array of strings Vollständige aktualisierte Kontaktdaten

 

Beispiel-Antwort

 

{"id":139911,"event":"contact_updated","key":"fsn920nfsv6h0gfkkqrb5","date":"2019-07-30 08:52:02","ts":1564469523,"content":[{"email":"lu.sykora@demo.domain","attributes":{"FIRSTNAME":"Luke","LASTNAME":"Sykora","SMS":"30764261246","SHOPIFY_LAST_30_DAYS_CA":0,"SHOPIFY_ORDER_TOTAL":0,"SHOPIFY_CA_USER":0}}]}

 

Kontakt gelöscht

 

BEZEICHNUNG TYP BESCHREIBUNG
event string "contact_deleted"
email string E-Mail-Adresse des entfernten Empfängers
ID integer Interne Webhook-ID
key string Interner Key
date string Eintrittsdatum des Ereignisses (Jahr-Monat-Tag, Stunde:Minute:Sekunde)
ts integer Zeitstempel der Generierung des Webhook-Calls in Sekunden

 

Beispiel-Antwort

 

{"id":139911,"email":["lu.sykora@demo.domain"],"event":"contact_deleted","key":"fsn920nfsv6h0gfkkqrb5","date":"2019-07-30 08:53:17","ts":1564469598}