Registro de plantillas de Viber

Los mensajes transaccionales de Viber se envían mediante plantillas aprobadas previamente por Viber. La plantilla se registra directamente en el portal: rellena el texto y las variables, el portal la envía a Viber para su aprobación y, una vez aprobada, puede utilizarla en los módulos y en la API. Cómo se facturan las plantillas se describe en la página Tipos de mensajes de Viber.

Antes de empezar

Una plantilla siempre se registra bajo un remitente de Viber concreto, por lo que primero necesita un remitente de Viber registrado. Mientras no lo tenga, la sección de plantillas solo muestra un aviso en lugar del formulario.

Crear una plantilla

1. En el portal, abra Mensajería SMS y Viber → Viber templates.
2. Haga clic en New template.
3. Rellene el formulario según la tabla siguiente y, si es necesario, añada variables.
4. Haga clic en Crear. El portal envía la plantilla a Viber para su aprobación.

Para un mismo remitente, una misma clave no puede tener dos plantillas en el mismo idioma. Otro idioma se añade a la misma plantilla como versión de idioma.

Variables

Una variable es un lugar del texto que se sustituye por un valor concreto al enviar el mensaje, por ejemplo un número de pedido.

• La variable se añade con el botón Agregar variable. Una plantilla puede tener como máximo 8.
• Para cada una rellena el Nombre de la variable (máx. 50 caracteres) y un Example value (valor de ejemplo, máx. 125 caracteres). El ejemplo es obligatorio: se envía a Viber junto con la plantilla para su aprobación.
• En el texto, la variable se escribe como {{nombre}}. Puede escribirla a mano o insertarla con el botón {} situado junto a la variable: se inserta al final del texto.

Texto de ejemplo con dos variables, numero y fecha:

Su pedido {{numero}} ha sido enviado y se lo entregaremos {{fecha}}. Gracias por su compra.

Reglas para las variables

• Todas las variables de la lista deben utilizarse en el texto.
• El texto no puede contener {{…}} con un nombre que no esté en la lista de variables.
• Una variable no puede estar al principio del texto. En el tipo Transactional tampoco puede estar al final.

Plantilla OTP

En el tipo OTP, el propio portal añade la variable pin con el valor de ejemplo 0451. En ella se introduce el código de verificación al enviar el mensaje. La variable pin no se puede renombrar ni eliminar y debe utilizarse en el texto. A diferencia de la plantilla transaccional, también puede estar al final del texto.

Aprobación de la plantilla

Una vez creada, la plantilla aparece en la lista. Para cada versión de idioma verá su texto, su estado y, junto al estado, el ID de la plantilla en Viber.

• Pendiente: Viber todavía está revisando la plantilla.
• Approved: puede utilizar la plantilla.
• Una plantilla rechazada no ha sido aprobada por Viber y no se puede utilizar.

El estado de la lista cambia por sí solo en cuanto Viber revisa la plantilla.

Ni una plantilla aprobada ni una rechazada se pueden editar en el portal. Para cambiar el texto, elimine la versión de idioma y vuelva a crearla con la misma clave: el nuevo texto pasa de nuevo por la aprobación.

Versiones de idioma

Una plantilla puede tener su texto en varios idiomas. Otro idioma se añade con el icono ⊕ Add language version situado junto a la plantilla en la lista. La clave, el nombre, el remitente y el tipo se mantienen: solo elige el idioma, escribe el texto y rellena las variables.

Cada versión de idioma se aprueba por separado y tiene su propio estado. Al enviar, siempre elige una versión de idioma concreta.

Una versión de idioma se elimina con el icono de la papelera situado junto a ella. Tras confirmarlo, se elimina tanto en el portal como en Viber.

Uso de una plantilla

En los módulos

En la sección Módulos y APIs, abra la configuración de las notificaciones y, para el canal de Viber, cambie el texto del mensaje de texto libre a una plantilla registrada. Después selecciónela en la lista: solo se ofrecen las plantillas aprobadas del remitente configurado para la notificación, cada versión de idioma por separado.

Para cada variable de la plantilla se muestra un campo en el que puede insertar variables del módulo. Si deja el campo vacío, se utiliza el valor de la variable del módulo con el mismo nombre. Verá el resultado en la vista previa debajo de los campos.

A través de la API

En la API transaccional avanzada, la plantilla se envía en el objeto viber con estos parámetros:

La mayoría de los idiomas tienen un código de dos letras (cs, sk, en, de…). Las excepciones son el francés fr_FR, el español es_ES, el portugués pt_BR y pt_PT, y el chino zh-Hans y zh-Hant.

La API no enviará el mensaje a través de la plantilla si la plantilla no existe, no tiene la versión de idioma solicitada, no está aprobada o no recibe todas sus variables.