Riferimento
Changelog: Chiavi API
Chiavi API: nuove funzioni, miglioramenti e correzioni.
ottobre 2026
Novità
Tracciamento degli eventi: eventi di workspace e personalizzati
Tracciamento degli eventiChiavi APIWebhook
Ora puoi inviare i tuoi eventi accanto a quelli che registra Emailit, come un ordine, un cambio di piano o la visualizzazione di un prodotto. Trovi tutto nelle nuove schede Workspace events e Tracking di Email API > Events.
- Due ambiti. Gli eventi di workspace (
w:<name>) si dichiarano prima, con proprietà tipizzate, ed Emailit rifiuta gli eventi che non corrispondono. Gli eventi personalizzati (c:<name>) accettano qualsiasi oggetto JSON. Il log degli eventi ha un filtro Scope, e l’endpoint Elenca gli eventi un parametroscope. - Dai tuoi server. Invia un evento registra un evento, e Invia eventi in batch fino a 100. Funzionano con le nuove chiavi API Events Only, che possono inviare eventi ma non leggere dati né inviare email.
- Dal tuo sito web. Lo script di tracciamento invia eventi con una chiave di tracciamento pubblica che puoi limitare ai tuoi siti. La chiamata
identifycollega gli eventi di un visitatore a un contatto. - Contatti e webhook. Gli eventi compaiono nella sezione Activity log del contatto. I webhook ricevono i tipi che scegli, oppure tutti gli eventi di workspace o personalizzati con
w:*ec:*. - API e MCP. L’API degli eventi di workspace, l’API delle chiavi di tracciamento e, nel toolset MCP
events, lo strumentosend-evente quelli per gli eventi di workspace. - Piani. Il tracciamento degli eventi e lo script di tracciamento sono inclusi nei piani Pro, Business e Custom. Pro può usare 100 tipi di evento, Business 1000, e Custom non ha limiti. Vedi Limiti.
- Due ambiti. Gli eventi di workspace (
settembre 2026
Corretto
Correzioni di compatibilità dell’API v2
API RESTChiavi APIAPI emailDomini di invio
- Le chiavi API create prima che le chiavi avessero il prefisso
secret_vengono di nuovo accettate su/v2. - Recupera un’email restituisce l’oggetto email completo, compresi
object,frometo. - Le risposte dei domini restituiscono
track_loadsetrack_clickscome0o1, come documentato.
- Le chiavi API create prima che le chiavi avessero il prefisso
Modificato
Chiavi API di solo invio limitate agli endpoint di invio
In precedenza le chiavi di solo invio potevano elencare e recuperare le email e chiamare alcuni altri endpoint di lettura. Ora sono limitate a Invia un’email e alle azioni su un’email esistente: riprogrammare, annullare, ritentare e inoltrare. Gli altri endpoint rifiutano le chiavi di solo invio.
Se la tua integrazione legge anche email, domini o altre risorse, usa una chiave con accesso completo per quelle chiamate. Vedi Chiavi API.
ottobre 2025
Novità
API v2
API RESTChiavi APIDomini di invioListeSoppressioni
Le chiavi API sostituiscono le credenziali. Una chiave ha il permesso
fullosending, una chiave di solo invio può essere limitata a un solo dominio di invio e puoi gestire le chiavi tramite l’API. L’API v1 è rimasta disponibile durante la migrazione.Vedi il riferimento API.