1. Mailjet
  2. Support
  3. Documentation

API pour des évènements/triggers

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 résultera en d'autres essais plus tard (jusqu'à 10 fois, toutes les 10 minutes). Si la requête envoie toujours une erreur après 10 essais, nous arrêterons d'essayer.

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é ?
destinataireuser unknownL'adresse email n'existe pas, vérifier les erreurs de typographie !
mailbox inactiveLe compte a été inactif depuis trop longtemps, vous devriez considérer que cette adresse n'existe plus.
quota exceededMê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
domaineinvalid domainIl 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 hostPersonne ne répond quand nous toque à la porte...
relay/access deniedLe serveur mail du destinataire refuse de nous parler.
greylistedC'est toujours très temporaire, et vous ne devriez jamais voir ceci pour un bounce (retour à l'expéditeur) !
spamsender blockedC'est assez mauvais! Vous devriez investiguer la raison pour laquelle vous avez été bloqué.
content blockedQuelque 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 issueNous 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èmesystem issueQuelque chose s'est mal passé sur nos serveurs. Cela ne devrait pas arriver et ne sera jamais permanent !
protocol issue
connection issue
mailjetpreblockedVous 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)
duplicate in campaignVous 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.

Essayer Mailjet maintenant ?
Créez un compte - sans engagement, sans frais cachés