Canal Viber – transaccional
El objeto del canal Viber para Advanced transactional. Se incluye en el objeto channel bajo la clave viber; consulte Cascada de canales.
Los mensajes promocionales utilizan un objeto de Viber distinto bajo la misma clave: lleva un botón y una imagen en lugar de plantillas. Consulte Viber – promocional.
Objeto Viber
| NOMBRE DEL PARÁMETRO | VALOR | OBLIGATORIO | VALOR PREDETERMINADO |
|---|---|---|---|
| text | Texto del mensaje de Viber. Sustituye al text de nivel superior; consulte Qué texto se utiliza |
No | null |
| sender | Remitente de Viber registrado. Primero debe registrarse. Para el registro, póngase en contacto con el soporte aquí | Sí | - |
| expiration | Límite de tiempo en segundos tras el cual se utiliza el siguiente canal de la cascada. Los valores inferiores a 60 se ignoran y se sustituyen por el valor predeterminado |
No | 300 |
| template_id | Clave de una plantilla de Viber aprobada precedida de @ (p. ej. @order-confirmation) o el ID de la plantilla en Viber. Si se rellena, el mensaje se envía como plantilla y text no se utiliza |
No | null |
| template_language | Código de la versión de idioma de la plantilla. La mayoría de los idiomas tienen un código de dos letras (cs, en); las excepciones son fr_FR, es_ES, pt_BR, pt_PT, zh-Hans y zh-Hant |
No | en |
| template_parameters | Array asociativo de parámetros de la plantilla, p. ej.: {"code": "0451"} |
No | [] |
Lo que cambia el mensaje a plantilla es template_id, no use_template. El parámetro use_template se sigue aceptando por compatibilidad con versiones anteriores, pero en este endpoint no tiene ningún efecto.
Todo mensaje transaccional de Viber debe basarse en una plantilla aprobada previamente por Viber. Cómo registrar una plantilla se describe en la página Registro de plantillas de Viber.
Sin template_id, el mensaje no se factura a la tarifa transaccional. Un mensaje de Viber enviado a través de este endpoint sin plantilla sale a la tarifa promocional; solo un mensaje basado en una plantilla aprobada se factura como transaccional.
Ejemplo de solicitud completa
Primero Viber y SMS como alternativa. El text de nivel superior lo utilizan ambos tramos de la cascada; expiration indica cuánto esperamos a Viber antes de pasar a SMS.
El mismo mensaje como plantilla aprobada. template_id cambia el tramo de Viber a la plantilla, de modo que el text de nivel superior solo llega al tramo de SMS, y el tramo de Viber se factura a la tarifa transaccional.
La respuesta es la misma para todos los canales; consulte Advanced transactional.
Gracias por su opinión.