Localizar una plantilla de correo electrónico mediante la API

POST /documents con content_type: "html" y sus idiomas de destino. El HTML se envía tal cual; el formato, los enlaces y los marcadores de posición de la plantilla se mantienen intactos durante la traducción.

A continuación, realice la estimación y la ejecución tal como se explica en Automatizar Transept con la API: la estimación es gratuita y la ejecución se aplica a todas las versiones de idioma en una sola llamada.

# 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}, … ] }

{{ first_name | … }} se enmascara antes de que el modelo vea el texto y se restaura tal cual después; la respuesta se coteja con el original, de modo que si un token se pierde o se corrompe, se repara en lugar de enviarse. Una excepción deliberada: el texto de respaldo dentro de una etiqueta (el friend en default:"friend") es lo que realmente leen los destinatarios sin un nombre registrado, por lo que este sí se traduce, a diferencia de la etiqueta que lo rodea. Las reglas completas de protección de tokens se encuentran en los archivos de cadenas.

GET /documents/{id}/content?format=html en cada versión de idioma devuelve la misma estructura HTML con el contenido traducido, listo para pegarlo en la variante de idioma del ESP.

curl -s "$BASE/documents/<de-version-id>/content?format=html" \
  -H "Authorization: Bearer $KEY"
# → the same HTML with German copy, Liquid intact

Sí. Un activador de webhook configurado como “el cuerpo de la solicitud es el contenido” recibe la plantilla directamente desde su ESP o desde un paso de Zapier/n8n, ejecuta el flujo de trabajo al recibirla y un webhook de salida envía un evento firmado cuando las traducciones están listas. De este modo, su automatización puede recuperar el HTML sin necesidad de realizar sondeos. Nadie tiene que subir nada a mano.