URL endpoint

L'endpoint è un URL che il nostro server chiamerà per ogni evento (può portare a moltissimi accessi!). Puoi configurarlo nelle preferenze del tuo account.

Se tutto va come previsto, deve fornire un codice HTTP 200 Ok. Qualsiasi altro codice HTTP farà sì che il nostro server ritenti la richiesta in un secondo momento. Il nostro sistema riproverà ogni 30 secondi e si fermerà dopo 24 ore, a meno che non venga generato un nuovo evento.

Ti consigliamo vivamente di utilizzare un URL sicuro (HTTPS) in combinazione con un'autenticazione di base per assicurarti che i dati non possano essere intercettati e che solo i nostri server possano inviarti dati.

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

I dati dell'evento vengono inviati nel corpo della richiesta POST utilizzando un oggetto JSON. Il contenuto dipende dall'evento.

Eventi

Tutti gli eventi contengono queste proprietà:
event : il tipo di evento
time : timestamp unix dell'evento (senza problemi di fuso orario)

evento open (apertura)

email: indirizzo email del destinatario che attiva l'evento
mj_campaign_id: id interno della campagna Mailjet per l'accesso REST API al messaggio
mj_contact_id: id interno del contatto Mailjet per l'accesso REST API al contatto
customcampaign: valore di X-Mailjet-Campaign
ip: indirizzo IP (può essere IPv4 o IPv6) che ha attivato l'evento
geo: codice paese dell'indirizzo IP (vedi http://www.maxmind.com/app/iso3166)
agent: agente utente

evento click

Contiene tutti i dati dell'evento open, più:
url: il link che è stato cliccato

evento bounce (errore di recapito)

email: indirizzo email del destinatario che ha attivato l'evento
mj_campaign_id: id interno della campagna Mailjet per l'accesso REST API al messaggio
mj_contact_id: id interno del contatto Mailjet per l'accesso REST API al contatto
customcampaign: valore di X-Mailjet-Campaign
blocked: vero se questo errore di recapito porta al blocco del destinatario
hard_bounce: vero se l'errore era permanente
error_related_to: vedi tabella degli errori
error: vedi tabella degli errori

evento spam

email: indirizzo email del destinatario che attiva l'evento
mj_campaign_id: id interno della campagna Mailjet per l'accesso REST API al messaggio
mj_contact_id: id interno del contatto Mailjet per l'accesso REST API al contatto
customcampaign: valore di X-Mailjet-Campaign
source: indica quale programma di loop di feedback ha riportato questo reclamo

evento blocked (bloccato)

email: indirizzo email del destinatario che ha attivato l'evento
mj_campaign_id: id interno della campagna Mailjet per l'accesso REST API al messaggio
mj_contact_id: id interno del contatto Mailjet per l'accesso REST API al contatto
customcampaign: valore di X-Mailjet-Campaign
error_related_to: vedi tabella degli errori
error: vedi tabella degli errori

evento unsub (iscrizione annullata)

email: indirizzo email del destinatario che attiva l'evento
mj_campaign_id: id interno della campagna Mailjet per l'accesso REST API al messaggio
mj_contact_id: id interno del contatto Mailjet per l'accesso REST API al contatto
mj_list_id: id interno dell'elenco Mailjet per l'accesso REST API alla gestione degli elenchi
customcampaign: valore di X-Mailjet-Campaign
ip: indirizzo IP (può essere IPv4 o IPv6) che ha scatenato l'evento
geo: codice paese dell'indirizzo IP (vedi http:// www.maxmind.com/app/iso3166)
agent: agente utente

evento typofix (correzione errore di battitura)

original_address : destinatario originale del messaggio
new_address: destinatario dopo la modifica

Possibili valori per gli errori

`ERROR_RELATED_TO`	`ERROR`	COS'È SUCCESSO VERAMENTE?
`recipient`	`user unknown`	L'indirizzo email non esiste, verifica che non ci siano errori di battitura!
	`mailbox inactive`	L'account è inattivo da troppo tempo, questo indirizzo potrebbe non esistere più.
	`quota exceeded`	Anche se si tratta di un errore non permanente, nella maggior parte dei casi quando gli account superano la quota significa che sono inattivi.
`domain`	`invalid domain`	C'è un errore di battitura nella parte del nome di dominio dell'indirizzo. Oppure l'indirizzo è obsoleto e il suo dominio è scaduto!
	`no mail host`	Nessuno risponde quando bussiamo alla porta...
	`relay/access denied`	Il server di posta di destinazione si rifiuta di parlare con noi.
	`greylisted`	Si tratta sempre di un fenomeno temporaneo e non dovresti mai considerarlo un errore di recapito!
`spam`	`sender blocked`	È piuttosto grave! Dovresti contattarci per indagare sul problema.
	`content blocked`	Qualcosa nella tua email ha attivato un antispam e per questo è stata rifiutata. Contattaci in modo da poter studiare il contenuto dell'email e segnalare eventuali falsi positivi.
	`policy issue`	Facciamo del nostro meglio per evitare questo tipo di problema, con la limitazione dei messaggi in uscita e seguendo le migliori pratiche. Riceviamo avvisi quando ciò accade, ma assicurati di contattarci per ulteriori informazioni e per trovare una soluzione.
`system`	`system issue`	Qualcosa è andato storto con i nostri server. Ciò non dovrebbe accadere e non dovrebbe mai essere permanente!
	`protocol issue`
	`connection issue`
`mailjet`	`preblocked`	Hai cercato di inviare un'email a un indirizzo che recentemente (o ripetutamente) ha generato errori di recapito. Non abbiamo cercato di inviarla per non danneggiare la tua reputazione. (Presto, vedi le opzioni per aggirare il blocco delle email)
`mailjet`	`duplicate in campaign`	Hai utilizzato X-Mailjet-DeduplicateCampaign e inviato più di un'email a un singolo destinatario. Solo la prima è stata inviata, le altre sono bloccate.

Sfoglia la documentazione!