¿Cuáles son los diferentes formatos de Webhooks?
Eventos soportados: Actualmente soportamos Webhook en una serie de eventos, que son:
| 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 |
¿Por qué no se puede verificar mi Webhook o URL de devolución de llamada?
Al añadir la URL, la API de Netcore Email realiza una prueba HTTP(s) POST.
Si los datos POST son aceptados con éxito por su servidor, entonces Netcore Email API verifica y guarda la URL del webhook
Datos del evento
A continuación se muestran los datos de muestra para cada evento que le mostrarán los campos reales que se devolvieron en el POST de HTTP(s):
Glosario
| 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. |
Enviado
El correo electrónico ha sido entregado con éxito al servidor de recepción:
Muestra de datos de webhooks enviados
Un ejemplo del JSON completo que se enviaría a su URL de webhook es:
[
{
"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"
}
]
Se ha caído
Los usuarios que ya se hayan dado de baja en el pasado o que estén en la lista negra debido a quejas por rebote duro/spam serán tratados como dados de baja. Y no se permitirá ninguna otra comunicación por correo electrónico con este tipo de identificaciones.
[
{
“TRANSID”:”14652378021238672″,
“RCPTID”:”0″,
“RESPONSE”:”Recipient Dropped :: status not confirmed”,
“EMAIL”:”[email protected]”,
“TIMESTAMP”:”1465300547″,
“CLIENTID”:”10001″,
“FROMADDRESS”:”[email protected]”,
“EVENT”:”dropped”,
“MSIZE”:”575″
}
]
Inválido
Todas las solicitudes de la API con identificadores de correo electrónico sintácticamente incorrectos serán tratadas como no válidas y no se realizará ningún otro procesamiento con dichos identificadores. Puede capturar todos estos eventos no válidos en tiempo real y tratar de corregirlos fuera de línea.
[
{
“TRANSID”:”14652378021198302″,
“RCPTID”:””,
“RESPONSE”:”Invalid Email Address”,
“EMAIL”:”[email protected]”,
“TIMESTAMP”:”1465300638″,
“CLIENTID”:”10001″,
“FROMADDRESS”:”[email protected]”,
“EVENT”:”invalid”,
“MSIZE”:”16900″
}
]
Rebotado
El servidor receptor no pudo o no aceptó el mensaje debido a múltiples razones como que el servidor receptor no está localizable, el ID de correo electrónico no existe, etc. Todas estas razones forman parte del rebote duro, que llevará a la lista negra de ese ID de correo electrónico en el sistema API de Netcore Email. Hay otro conjunto de rebotes que se tratan como rebotes suaves, por ejemplo, buzón lleno. Se trata de rebotes temporales.
Rebote duro
[
{
“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″
}
]
Rebote suave
[
{
“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″
}
]
Abierto
El destinatario ha abierto el correo electrónico.
[
{
“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″
}
]
Clickeado
El destinatario ha hecho clic en un enlace dentro del mensaje.
[
{
“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″
}
]
No suscrito
El destinatario ha hecho clic en el enlace de gestión de baja.
[
{
“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″
}
]
Abuso
Destinatario que marcó el correo electrónico como Spam
[
{
“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″
}
]
¿Puedo ver los lotes de Webhooks fallidos?
No
Updated about 3 years ago