La URL de retorno
La URL de retorno es una URL a la que llama nuestro servidor después de cada evento (esto puede llevar a un montón de llamadas). Se puede configurar en las preferencias de su cuenta.
Esta debe devolver, en el caso en que todo está bien, un código HTTP 200 Ok
. Cualquier otro código HTTP dará lugar a nuevas peticiones realizadas por nuestro servidor más adelante (hasta 10 veces, cada 10 minutos). Si la petición sigue fallando al cabo de 10 intentos, se cesarán los intentos.
Recomendamos encarecídamente el uso de una URL Securizada (HTTPS) combinada con una autentifícación básica para asegurarse que sus datos no pueden ser interceptados, y que solo nuestros servidores pueden enviarle datos.
Eg: https://usuario:contraseña@www.ejemple.com/mailjet_triggers.php
Los datos de los eventos se envían en la petición POST utilizando un objeto JSON. Su contenido depende del evento.
Eventos
Todos los eventos contienen las siguientes propiedades:event
: el tipo de eventotime
: el unix timestamp del evento (sin tener en consideración la zona horaria)
evento open
email
: dirección email del destinatario que activa el eventomj_campaign_id
: id interna de campaña Mailjet para acceder al mensaje con el REST APImj_contact_id
: id interna de contacto Mailjet para acceder al contacto con el REST APIcustomcampaign
: valor de X-Mailjet-Campaignip
: dirección IP (puede ser IPv4 or IPv6) que activó el eventogeo
: código país de la dirección IP (ver http://www.maxmind.com/app/iso3166)agent
: User-Agent
evento click
Contiene todos los datos de eventos abiertos
, y además:url
: el enlace que fué accedido
evento bounce
email
: la dirección de email del destinatario que activó el eventomj_campaign_id
: id interna de campaña Mailjet para acceder al mensaje con el REST APImj_contact_id
: id interna de contacto Mailjet para acceder al contacto con el REST APIcustomcampaign
: valor de X-Mailjet-Campaignblocked
: verdadero si rebote genera un bloqueo de destinatariohard_bounce
: verdadero si el error es permanenteerror_related_to
: ver tabla de erroreserror
: ver tabla de errores
evento spam
email
: la dirección de email del destinatario que activó el eventomj_campaign_id
: id interna de campaña Mailjet para acceder al mensaje con el REST APImj_contact_id
: id interna de contacto Mailjet para acceder al contacto con el REST APIcustomcampaign
: valor de X-Mailjet-Campaignsource
: indica que programa de feedback loop program generó esta queja
evento blocked
email
: la dirección de email del destinatario que activó el eventomj_campaign_id
: id interna de campaña Mailjet para acceder al mensaje con el REST APImj_contact_id
: id interna de contacto Mailjet para acceder al contacto con el REST APIcustomcampaign
: valor de X-Mailjet-Campaignerror_related_to
: ver tabla de erroreserror
: ver tabla de errores
evento typofix
original_address
: destinatario original del mensajenew_address
: destinatario después de cambio
Posibles valores de error
ERROR_RELATED_TO |
ERROR |
¿QUÉ OCURRIÓ DE VERDAD? |
---|---|---|
recipient |
user unknown |
La dirección de email ya no existe. ¡Verifique cualquier posible error tipográfico! |
mailbox inactive |
Esta cuenta está inactiva desde hace demasiado tiempo, debería verificar si esta cuenta sigue existiendo. | |
quota exceeded |
Aunque no sea un error permanente, en la mayoría de los casos cuando una cuenta está over quota, significa que está inactiva. | |
domain |
invalid domain |
Hay un error tipográfico en el dominio de la dirección email. O la dirección es tan antigua que el dominio ya no existe. |
no mail host |
Nadie contesta cuando llamamos a la puerta... | |
relay/access denied |
El servidor de destino se niega a comunicarse con nosotros. | |
greylisted |
Esto siempre es temporal y no debería considerarlo como bounce. | |
spam |
sender blocked |
Esto es malo. Debería contactarnos para averiguar esta situación crítica. |
content blocked |
Algo en su correo electrónico ha dado lugar a un antispam y su email fue rechazado. Por favor, póngase en contacto con nosotros para que podamos estudiar el contenido del correo electrónico e informar sobre cualquier falso positivo. | |
policy issue |
Hacemos lo posible para evitar éstos problemas con el control de limites de envío y siguiendo las mejores prácticas. Nosotros recibimos un email cuando esto sucede, pero asegúrese de contactar con nosotros para más información y encontrar una solución. | |
system |
system issue |
Algo salió mal con nuestros servidores. Esto no debería suceder, y nunca será permanente! |
problema de protocolo |
||
problema de conexión |
||
mailjet |
preblocked |
Ha intentado enviar un correo electrónico a una dirección que recientemente (o varias veces) generó un rebote. No lo hemos enviado para evitar daños a su reputación. |
duplicate in campaign |
Ha utilizado X-Mailjet-DeduplicateCampaign y ha enviado más de un email a un mismo destinatario. Solo el primer correo fue enviado y el resto fue bloqueado. |