Trigger / Event API

Endpunkt URL


Der Endpunkt ist eine URL die unsere Server vor jedem Event abrufen (dies kann zu vielen Hits führen!). Sie können diese in Ihren Kont-Einstellungen konfigurieren.

Wenn alles gut geht wird ein200 Ok HTTP Code zurückgeschickt. Jeder andere HTTP Code führt dazu dass unsere Server den Antrag später nochmals ausführen (bis zu 10 mal, alle 10 Minuten). Wenn der Antrag nach 10 Versuchen immer noch scheitert, wird dieser abgebrochen.

Wir empfehlen Ihnen wärmstens eine sichere URL (HTTPS) in Kombination mit einer Authentifizierung zu nutzen, damit keine Daten abgefangen werden, und dass nur unsere Server Ihre Daten versenden können.

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

Die Event Daten werden im POST Antrag-Body verschickt mit JSON Object. Dessen Inhalt ist abhängig vom Event.

Events


Alle Events besitzen folgende Eigenchaften :
event : Event Typ
time : unix timestamp vom Event (frei von Zeitzonen)

offener Event

E-mail : E-Mail Adresse des Empfängers löst das Event aus
mj_campaign_id : interne Mailjet Kampagnen ID für REST API Zugang tzur Nachricht
mj_contact_id : interne Mailjet Kontakt ID für REST API Zugang zu Kontakte
customcampaign : Wert der X-Mailjet-Kampagne
ip : IP Adresse (kann IPv4 oder IPv6 sein) die das Event auslöst
geo : Länderkennzahl der IP Adresse (see http://www.maxmind.com/app/iso3166)
Agent : Nutzer-Agent

Klick Event

Enthält alle offene Event Daten, plus :
url : der Link, der angeklickt wurde

Absprung Event

E-Mail : E-Mail Adresse des Empfängers, der den Event auslöst
mj_campaign_id : interne Mailjet Kampagnen ID für REST API Zugang zur Nachricht
mj_contact_id : interne Mailjet Kontakt ID für REST API Zugang zu Kontakte
customcampaign : Wert der X-Mailjet-Kampagne
blockiert : wahr wenn der Absprung zur Blockierung des Empfängers führt
hard_bounce : wahrwenn der Fehler permanent ist
error_related_to : Fehler-Tabelle lesen
error : Fehler-Tabelle lesen

Spam Event

E-Mail : E-Mail Adresse des Empfängers, der den Event auslöst
mj_campaign_id : interne Mailjet Kampagnen ID für REST API Zugang zur Nachricht
mj_contact_id : interne Mailjet Kontakt ID fÜr REST API Zugang zur Kontaktperson
customcampaign : Wert der X-Mailjet-Kampagne
Quelle : zeigt an welches Feedback Loop Programm die Beschwerde angegeben hat

blockiertes Event

E-Mail : E-Mail Adresse des Empfängers, der den Event auslöst
mj_campaign_id : interne Mailjet Kampagnen ID für REST API Zugang zur Nachricht
mj_contact_id : interne Mailjet Kontakt ID fÜr REST API Zugang zur Kontaktperson
customcampaign : Wert der X-Mailjet-Kampagne
error_related_to : Fehler-Tabelle lesen
error : Fehler-Tabelle lesen

Typofix Event

Original_Adresse : ursprünglicher Empfänger der Nachricht
new_address : Empfänger nach Anpassung

Mögliche Fehlerwerte



Fehler bezieht sich aufFehlerWas ist wirklich passiert ?
Empfänger unbekannter NutzerE-Mail Adresse existiert nicht, Schreibfehler checken !
Mailbox nicht aktivDas Konto war zu lange inaktiv, wahrscheinlich existiert diese Adresse nicht mehr.
Quote überschrittenAuch wenn dies kein permanenter Fehler ist, Konten die überschritten werden sind meistens inaktiv.
Domain ungültiges DomainIm Domain Name ist eine Schreibfehler. Oder die Adresse ist so alt dass die Domain abgelaufen ist !
kein Mail HostKeiner antwortet wenn wir an der Türe klopfen...
Relay/Zugang abgelehntDer Ziel-Mailserver weigert sich, mit uns zu kommunizieren
in der GrauzoneDies ist immer vorübergehend, sehen Sie dies nicht als Absprung !
Spam Absender blockiertDas ist slecht! Kontaktieren Sie uns um dies nachzugehen.
Inhalt blockiertEtwas in Ihrer E-Mail hat ein Anti-Spam ausgelöst und Ihre E-Mail wurde abgelehnt. Bitte kontaktieren Sie uns, damit wir die E-Mail-Inhalte studieren und Fehlberichte angeben können.
policy issueWir tun unser Bestes, um dies zu vermeiden, mit Outbound-Drosselung und die Best Practices nachzuleben. Wir erhalten Benachrichtigungen, wenn dies geschieht, aber stellen Sie sicher, dass Sie uns für weitere Informationen und Hilfe kontaktieren.
System system issueMit den Server stimmt etwas nicht. Dies sollte nicht vorfallen, und ist nicht permanent !
Protokoll Fehler
Verbindung Fehler
mailjet pre-blockiertSie haben versucht, eine E-Mail an eine Adresse zu senden, die vor kurzem (oder mehrmals) abgesprungen ist. Wir haben nicht versucht sie zu senden, um Ihrer IP Reputation nicht zu schaden. (Bald: Optionen, um E-Mail-Sperrung zu umgehen)
in Kampagne duplizierenSie haben X-Mailjet-DeduplicateCampaign benutzt und senden mehr als eine E-Mail an denselben Empfänger. Nur die Erste wurde verschickt, der Rest wurde blockiert.

Wollen Sie Mailjet jetzt testen?
Ein Konto erstellen - unverbindlich & ohne versteckten Kosten