Localizzare un template email tramite API
Un template email è un testo in formato HTML che contiene una sintassi specifica. Invia il corpo all'API, esegui un workflow per le tue lingue e recupera lo stesso HTML per ogni versione: i segnaposto resteranno protetti durante tutto il processo, pronti per essere incollati nel tuo ESP.
In questa pagina
Come si invia un template?
Esegui una POST /documents con content_type: "html" e le lingue di destinazione. L'HTML viene inserito così com'è; formattazione, link e segnaposto del template rimangono intatti durante la traduzione.
Quindi procedi con la stima e l'esecuzione esattamente come indicato in Automatizzare Transept tramite API: il preventivo è gratuito e l'operazione viene estesa a tutte le versioni linguistiche con una singola chiamata.
# BASE="https://app.transept.ai/api/public/v1"; KEY from Settings → Developer
curl -s -X POST $BASE/documents \
-H "Authorization: Bearer $KEY" -H "Content-Type: application/json" \
-d '{"title": "Trial welcome", "content_type": "html", "source_language": "en",
"target_languages": ["de", "fr"],
"content": "<h1>Welcome, {{ first_name | default:\"friend\" }}!</h1><p>Your trial starts today.</p>"}'
# → { document_id, language_group: [ {id, target_language}, … ] }Cosa succede ai segnaposto?
{{ first_name | … }} viene mascherato prima che il modello veda il testo e ripristinato testualmente in seguito; la risposta viene confrontata con l'originale, così un token perso o corrotto viene riparato anziché inviato. Un'unica eccezione intenzionale: il testo di fallback all'interno di un tag (il friend in default:"friend") è ciò che leggono effettivamente i destinatari di cui non si ha un nome a sistema, quindi viene tradotto, a differenza del tag che lo racchiude. Le regole complete sulla protezione dei token sono disponibili nei file di stringhe.
Come si recuperano le singole lingue?
GET /documents/{id}/content?format=html su ciascuna versione linguistica restituisce la stessa struttura HTML con i testi tradotti, pronta per essere incollata nella variante linguistica dell'ESP.
curl -s "$BASE/documents/<de-version-id>/content?format=html" \
-H "Authorization: Bearer $KEY"
# → the same HTML with German copy, Liquid intactL'intero ciclo può funzionare senza il mio intervento?
Sì. Un trigger del webhook impostato su “il corpo della richiesta è il contenuto” preleva il template direttamente dal tuo ESP o da un passaggio di Zapier/n8n, avvia il workflow alla ricezione e un webhook in uscita invia un evento firmato quando le traduzioni sono pronte, così la tua automazione può recuperare l'HTML senza polling. Nessuno deve caricare nulla a mano.
I tag Liquid, Handlebars o i tag di merge sopravvivono alla traduzione?
Sì. I token del template vengono mascherati prima che il modello veda il testo e ripristinati testualmente in seguito; ogni risposta viene confrontata con l'originale, così un segnaposto perso viene riparato anziché consegnato. L'unica eccezione intenzionale è il testo di fallback all'interno di un tag, che è ciò che i destinatari leggono effettivamente: questo viene tradotto, mentre il tag che lo racchiude no.
La mia piattaforma email può inviare i template senza scrivere codice?
Sì. Imposta la destinazione di un trigger del workflow su "il corpo della richiesta è il contenuto" e indirizza la piattaforma, o un passaggio di Zapier/n8n, verso l'URL del trigger. Ogni invio diventa un documento e il workflow viene eseguito alla ricezione. Consulta i trigger del webhook.
E i template localizzati tramite i tag di Braze o Mailchimp?
I template la cui localizzazione risiede in tag di traduzione o condizioni linguistiche seguono un percorso di importazione dedicato che legge e popola direttamente tali tag. Vedi i template email di Braze e Mailchimp.
Ha ancora dubbi? Chieda a Literess nell'app, oppure scriva a [email protected].