Changelog: API email

Il pulsante Retry su un’email trattenuta ora funziona, e Ritenta un’email accetta le email con stato held. Prima risolvi il motivo per cui l’email è stata trattenuta, ad esempio un punteggio spam alto o i crediti esauriti, poi ritentala.

Un nuovo tentativo crea una nuova email con un nuovo ID e costa crediti come qualsiasi altro invio. Le email più vecchie di 30 giorni, o il cui contenuto è stato rimosso per la conservazione dei dati, non si possono ritentare. Vedi Ritenta e inoltra le email.

Emailit confronta gli indirizzi in Reply-To e From, ignorando nomi visualizzati e maiuscole. Quando coincidono, rimuove Reply-To prima di firmare il messaggio. Le risposte arrivano comunque all’indirizzo From.

Quando gli indirizzi sono diversi, Reply-To resta invariato. Vedi Header email.

• L’API e l’SMTP confrontano il dominio del From senza distinguere tra maiuscole e minuscole, quindi ada@Acme.com invia dal dominio verificato acme.com.
• Modificare il sottodominio di tracciamento o di ricezione di un dominio nel pannello, oppure con tracking_key e inbound_key in Aggiorna un dominio, ora salva il nuovo valore. Pubblica il record DNS per il nuovo nome e verificalo.

• 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.

Una richiesta di invio con tracking attivo non riusciva con 422 quando il dominio di invio non aveva un CNAME di tracciamento verificato. Ora Emailit accetta l’email e la invia senza riscrivere i link né aggiungere il pixel di apertura.

Per tracciare aperture e clic, pubblica il record CNAME di tracciamento del dominio e verificalo. Vedi Configura un dominio di tracciamento personalizzato.

Gli errori temporanei venivano registrati sulla consegna, ma l’email manteneva lo stato precedente. Ora l’email stessa passa a attempted mentre Emailit ritenta, così l’elenco delle email e l’API mostrano quali email sono in ritardo.

Gli stati successivi, come delivered, e gli stati definitivi non vengono sovrascritti. Vedi Stati delle email.

• Compose nella pagina Emails, o in Quick Actions nel pannello, invia un’email singola da un dominio verificato, ad esempio per testare la configurazione. In Advanced puoi attribuire l’invio a una chiave API. Compose consente 3 email al minuto e 10 all’ora per workspace. Vedi Compose.
• Cancel delivery toglie dalla coda un’email accettata, programmata o con errore temporaneo. L’annullamento non è garantito: un’email che è già in fase di consegna al server del destinatario potrebbe comunque essere consegnata. Vedi Annulla un’email.

Seleziona Forward nella pagina di dettaglio di un’email, oppure chiama Inoltra un’email con un indirizzo to. Per impostazione predefinita il destinatario riceve una semplice copia. Attiva gli header inoltrati e aggiungi un commento se vuoi dare un contesto.

Un inoltro è una nuova email: costa crediti e rientra nei limiti di invio. Puoi inoltrare 3 email all’ora per workspace. Vedi Ritenta e inoltra le email.

La regola della sandbox ora vale per API, SMTP, Compose, nuovi tentativi, automazioni e campagne. Inviare a chiunque altro restituisce 403 con il codice unverified_workspace_recipient dall’API e 550 dall’SMTP, e gli invii delle campagne vengono bloccati. I workspace con accesso alla produzione non sono interessati.

Per rimuovere la limitazione, verifica un dominio e richiedi l’accesso alla produzione.

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.

• Elenca le email: GET /v2/emails
• Recupera il MIME grezzo: GET /v2/emails/:id/raw
• Recupera il corpo: GET /v2/emails/:id/body
• Recupera i metadati: GET /v2/emails/:id/meta
• Elenca gli allegati: GET /v2/emails/:id/attachments

Questi endpoint richiedono una chiave con accesso completo. Il contenuto resta disponibile finché il periodo di conservazione dei dati del piano non lo rimuove.

Le email e le consegne esistenti sono state migrate ai nuovi nomi. Gli eventi e le richieste webhook creati prima della modifica mantengono i valori con cui sono stati inviati. Vedi Stati delle email per l’elenco aggiornato.

Crea i template con l’editor HTML, l’editor di testo formattato o l’editor drag and drop Dragit. I template che condividono un alias sono versioni di uno stesso template e, quando invii per alias, viene usata solo la versione pubblicata.

Gestisci i template con l’API dei template e inviane uno passando template e variables a Invia un’email. Vedi Template.

Retry duplica l’email originale, assegna alla copia un nuovo ID e la invia attraverso la normale pipeline. Viene addebitata come qualsiasi nuova email. Per ritentare dal codice, chiama Ritenta un’email.

• Invia un’email: ogni destinatario riceve un proprio ID email. Programma l’invio con una data ISO 8601, un timestamp Unix o in linguaggio naturale, ad esempio «tomorrow at 9am», ed evita i duplicati con l’header Idempotency-Key.
• Recupera un’email: stato, header, contenuto, impostazioni di tracciamento e metadati.
• Aggiorna un’email programmata: cambia l’orario di invio fino a 3 minuti prima della scadenza.
• Annulla un’email: ferma un’email programmata o in coda.

Ogni risposta di invio include gli header ratelimit-*. Vedi Limiti di frequenza.

Le richieste oltre il limite vengono rifiutate invece di essere messe in coda: configura il client in modo che invii al massimo 2 email al secondo o che ritenti gli invii rifiutati. La modifica è stata estesa ai workspace in modo graduale.

Vedi Limiti di frequenza.