Vai al contenuto
Docs

Riferimento

Changelog: Chiavi API

Chiavi API: nuove funzioni, miglioramenti e correzioni.

ottobre 2026

  1. 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 parametro scope.
    • 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 identify collega 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:* e c:*.
    • API e MCP. L’API degli eventi di workspace, l’API delle chiavi di tracciamento e, nel toolset MCP events, lo strumento send-event e 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.

    Vedi Tracciamento degli eventi.

settembre 2026

  1. 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, from e to.
    • Le risposte dei domini restituiscono track_loads e track_clicks come 0 o 1, come documentato.
  2. Modificato

    Chiavi API di solo invio limitate agli endpoint di invio

    Chiavi APIAPI email

    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

  1. Novità

    API v2

    API RESTChiavi APIDomini di invioListeSoppressioni

    Le chiavi API sostituiscono le credenziali. Una chiave ha il permesso full o sending, 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.

Questa pagina ti è stata utile?

Grazie del feedback.

Grazie, leggiamo ogni messaggio.