Localize um modelo de e-mail via API
Um modelo de e-mail é um conteúdo HTML com sintaxe de template integrada. Envie o corpo para a API, execute um fluxo de trabalho para seus idiomas e recupere o mesmo HTML para cada versão, com os marcadores protegidos durante todo o processo e prontos para colar no seu ESP.
Nesta página
Como faço para enviar um modelo?
Faça um POST /documents com content_type: "html" e seus idiomas de destino. O HTML é enviado na íntegra; formatação, links e marcadores de modelo permanecem intactos após a tradução.
Em seguida, estime e execute exatamente como em Automatize o Transept via API: a estimativa é gratuita e a execução abrange todas as versões de idioma em uma única chamada.
# 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}, … ] }O que acontece com os marcadores?
{{ first_name | … }} é mascarado antes que o modelo veja o texto e restaurado na íntegra depois; a resposta é conferida com o original, de modo que qualquer token perdido ou corrompido seja reparado em vez de enviado. Uma exceção deliberada: o texto de fallback dentro de uma tag (o friend em default:"friend") é o que os destinatários sem um nome no cadastro realmente leem, por isso ele é traduzido, enquanto a tag ao seu redor não é. As regras completas de proteção de tokens estão em arquivos de strings.
Como obtenho cada idioma de volta?
GET /documents/{id}/content?format=html em cada versão de idioma retorna a mesma estrutura HTML com o texto traduzido, pronta para colar na variante de idioma do ESP.
curl -s "$BASE/documents/<de-version-id>/content?format=html" \
-H "Authorization: Bearer $KEY"
# → the same HTML with German copy, Liquid intactO ciclo completo pode rodar sem mim?
Sim. Um gatilho de webhook configurado como “o corpo da requisição é o conteúdo” obtém o modelo diretamente do seu ESP ou de uma etapa do Zapier/n8n, executa o fluxo de trabalho assim que ele é recebido, e um webhook de saída envia um evento assinado quando as traduções estiverem prontas, para que sua automação possa recuperar o HTML sem precisar de polling. Ninguém precisa fazer uploads manuais.
As tags Liquid, Handlebars ou de mesclagem sobrevivem à tradução?
Sim. Os tokens do modelo são mascarados antes que o modelo veja o texto e restaurados na íntegra depois; além disso, cada resposta é conferida com o original, de modo que qualquer marcador perdido seja reparado em vez de enviado. A única exceção deliberada é o texto de fallback dentro de uma tag, que os destinatários de fato leem; por isso, ele é traduzido, enquanto a tag ao seu redor não é.
Minha plataforma de e-mail consegue enviar modelos sem código?
Sim. Configure o destino de um gatilho de fluxo de trabalho para “o corpo da requisição é o conteúdo” e aponte a plataforma, ou uma etapa do Zapier/n8n, para a URL do gatilho. Cada envio se torna um documento e o fluxo de trabalho é executado assim que ele é recebido. Veja gatilhos de webhook.
E quanto aos modelos localizados por meio de tags do Braze ou Mailchimp?
Modelos que utilizam tags de tradução ou condicionais de idioma para localização possuem um caminho de importação próprio que lê e preenche essas tags diretamente. Veja modelos de e-mail do Braze e Mailchimp.
Ainda com dúvidas? Pergunte à Literess no aplicativo, ou escreva para [email protected].