URL de retour

L'URL de retour est une url que notre serveur appellera après chaque évènement (cela peut mener à beaucoup d'appels !). Vous pouvez la configurer dans les préférences de votre compte.

Il faut retourner un code HTTP 200 Ok si tout se passe bien. Tout autre code HTTP entraînera une nouvelle tentative de notre serveur pour la demande ultérieurement. Notre système réessayera toutes les 30 secondes et s'arrêtera après 24h, sauf si un nouvel événement est généré.

Nous recommandons fortement d'utiliser une URL sécurisée (HTTPS) en combinaison avec une authentification basique pour être sûr que les données ne peuvent être interceptées, et que seuls nos serveurs peuvent vous envoyer des données.

Exemple: https://username:password@www.example.com/mailjet_triggers.php

Les données des évènements sont envoyées dans une requête POST en utilisant un objet JSON. Son contenu dépend de l'évènement.

Evènements

Tous les évènements contiennent les propriétés suivantes :
event : le type d'évènement
time : date unix d'un évènement (sans problèmes de fuseaux horaires)

Evènement d'ouverture

event : open
email : adresse email du destinataire qui provoque l'évènement
mj_campaign_id : identifiant de campagne interne à Mailjet campaign id pour que la REST API puisse accéder au message
mj_contact_id : identifiant de contact interne à Mailjet contact id for REST API access to contact
customcampaign : valeur de X-Mailjet-Campaign
ip : adresse IP (peut être de l'IPv4 ou de l'IPv6) qui déclenche l'évènement
geo : code du pays de l'adresse IP (voir http://www.maxmind.com/app/iso3166)
agent : Agent-Utilisateur

Evènement d'un clic

Contient toutes les données d'un évènement d'ouverture, avec :

event : click
url : le lien qui a été cliqué

Evènement de bounce (retour à l'expéditeur)

event : bounce
email : adresse email du destinataire qui provoque l'évènement
mj_campaign_id : identifiant de campagne interne à Mailjet campaign id pour que la REST API puisse accéder au message
mj_contact_id : identifiant de contact interne à Mailjet contact id for REST API access to contact
customcampaign : valeur de X-Mailjet-Campaign
blocked : vrai (true) si ce bounce mène à un destinataire bloqué
hard_bounce : vrai (true) si l'erreur est permanente
error_related_to : voir la table d'erreur
error : voir la table d'erreur

Evènement de spam

event : spam
email : adresse email du destinataire qui provoque l'évènement
mj_campaign_id : identifiant de campagne interne à Mailjet campaign id pour que la REST API puisse accéder au message
mj_contact_id : identifiant de contact interne à Mailjet contact id for REST API access to contact
customcampaign : valeur de X-Mailjet-Campaign
source : indique quel programme a rapporté cette plainte

Evènement de blocage

event : blocked
email : adresse email du destinataire qui provoque l'évènement
mj_campaign_id : identifiant de campagne interne à Mailjet campaign id pour que la REST API puisse accéder au message
mj_contact_id : identifiant de contact interne à Mailjet contact id for REST API access to contact
customcampaign : valeur de X-Mailjet-Campaign
error_related_to : voir la table d'erreur
error : voir la table d'erreur

Evènement de désincription

event : unsub
email : adresse email du destinataire qui provoque l'évènement
mj_campaign_id : identifiant de campagne interne à Mailjet campaign id pour que la REST API puisse accéder au message
mj_contact_id : identifiant de contact interne à Mailjet contact id for REST API access to contact
customcampaign : valeur de X-Mailjet-Campaign
ip : adresse IP (peut être de l'IPv4 ou de l'IPv6) qui déclenche l'évènement
geo : code du pays de l'adresse IP (voir http://www.maxmind.com/app/iso3166)
agent : Agent-Utilisateur

Evènement typofix

original_address : adresse originale du destinataire du message
new_address : destinataire après modification

Valeurs possibles pour les erreurs

ERREURS LIÉES À	ERREUR	CE QU'IL S'EST RÉELLEMENT PASSÉ ?
`destinataire`	`user unknown`	L'adresse email n'existe pas, vérifier les erreurs de typographie !
	`mailbox inactive`	Le compte a été inactif depuis trop longtemps, vous devriez considérer que cette adresse n'existe plus.
	`quota exceeded`	Même si cela peut être une erreur non permanente, la plupart du temps quand un compte dépasse le quota, cela signifie qu'il est inactif
`domaine`	`invalid domain`	Il y a une erreur dans le nom de domaine qui fait partie de l'adresse. Ou l'adresse est trop vieille et le domaine a expiré !
	`no mail host`	Personne ne répond quand nous toque à la porte...
	`relay/access denied`	Le serveur mail du destinataire refuse de nous parler.
	`greylisted`	C'est toujours très temporaire, et vous ne devriez jamais voir ceci pour un bounce (retour à l'expéditeur) !
`spam`	`sender blocked`	C'est assez mauvais! Vous devriez investiguer la raison pour laquelle vous avez été bloqué.
	`content blocked`	Quelque chose dans votre email a déclenché un antispam et votre email a été rejeté. Veuillez nous contacter pour que nous puissions étudier le contenu de l'email et agir contre si c'est un faux positif.
	`policy issue`	Nous faisons le maximum pour éviter cela en limitant les outbound throttling et en suivant les bonnes pratiques. Nous recevons des alertes quand cela survient, mais n'hésitez pas à nous contacter pour plus d'informations.
`système`	`system issue`	Quelque chose s'est mal passé sur nos serveurs. Cela ne devrait pas arriver et ne sera jamais permanent !
	`protocol issue`
	`connection issue`
`mailjet`	`preblocked`	Vous avez essayer d'envoyer un email à un destinataire qui a récemment (ou de manière répétée) poussé à un retour à l'expéditeur (bounce). Nous n'avons pas essayé de l'envoyer pour éviter d'endommager votre réputation. (Bientôt: voir les options pour éviter ce blocage d'emails)
`mailjet`	`duplicate in campaign`	Vous avez utilisé l'option X-Mailjet-DeduplicateCampaign et envoyé plus d'un email à un seul destinataire. Seul le premier a été envoyé, les autres sont bloqués.

Parcourir la documentation !