Mensajería multiidioma

Esta guía explica cómo configurar el idioma de un usuario en OneSignal y enviar mensajes en su idioma preferido a través de notificaciones push, emails y mensajes en la app.

Configurar idioma del usuario

OneSignal configura automáticamente la propiedad language desde el idioma del dispositivo cuando un usuario se crea por primera vez usando los SDKs web o móviles. También puedes configurar o actualizar manualmente el idioma del usuario usando el código de idioma de 2 letras ISO 639-1 con:

El método setLanguage del SDK.
El campo language en las APIs Crear usuario o Actualizar usuario.
La columna language en el Importador CSV.

Consulta Idiomas soportados para una lista de códigos de idioma válidos.

Enviar mensajes en diferentes idiomas

Usa las pestañas a continuación para ver opciones de localización por canal de mensajería.

Notificaciones push
Email
Mensajes en la app
SMS

Envío desde el panel

Desde Messages > Push > New Message o Plantillas, haz clic en Add Languages. Elige entre:

Opción 1: Casillas de verificación

Selecciona los idiomas que soportas. Cualquier idioma no seleccionado volverá a Any/English.

Usar casillas de verificación para seleccionar los idiomas.

Opción 2: Importar contenido de idiomas

Usa la plantilla proporcionada para formatear el mensaje en cada idioma.

Modal para copiar y pegar datos desde una hoja de cálculo.

Copia y pega el contenido de vuelta en el campo “Add Languages”.

Previsualiza el contenido para verificar, inserta el contenido, y aparecerán nuevas pestañas en el editor con el contenido designado completado.

Opción 3: Contenido dinámico

Usa Contenido dinámico que implica crear y subir un archivo CSV con los idiomas que soportas.

Solución de problemas

Inglés requerido: Incluye una fila para en como predeterminado.
Usar encabezados correctos: language_code, title, subtitle, message
Valores separados por comas: Asegura el formato CSV apropiado.
Idioma no soportado: Si no está listado en la interfaz o plantilla, no está soportado. Usa la siguiente mejor opción y contacta a support@onesignal.com.

El editor del panel usa un campo HTML estándar. Caracteres especiales como % pueden causar problemas de visualización en idiomas RTL. Agrega marcas RLM después de tales caracteres para solucionar problemas de formato.

Envío por API

Los campos contents y headings soportan múltiples idiomas:

  {
    "contents": {
      "en": "English content",
      "fr": "French content"
    },
    "headings": {
      "en": "English heading",
      "fr": "French heading"
    }
  }

Envío desde el panel

Desde Messages > Email > New Message o Plantillas, elige entre:

Opción 1: Segmentos

Crea un segmento para cada idioma.
Crea una plantilla por idioma.
Envía cada uno a su segmento correspondiente.

Opción 2: Sintaxis Liquid

Usa sintaxis Liquid y sustitución de propiedades o tags para crear declaraciones condicionales en el mensaje y renderizar el contenido apropiado basado en el idioma del usuario.

Liquid

{% assign language = subscription.language %}
{% if language == 'fr' %}
  Bonjour {{ name }}!
{% elsif language == 'es' %}
  Hola {{ name }}!
{% else %}
  Hi {{ name }}!
{% endif %}

Opción 3: Contenido dinámico

Usa Contenido dinámico que implica crear y subir un archivo CSV con los idiomas que soportas.

Envío por API

Usando la API Crear mensaje, puedes:

Orientar segmentos o filtros de idioma como lo harías con el panel.
Crear plantillas de mensaje con sintaxis Liquid utilizando custom_data, sustitución de propiedades o tags. Consulta Personalización de mensajes para más detalles sobre estas opciones.

Ejemplo de personalización masiva con custom_data:

Template

{% assign eid = message.custom_data.users[subscription.external_id] %}
Hi {{ eid.first_name }}, you have {{ eid.points }} points. Your level is {{ eid.level }}.

API Request

{
  "app_id": "YOUR_APP_ID",
  "template_id": "YOUR_TEMPLATE_ID",
  "include_aliases": {
    "external_id": ["user123", "user456"]
  },
  "custom_data": {
    "users": {
      "user123": { "first_name": "John", "points": "150", "level": "Gold" },
      "user456": { "first_name": "Sarah", "points": "200", "level": "Platinum" }
    }
  }
}

El cliente ve:

“Hi John, you have 150 points. Your level is Gold.”
“Hi Sarah, you have 200 points. Your level is Platinum.”

Panel - Segmentos

Para enviar un mensaje en la app específico de idioma a cada idioma que necesitas soportar:

Crea un segmento para cada idioma.
Crea un mensaje en la app por idioma.
Envía cada uno a su segmento correspondiente.

Sustitución de tags

Usa sintaxis Liquid y sustitución de tags para crear declaraciones condicionales en el mensaje y renderizar el contenido apropiado basado en tags.

Solo la sustitución de tags está soportada para mensajes en la app.

Envío desde el panel

Desde Messages > SMS > New Message o Plantillas, elige entre:

Opción 1: Segmentos

Crea un segmento para cada idioma.
Crea una plantilla por idioma.
Envía cada uno a su segmento correspondiente.

Opción 2: Contenido dinámico

Usa Contenido dinámico que implica crear y subir un archivo CSV con los idiomas que soportas.

Envío por API

Los campos contents y headings soportan múltiples idiomas:

  {
    "contents": {
      "en": "English content",
      "fr": "French content"
    },
    "headings": {
      "en": "English heading",
      "fr": "French heading"
    }
  }

Idiomas soportados

El código de idioma se mapea a la propiedad de usuario language en el formato de código de 2 letras ISO 639-1. Soportamos los siguientes códigos de idioma.

Si el código de idioma no está incluido en la ventana emergente y la plantilla CSV, entonces este idioma no está soportado. Recomendamos usar el siguiente mejor idioma y enviarnos una solicitud de producto a support@onesignal.com

Language	Language Code
English	en
Arabic	ar
Azerbaijani	az
Bosnian	bs
Catalan	ca
Chinese (Simplified)	zh-Hans
Chinese (Traditional)	zh-Hant
Croatian	hr
Czech	cs
Danish	da
Dutch	nl
Estonian	et
Finnish	fi
French	fr
Georgian	ka
Bulgarian	bg
German	de
Greek	el
Hindi	hi
Hebrew	he
Hungarian	hu
Indonesian	id
Italian	it
Japanese	ja
Korean	ko
Latvian	lv
Lithuanian	lt
Malay	ms
Norwegian	nb
Persian	fa
Polish	pl
Portuguese	pt
Punjabi	pa
Romanian	ro
Russian	ru
Serbian	sr
Slovak	sk
Spanish	es
Swedish	sv
Thai	th
Turkish	tr
Ukrainian	uk
Vietnamese	vi

Primeros pasos & configuraciones

Canales de mensajería

Journeys

Audiencia & eventos personalizados

Analítica & Integraciones

Privacidad & Seguridad

Mensajería multiidioma

Configurar idioma del usuario

Enviar mensajes en diferentes idiomas

Envío desde el panel

Opción 1: Casillas de verificación

Opción 2: Importar contenido de idiomas

Opción 3: Contenido dinámico

Solución de problemas

Envío por API

Envío desde el panel

Opción 1: Segmentos

Opción 2: Sintaxis Liquid

Opción 3: Contenido dinámico

Envío por API

Panel - Segmentos

Sustitución de tags

Envío desde el panel

Opción 1: Segmentos

Opción 2: Contenido dinámico

Envío por API

Idiomas soportados

​Configurar idioma del usuario

​Enviar mensajes en diferentes idiomas

​Envío desde el panel

​Opción 1: Casillas de verificación

​Opción 2: Importar contenido de idiomas

​Opción 3: Contenido dinámico

​Solución de problemas

​Envío por API

​Envío desde el panel

​Opción 1: Segmentos

​Opción 2: Sintaxis Liquid

​Opción 3: Contenido dinámico

​Envío por API

​Panel - Segmentos

​Sustitución de tags

​Envío desde el panel

​Opción 1: Segmentos

​Opción 2: Contenido dinámico

​Envío por API

​Idiomas soportados

Configurar idioma del usuario

Enviar mensajes en diferentes idiomas

Envío desde el panel

Opción 1: Casillas de verificación

Opción 2: Importar contenido de idiomas

Opción 3: Contenido dinámico

Solución de problemas

Envío por API

Envío desde el panel

Opción 1: Segmentos

Opción 2: Sintaxis Liquid

Opción 3: Contenido dinámico

Envío por API

Panel - Segmentos

Sustitución de tags

Envío desde el panel

Opción 1: Segmentos

Opción 2: Contenido dinámico

Envío por API

Idiomas soportados