Was sind die verschiedenen Webhook-Formate?
Unterstützte Ereignisse: Derzeit unterstützen wir Webhook für eine Reihe von Ereignissen, die da wären:
| Event | Description |
| Sent | Message has been sent successfully |
| Dropped | Message got dropped |
| Bounced | Message has hard bounce |
| Opened | Message got opened |
| Clicked | Recipient clicked a link in the message; will only occur when click tracking is enabled |
| Unsubscribed | Recipient Unsubscribed |
| Invalid | Syntactically incorrect email ids |
| Abuse | Recipient marked the message as spam |
Warum kann meine Webhook- oder Rückruf-URL nicht verifiziert werden?
Wenn Sie die URL hinzufügen, führt Netcore Email API einen HTTP(s) POST-Test durch.
Wenn die Daten POST erfolgreich von Ihrem Server akzeptiert wurden, überprüft und speichert Netcore Email API die Webhook-URL
Ereignisdaten
Nachfolgend finden Sie die Beispieldaten für jedes Ereignis, die Ihnen die tatsächlichen Felder zeigen, die in den HTTP(s) POST zurückgegeben wurden:
Glossar
| Parameters Used | Supported by Events | Description |
| TRANSID | All | All assigns a Unique Transaction ID for each and every email which were sent |
| All | Recipient’s Email ID | |
| EVENT | All | Type of Event: sent/ dropped/ invalid/ bounced/ opened/ clicked/ unsubscribed/ abuse |
| RESPONSE | sent/ dropped/invalid/ bounce | Response received from the end server like Delivery Logs, Bounce reason, reason for drop(blacklisted user / already unsubscribed) |
| X-APIHEADER | All | Information passed by you in the X-APIHEADER, during the time of email sent |
| TIMESTAMP | All | Unix Timestamp of the occurrence of the event |
| USERAGENT | opened/ clicked/ unsubscribed/abuse | User agent contains the detailed information about the browser from where a specific event in initiated. |
| IPADDRESS | opened/ clicked/unsubscribed/abuse | IP address of the device from where the recipient has responded. |
Gesendet
Die E-Mail wurde erfolgreich an den Empfangsserver übermittelt:
Beispiel für gesendete Webhook-Daten
Ein Beispiel für das vollständige JSON, das an die Webhook-URL gesendet wird, ist
[
{
"TRANSID":"14652378013752608",
"RCPTID":"0",
"RESPONSE":"smtp;250 2.0.0 OK 1465276276 mo3si31128106wjb.147 – gsmtp",
"EMAIL":"[email protected]",
"TIMESTAMP":"1465276276",
"CLIENTID":"10001",
"FROMADDRESS":"[email protected]",
"EVENT":"sent",
"MSIZE":"1216"
}
]
Fallengelassen
Benutzer, die sich bereits in der Vergangenheit abgemeldet haben oder aufgrund von Hard Bounce/Spam-Beschwerden auf die schwarze Liste gesetzt wurden, werden als abgemeldet behandelt. Für diese Arten von IDs ist keine weitere E-Mail-Kommunikation erlaubt.
[
{
“TRANSID”:”14652378021238672″,
“RCPTID”:”0″,
“RESPONSE”:”Recipient Dropped :: status not confirmed”,
“EMAIL”:”[email protected]”,
“TIMESTAMP”:”1465300547″,
“CLIENTID”:”10001″,
“FROMADDRESS”:”[email protected]”,
“EVENT”:”dropped”,
“MSIZE”:”575″
}
]
Ungültig
Alle API-Anfragen mit syntaktisch falschen E-Mail-Adressen werden als ungültig behandelt und nicht weiter bearbeitet. Sie können alle derartigen ungültigen Ereignisse in Echtzeit erfassen und versuchen, sie offline zu korrigieren.
[
{
“TRANSID”:”14652378021198302″,
“RCPTID”:””,
“RESPONSE”:”Invalid Email Address”,
“EMAIL”:”[email protected]”,
“TIMESTAMP”:”1465300638″,
“CLIENTID”:”10001″,
“FROMADDRESS”:”[email protected]”,
“EVENT”:”invalid”,
“MSIZE”:”16900″
}
]
Aufgeprallt
Der Empfangsserver konnte oder wollte die Nachricht aus verschiedenen Gründen nicht annehmen, z. B. weil der Empfangsserver nicht erreichbar ist, die E-Mail-ID nicht existiert usw. All diese Gründe gehören zu den Hard Bounces, die dazu führen, dass diese E-Mail-ID im Netcore Email API System auf die schwarze Liste gesetzt wird. Es gibt noch eine andere Gruppe von Bounces, die als Soft Bounce behandelt werden, z.B. Mailbox voll. Dies sind temporäre Bounces.
Harter Aufprall
[
{
“TRANSID”:”14652378014624064″,
“RCPTID”:”0″,
“RESPONSE”:”smtp;550 5.1.1 The email account that you tried to reach does not exist. Please try double-checking the recipient’s email address for typos or unnecessary spaces. Learn more at https://support.google.com/mail/answer/6596 z130si23626456iod.1″,
“BOUNCE_TYPE”:”HARDBOUNCE”,
“EMAIL”:”[email protected]”,
“TIMESTAMP”:”1465277622″,
“BOUNCE_REASONID”:”77″,
“CLIENTID”:”10001″,
“BOUNCE_REASON”:”email account that you tried to reach does not exist”,
“FROMADDRESS”:”[email protected]”,
“EVENT”:”bounced”,
“MSIZE”:”10″,
“USERAGENT”:”10″
}
]
Soft Bounce
[
{
“TRANSID”:”14652378014624064″,
“RCPTID”:”0″,
“RESPONSE”:”smtp;550 5.1.1 Mail box full”,
“BOUNCE_TYPE”:”SOFTBOUNCE”,
“EMAIL”:”[email protected]”,
“TIMESTAMP”:”1465277622″,
“BOUNCE_REASONID”:”1099″,
“CLIENTID”:”10001″,
“BOUNCE_REASON”:”mail box full for the account you reached”,
“FROMADDRESS”:”[email protected]”,
“EVENT”:”bounced”,
“MSIZE”:”10″,
“USERAGENT”:”10″
}
]
Geöffnet
Der Empfänger hat die E-Mail geöffnet.
[
{
“TRANSID”:”14652378013752608″,
“RCPTID”:”0″,
“RESPONSE”:””,
“EMAIL”:”[email protected]”,
“TIMESTAMP”:”1465276362″,
“CLIENTID”:”10001″,
“FROMADDRESS”:”[email protected]”,
“EVENT”:”opened”,
“MSIZE”:”1216″,
“USERAGENT”:”Mozilla/5.0 (Windows NT 5.1; rv:11.0) Gecko Firefox/11.0 (via ggpht.com GoogleImageProxy)”,
“IPADDRESS”:”64.233.173.70″
}
]
Geklickt
Der Empfänger hat auf einen Link in der Nachricht geklickt.
[
{
“TRANSID”:”14652378018802172″,
“RCPTID”:”[email protected]”,
“RESPONSE”:””,
“EMAIL”:”[email protected]”,
“TIMESTAMP”:”1465299696″,
“CLIENTID”:”10001″,
“FROMADDRESS”:”[email protected]”,
“EVENT”:”clicked”,
“MSIZE”:”19379″,
“USERAGENT”:”Mozilla/5.0 (X11; Linux i686) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/48.0.2564.116 Safari/537.36″,
“URL”:”https://www.pepipost.com”,
“IPADDRESS”:”11.11.11.16″
}
]
Abbestellt
Der Empfänger hat auf den Link für die Abmeldung geklickt.
[
{
“TRANSID”:”14652378014983009″,
“RCPTID”:”4″,
“RESPONSE”:””,
“EMAIL”:”[email protected]”,
“TIMESTAMP”:”1465278512″,
“CLIENTID”:”10001″,
“FROMADDRESS”:”[email protected]”,
“EVENT”:”unsubscribed”,
“MSIZE”:”1718″,
“USERAGENT”:”Mozilla/5.0 (X11; Linux i686) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/48.0.2564.116 Safari/537.36″,
“IPADDRESS”:”19.16.11.11″
}
]
Missbrauch
Empfänger, der die E-Mail als Spam markiert hat
[
{
“TRANSID”:”14652378014983009″,
“RCPTID”:”4″,
“RESPONSE”:””,
“EMAIL”:”[email protected]”,
“TIMESTAMP”:”1465278512″,
“CLIENTID”:”10001″,
“FROMADDRESS”:”[email protected]”,
“EVENT”:”abuse”,
“MSIZE”:”1718″,
“USERAGENT”:”Mozilla/5.0 (X11; Linux i686) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/48.0.2564.116 Safari/537.36″,
“IPADDRESS”:”19.16.11.11″
}
]
Kann ich fehlgeschlagene Webhook-Batches anzeigen?
Nein
Updated over 2 years ago