Localización e i18n

Localización elige el idioma de cada destinatario. Usted envía una intención; Notifique entrega el texto correcto para quien prefiere portugués, inglés u otro idioma.

¿Qué son `localization` e `i18n`?

En la raíz del body de envío (o en Enviar por plantilla), use:

localization — cómo traducir (mode, sourceLocale opcional)
i18n — mapa locale → texto (string simple u objeto con claves por campo)

El idioma de cada persona viene del registro del contacto (language / preferencias). Si no hay coincidencia, la API usa fallback (texto fuente o primer locale disponible).

Modos (`localization.mode`)

`mode`	Comportamiento
`off`	Sin traducción automática (predeterminado si se omite)
`manual`	Usted envía todas las traducciones en `i18n`
`ai`	Notifique traduce del texto fuente con IA (consume cuota de traducción)

localization.sourceLocale (opcional) indica el idioma del texto en payload cuando usa manual o ai.

Formato de `i18n`

Texto simple (SMS, Telegram, etc.):

"i18n": {
  "pt-BR": "Olá, Maria!",
  "en": "Hello, Maria!"
}

Varios campos (correo, push, WhatsApp, voz):

"i18n": {
  "pt-BR": { "subject": "Pedido confirmado", "html": "<p>Olá</p>" },
  "en": { "subject": "Order confirmed", "html": "<p>Hello</p>" }
}

Voz (speakText hablado + prompt DTMF):

"i18n": {
  "en": {
    "speakText": "Hello! Your delivery arrives today.",
    "gatherPrompt": "Press 1 to confirm."
  }
}

Claves comunes por canal: message, caption, subject, html, text, title, body, speakText, gatherPrompt. Vea la referencia OpenAPI del canal para la lista exacta.

Respuesta 202

Cuando localization.mode es manual o ai, la respuesta puede incluir data.localization con metadatos (appliedAiLocales, fallbackLocales, etc.). En SMS, destinatarios omitidos por política de longitud pueden aparecer en data.smsSkippedRecipients.

Dónde usar en API v1

Canal	Ruta	Notas
SMS	`POST /v1/sms/messages`	`message` en `i18n`
Correo	`POST /v1/email/messages`	`subject`, `html`, `text`
RCS	`POST /v1/rcs/messages`	Campos del `type` enviado
Push	`POST /v1/push/messages`	`payload.title`, `payload.body` (y `i18n` por locale)
WhatsApp	`POST /v1/whatsapp/messages`	Texto y media; no use `ai` en plantilla oficial Meta
Telegram	`POST /v1/telegram/messages`	Texto y caption
Plantillas	`POST /v1/templates/send`	Traducción al enviar + `localeTranslations` en CRUD
Instagram	Envío directo	Sin `localization` en POST — use bloque `instagram` en plantilla o texto fijo
Voz	`POST /v1/voice/calls`	`speakText` y `gatherPrompt` en `i18n`; `type: speak` o `gather`

Variables y placeholders

variables en la raíz (o payload.variables en plantilla) sustituyen {{name}} después de elegir el locale. Guía: Variables disponibles.

Errores comunes

`code`	Cuándo
`LOCALIZATION_TOO_MANY_LOCALES`	Demasiados locales en `i18n`
`LOCALIZATION_AI_NOT_SUPPORTED_OFFICIAL_TEMPLATE`	`ai` en plantilla WhatsApp oficial (Meta)

Catálogo completo: Respuestas de error.

Ejemplo (SMS, manual)

{
  "type": "text",
  "payload": { "message": "Hello, {{name}}!" },
  "to": ["5511999999999"],
  "variables": { "name": "Maria" },
  "localization": { "mode": "manual", "sourceLocale": "en" },
  "i18n": {
    "pt-BR": "Olá, {{name}}!",
    "en": "Hello, {{name}}!"
  }
}

Próximos pasos

SMS — Introducción: detalles de speed y smsSkippedRecipients
Enviar por plantilla: localization multicanal
Variables y CRUD de plantillas: localeTranslations en panel/API

API E-mail

E-mail

Domínios

E-mails recebidos

Localización e i18n

¿Qué son `localization` e `i18n`?

Modos (`localization.mode`)

Formato de `i18n`

Respuesta 202

Dónde usar en API v1

Variables y placeholders

Errores comunes

Ejemplo (SMS, manual)

Próximos pasos

​¿Qué son localization e i18n?

​Modos (localization.mode)

​Formato de i18n

​Respuesta 202

​Dónde usar en API v1

​Variables y placeholders

​Errores comunes

​Ejemplo (SMS, manual)

​Próximos pasos

¿Qué son `localization` e `i18n`?

Modos (`localization.mode`)

Formato de `i18n`

Respuesta 202

Dónde usar en API v1

Variables y placeholders

Errores comunes

Ejemplo (SMS, manual)

Próximos pasos