Plantillas de mensajes

Se requiere una plantilla de mensaje para abrir conversaciones de marketing, utilidad y autenticación. Estas conversaciones pueden ser mensajes de atención al cliente o recordatorios de citas, actualizaciones de pagos o envíos y alertas, entre otros.

Requisitos

• Para usar una plantilla de mensaje con el fin de abrir una conversación, la plantilla debe estar aprobada. Obtén más información.
• Para abrir conversaciones de marketing, utilidad y autenticación con un cliente, el cliente debe haber aceptado recibir mensajes de tu empresa. Más información.

Categorías de plantillas admitidas

Consulta Categorías.

Traducciones

Al enviar una plantilla de mensaje, debes especificar el idioma en el campo language. Tu empresa es responsable de todas las traducciones que quieras usar.

Idiomas admitidos

Paquetes de idioma

Las plantillas de mensajes se almacenan en paquetes de idioma. Un paquete de idioma es un paquete de elementos de plantillas de mensaje para un idioma o una configuración regional específicos. Si una empresa admite una traducción como mínimo en un idioma o una configuración regional, se crea un paquete para ese idioma o configuración regional.

Un espacio de nombres de plantilla de mensaje es un paquete de paquetes de idioma para una empresa concreta.

Opciones de la política de idioma

Si se envía una plantilla de mensaje con el campo language: policy establecido en deterministic, el valor predeterminado, WhatsApp entrega la plantilla de mensaje exactamente en el idioma y la configuración regional solicitados. A continuación, el dispositivo consulta el servidor para comprobar si hay un paquete de este idioma específico.

Cuando el mensaje se entrega al dispositivo, este hace lo siguiente:

• Comprobación de la política o el código: teniendo en cuenta los valores "policy": "deterministic" y "code": "en", ¿existe un paquete en almacenado en caché en el dispositivo?

  • En caso afirmativo, ve al proceso Comprobación del elemento.
  • Si no es así, ¿puede encontrarse el paquete en en el servidor?

    • En caso afirmativo, actualiza la caché local y ve al proceso Comprobación del elemento.
    • Si no es así, registra el error. A continuación, el servidor devolverá el error structure_unavailable a través de un webhook y no se representará ningún mensaje en el dispositivo.

• Comprobación del elemento: ¿el elemento "element": "hello_world" existe?

  • Si la respuesta es afirmativa, desempaqueta los parámetros y representa el mensaje en el dispositivo.
  • Si no es así:

    • Si el paquete de idioma procede de la caché local, descarga el paquete en más reciente del servidor y repite el proceso Comprobación del elemento.
    • Si el paquete de idioma se descargó recientemente del servidor, registra el error. A continuación, el servidor devolverá el error structure_unavailable a través de un webhook y no se mostrará ningún mensaje en el dispositivo.

La configuración de idioma o configuración regional del dispositivo se ignoran completamente.

Puede producirse un problema cuando usas la directiva deterministic si lo que solicitas no existe. Realiza estas comprobaciones:

• El espacio de nombres es correcto.
• El nombre del elemento es correcto.
• La traducción del idioma o la configuración regional existen para el elemento.
• El número de parámetros enviados coincide con lo especificado en la plantilla de mensaje.

Localización

Las plantillas de mensajes proporcionan compatibilidad con la localización de forma predefinida y permiten localizar el mensaje en función de la configuración regional del dispositivo.

Parámetros localizables

Las plantillas tienen parámetros que se incorporan de manera dinámica en el mensaje. Para el ejemplo usado en este documento, la plantilla de mensaje tiene el aspecto siguiente:

"You made a purchase for {{1}} using a credit card ending in {{2}}."

En el caso de "namespace": "cdb2df51_9816_c754_c5a4_64cdabdcad3e" con "element_name": "purchase_with_credit_card", el primer valor que enumeras reemplaza la variable {{1}} en el mensaje de plantilla y el segundo, la variable {{2}}.

Algunos de estos parámetros (p. ej., date_time o currency) son localizables a fin de que se muestren correctamente según las preferencias de la configuración regional y el idioma del cliente. Si el dispositivo no puede localizar un parámetro correctamente, utiliza el valor de fallback_value de forma predeterminada.

Si necesitas especificar la divisa y la fecha, además del valor de fallback_value, utiliza los objetos currency y date_time. De este modo, el cliente puede localizar de manera óptima estos datos de la mejor forma posible y utilizar el valor de fallback_value de manera predeterminada solo en el caso de que no pueda.

Las opciones localizable_params se muestran en la tabla siguiente:

Parámetros

Objeto currency

El cliente de la API de WhatsApp Business intenta formatear la divisa según la localización especificada.

Ejemplo

{
    "type": "currency",
    "currency" : {
        "fallback_value": "$230.99",
        "code": "USD",
        "amount_1000": 230990
    }
}  

Objeto date_time

El cliente de la API de WhatsApp Business intenta formatear la fecha y la hora según la localización especificada. Algunos formatos de fecha y hora admitidos son los siguientes:

• Hora del componente: la hora se constituye a partir de los componentes (es decir, día de la semana, mes, hora, etc.). La hora especificada será la misma, independientemente de la zona horaria en la que se encuentre el cliente.
• Hora UNIX: la hora mostrada dependerá de la zona horaria en la que se encuentre el cliente.

DateTime

DateTimeComponent

Ejemplo

{
    "type": "date_time",
    "date_time" : {
        "fallback_value": "October 25, 2020",
        "day_of_week": "Saturday",
        "day_of_month": 25,
        "year": 2020,
        "month": 10,
        "hour": 12,
        "minute": 0
    }
}

DateTimeUnixEpoch

Siguientes pasos

Este documento contiene información de referencia sobre plantillas de mensajes. Para obtener una guía sobre cómo crear y enviar una plantilla, consulta Enviar plantillas de mensajes. Para ver todos los parámetros que se pueden utilizar en una plantilla de mensaje, consulta Mensajes, Plantilla de mensaje.

https://developers.facebook.com/docs/whatsapp/message-templates/creation#step-1--create-template-using-the-whatsapp-manager