Nuovi Endpoint API: Contatti, Eventi e Webhook
Abbiamo appena rilasciato tre nuovi gruppi di risorse nell'API v2 di Emailit: Contatti, Eventi e Webhook. Insieme ti offrono il controllo programmatico completo sulla tua rubrica, il monitoraggio degli eventi e le integrazioni webhook.
Contatti
L'API Contatti ti permette di creare, leggere, aggiornare ed eliminare contatti nel tuo workspace. Ogni contatto contiene un indirizzo email, nome opzionale e campi personalizzati, e può essere iscritto a una o più audience con una singola chiamata.
| Endpoint | Descrizione |
|---|---|
| Elenca Contatti | Lista paginata di tutti i contatti |
| Ottieni Contatto | Recupera un contatto tramite ID o email |
| Crea Contatto | Crea un nuovo contatto e iscrivilo alle audience |
| Aggiorna Contatto | Aggiorna nome, email, campi personalizzati o stato di disiscrizione |
| Elimina Contatto | Elimina un contatto e tutti gli iscritti associati |
I contatti possono essere cercati tramite il loro ID (con_xxx) o indirizzo email, così puoi utilizzare l'identificatore più comodo per te.
{
"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. Ad esempio, quando un'email viene consegnata, un contatto viene creato, un dominio viene aggiornato, e così via. L'API Eventi ti dà accesso in sola lettura a questo flusso di attività.
| Endpoint | Descrizione |
|---|---|
| Elenca Eventi | Lista paginata con filtro per tipo e payload dati opzionale |
| Ottieni Evento | Recupera un singolo evento con tutti i dati |
Puoi filtrare per uno o più tipi di evento utilizzando valori separati da virgola, e attivare include_data per controllare se il payload completo viene restituito nelle risposte delle liste.
GET /v2/events?type=email.accepted,email.delivered&include_data=true
Webhook
I webhook ti permettono di ricevere callback HTTP in tempo reale ogni volta che si verificano eventi. La nuova API Webhook ti dà il controllo completo. Puoi creare, aggiornare, abilitare/disabilitare ed eliminare endpoint webhook, tutto tramite l'API.
| Endpoint | Descrizione |
|---|---|
| Elenca Webhook | Lista paginata di tutti i webhook |
| Ottieni Webhook | Recupera un webhook tramite ID |
| Crea Webhook | Crea un nuovo endpoint webhook |
| Aggiorna Webhook | Aggiorna URL, eventi o stato di abilitazione |
| Elimina Webhook | Elimina un webhook tramite ID o nome |
Puoi iscriverti a tipi di evento specifici o utilizzare 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, audience, iscritti, contatti, template, soppressioni e verifiche email. Consulta l'elenco completo nella documentazione Crea Webhook.
Inizia subito
Tutte e tre le API richiedono una chiave API con permessi completi. Vai alla Documentazione API per esplorare tutti i nuovi endpoint, oppure passa direttamente alla documentazione linkata sopra.
Blog
Le ultime novità e aggiornamenti, direttamente da Emailit.
Rimani aggiornato con gli ultimi articoli del Blog di Emailit.
