Annunci3 min di lettura
Nuovi endpoint API: contatti, eventi e webhook
Gestisci i contatti, interroga gli eventi e configura i webhook tramite codice con le ultime novità dell’API di Emailit.
GDi George
Abbiamo appena rilasciato tre nuovi gruppi di risorse nell’API v2 di Emailit: Contatti, Eventi e Webhook. Insieme ti danno il pieno controllo, tramite codice, sulla tua rubrica dei contatti, sul monitoraggio degli eventi e sulle integrazioni webhook.
Contatti
L’API dei contatti ti permette di creare, leggere, aggiornare ed eliminare i contatti del tuo workspace. Ogni contatto contiene un indirizzo email, un nome e campi personalizzati facoltativi, e può essere iscritto a una o più liste con una sola chiamata.
Endpoint | Descrizione |
|---|---|
Lista paginata di tutti i contatti | |
Recupera un contatto tramite ID o email | |
Crea un nuovo contatto e iscrivilo alle liste | |
Aggiorna nome, email, campi personalizzati o stato di disiscrizione | |
Elimina un contatto e tutti gli iscritti associati |
Puoi cercare i contatti tramite il loro ID (con_xxx) o l’indirizzo email, così usi l’identificatore che ti è più comodo.
{
"email": "mario@esempio.com",
"first_name": "Mario",
"last_name": "Rossi",
"custom_fields": { "company": "Acme" },
"audiences": ["aud_2BxFg7KNqr5M..."]
}Eventi
Gli eventi vengono creati automaticamente ogni volta che succede qualcosa nel tuo workspace: un’email viene consegnata, un contatto viene creato, un dominio viene aggiornato e così via. L’API degli eventi ti dà accesso in sola lettura a questo flusso di attività.
Endpoint | Descrizione |
|---|---|
Elenco paginato con filtro per tipo e payload dei dati facoltativo | |
Recupera un singolo evento con tutti i dati |
Puoi filtrare per uno o più tipi di evento con valori separati da virgola e usare include_data per decidere se restituire il payload completo anche negli elenchi.
GET /v2/events?type=email.accepted,email.delivered&include_data=trueWebhook
I webhook ti permettono di ricevere callback HTTP in tempo reale ogni volta che si verifica un evento. La nuova API dei webhook ti dà il controllo completo: puoi creare, aggiornare, attivare o disattivare ed eliminare gli endpoint webhook, tutto tramite l’API.
Endpoint | Descrizione |
|---|---|
Elenco paginato di tutti i webhook | |
Recupera un webhook tramite ID | |
Crea un nuovo endpoint webhook | |
Aggiorna URL, eventi o stato di attivazione | |
Elimina un webhook tramite ID o nome |
Puoi iscriverti a tipi di evento specifici oppure usare all_events per ricevere tutto.
{
"name": "Webhook di Produzione",
"url": "https://esempio.com/webhook",
"events": ["email.accepted", "email.delivered", "email.bounced"]
}Sono disponibili oltre 30 tipi di evento per email, domini, liste, iscritti, contatti, template, soppressioni e verifiche email. Trovi l’elenco completo nella documentazione di Create Webhook.
Inizia subito
Tutte e tre le API richiedono una chiave API con accesso completo. Vai al riferimento API per esplorare tutti i nuovi endpoint, oppure passa direttamente alla documentazione collegata qui sopra.
