API de Eventos / Triggers – Centro de ayuda de Mailjet

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 evento
time: el unix timestamp del evento (sin tener en consideración la zona horaria)

evento open

email: dirección email del destinatario que activa el evento
mj_campaign_id: id interna de campaña Mailjet para acceder al mensaje con el REST API
mj_contact_id : id interna de contacto Mailjet para acceder al contacto con el REST API
customcampaign: valor de X-Mailjet-Campaign
ip : dirección IP (puede ser IPv4 or IPv6) que activó el evento
geo: 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 evento
mj_campaign_id: id interna de campaña Mailjet para acceder al mensaje con el REST API
mj_contact_id: id interna de contacto Mailjet para acceder al contacto con el REST API
customcampaign: valor de X-Mailjet-Campaign
blocked: verdadero si rebote genera un bloqueo de destinatario
hard_bounce : verdadero si el error es permanente
error_related_to: ver tabla de errores
error: ver tabla de errores

evento spam

email: la dirección de email del destinatario que activó el evento
mj_campaign_id: id interna de campaña Mailjet para acceder al mensaje con el REST API
mj_contact_id: id interna de contacto Mailjet para acceder al contacto con el REST API
customcampaign: valor de X-Mailjet-Campaign
source : indica que programa de feedback loop program generó esta queja

evento blocked

email: la dirección de email del destinatario que activó el evento
mj_campaign_id : id interna de campaña Mailjet para acceder al mensaje con el REST API
mj_contact_id : id interna de contacto Mailjet para acceder al contacto con el REST API
customcampaign: valor de X-Mailjet-Campaign
error_related_to: ver tabla de errores
error: ver tabla de errores

evento typofix

original_address: destinatario original del mensaje
new_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.
`mailjet`	`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.

¡Leer la documentación!