Documentazione per le notifiche di eventi (webhook)

Esistono due tipi di notifiche di eventi.

Un evento di consegna riguarda lo status di invio delle email verso i destinatari, mentre l’interazione di questi ultimi con la posta elettronica è rappresentata da un evento di coinvolgimento.

In questa pagina trovi i riferimenti web di questi eventi.

Eventi di consegna

Gli eventi di consegna includono elaborato, cancel (Abbandonato), consegnato, differito e bounce.

• Elaborato

• {
   "id": "5943788912",
   "mid": "5520611177",
   "status": "PROCESSED",
   "email": "example@turbo-smtp.com",
   "subject": "Test Email",
   "timestamp": 1576709777
  }

• Cancel (abbandonato)

• {
   "id": "5943799537",
   "mid": "5520621607",
   "status": "DROPPED",
   "email": "example@turbo-smtp.com",
   "subject": null,
   "timestamp": 1576710200,
   "reason": {
     "0": "Dropped due to complaining recipient",
     "response": "Dropped due to complaining recipient"
   }
  }

• Consegnato

• {
   "id": "5943788912",
   "mid": "5520611177",
   "status": "DELIVERED",
   "email": "example@turbo-smtp.com",
   "subject": "Test Email",
   "timestamp": 1576709777
  }

• Differito

• {
   "id": "5943788913",
   "mid": "5520611177",
   "status": "DEFERRED",
   "email": "example@turbo-smtp.com",
   "subject": "Test Email",
   "timestamp": 1576709777,
   "reason": "400 try again later",
   "attempt": 2
  }

• Bounce

• {
   "id": "5943830007",
   "mid": "5520650288",
   "status": "BOUNCED",
   "email": "example@turbo-smtp.com",
   "subject": "Test Email",
   "timestamp": 1576711314,
   "reason": {
     "0": "104.47.38.36 does not like recipient. Remote host said: 550 5.4.1 Recipient address rejected: Access denied. AS(201806281) [BL2NAM02FT016.eop-nam02.prod.protection.outlook.com] {199.244.74.162} Giving up on 104.47.38.36. ",
     "response": "104.47.38.36 does not like recipient. Remote host said: 550 5.4.1 Recipient address rejected: Access denied. AS(201806281) [BL2NAM02FT016.eop-nam02.prod.protection.outlook.com] {199.244.74.162} Giving up on 104.47.38.36. "
   }
  }

Eventi di coinvolgimento

Gli eventi di coinvolgimento includono apertura, clic, disiscrizione e spam report.

• Apertura

• {
   "id": "5943788913",
   "mid": "5520611177",
   "status": "OPENED",
   "email": "example@turbo-smtp.com",
   "subject": "Test Email",
   "timestamp": 1576709777,
   "useragent": "Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/78.0.3904.108 Safari/537.36",
   "ip": "40.101.136.165"
  }

• Clic

• {
   "id": "5943788913",
   "mid": "5520611177",
   "status": "CLICKED",
   "email": "example@turbo-smtp.com",
   "subject": "Test Email",
   "timestamp": 1576709777,
   "useragent": "Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/78.0.3904.108 Safari/537.36",
   "url": "https://serversmtp.com",
   "ip": "156.218.154.17"
  }

• Disiscrizione

• {
   "id": "5943788913",
   "mid": "5520611177",
   "status": "UNSUBSCRIBED",
   "email": "example@turbo-smtp.com",
   "subject": "Test Email",
   "timestamp": 1576709777
  }

• Spam report

• {
   "id": "5943788913",
   "mid": "5520611177",
   "status": "REPORT",
   "email": "example@turbo-smtp.com",
   "subject": "Test Email",
   "timestamp": 1576709777
  }

Tipo di evento

ID – l’identificativo dell’evento.
MID – l’ID allegato al messaggio.
Status – il tipo di evento: elaborato, cancel, consegnato, differito, bounce, aperto, clic, disiscrizione, spam report.
Email – l’indirizzo email del destinatario.
Oggetto – l’oggetto dell’email.
Timestamp – quando il messaggio è stato inviato in base ai parametri Unix (GMT+0).
Reason – qualsiasi tipo di risposta di errore. Viene restituito dal server del destinatario e indica il motivo per cui è stato attivato l’evento specifico.
Tentativo – il numero di volte che turboSMTP ha tentato di recapitare questo messaggio.
Useragent – l’agente responsabile dell’evento, per esempio un browser.
IP – l’indirizzo IP del destinatario che ha interagito con il messaggio.
URL – il link all’interno dell’email su cui il destinatario ha cliccato.