Webhook

I webhook ti permettono di ricevere notifiche HTTP in tempo reale quando si verificano eventi nel tuo account Emailit, come quando un'email viene consegnata, rimbalza o quando viene creato un contatto.

Invece di interrogare continuamente l'API per verificare le modifiche, i webhook inviano i dati direttamente al tuo server non appena si verificano gli eventi, consentendoti di creare integrazioni e flussi di lavoro reattivi.

Come funziona

1. Crei un endpoint webhook nella tua applicazione che accetta richieste POST
2. Registri l'URL nel pannello di controllo di Emailit o tramite l'API
3. Quando si verifica un evento a cui sei iscritto, Emailit invia una richiesta POST al tuo URL con i dati dell'evento
4. Il tuo endpoint risponde con un codice di stato 2xx per confermare la ricezione

Struttura degli eventi

Ogni evento webhook segue una struttura coerente:

{
  "event_id": "evt_2bH7kNwP5mQaV1sXgIdKe6pZr",
  "type": "email.delivered",
  "data": {
    "object": {
      ...
    }
  }
}

{
  "event_id": "evt_2bH7kNwP5mQaV1sXgIdKe6pZr",
  "type": "email.delivered",
  "data": {
    "object": {
      ...
    }
  }
}

Eventi disponibili

Emailit invia notifiche webhook per i seguenti tipi di risorse:

• Email — eventi del ciclo di vita della consegna (accettate, consegnate, rimbalzate, ecc.)
• Domini — creazione, aggiornamenti ed eliminazione di domini
• Audience — eventi di gestione delle audience
• Iscritti — eventi del ciclo di vita degli iscritti
• Contatti — eventi di gestione dei contatti
• Template — creazione, aggiornamenti ed eliminazione di template
• Soppressioni — modifiche alle liste di soppressione
• Verifiche Email — risultati delle verifiche
• Liste di Verifica Email — eventi delle liste di verifica in blocco

Consulta Tipi di Eventi per l'elenco completo.

Prossimi passi

• Tipi di Eventi — Elenco completo di tutti i tipi di eventi disponibili
• Richieste Webhook — Come sono strutturate le richieste HTTP dei webhook
• Firma delle Richieste — Verifica l'autenticità dei webhook utilizzando le firme