Viber
Longitud máxima del mensaje de texto: 1000 caracteres
Viber no permite recuperar automáticamente el número de teléfono del cliente.
Cómo Conectar Viber
Versión Antigua
Esta versión solo es aplicable a usuarios que crearon su chatbot antes del 5 de febrero de 2024.
Si aún no has creado un bot de Viber (después del 5 de febrero de 2024), dirígete a la sección Nueva Versión.
Primero, sigue el enlace a continuación e inicia sesión en el sitio web.
https://partners.viber.com/login?returnUrl=%2Faccount

A continuación, crea una Cuenta Pública para tu bot.
Elige una imagen y completa todos los campos obligatorios.

| Campo | Descripción |
|---|---|
| Nombre de la cuenta | Nombre del bot. Se puede cambiar más tarde. |
| Uri | Nombre de usuario del bot. Se utiliza para generar enlaces del bot. |
| Categoría | Especifica la categoría de tu negocio (por ejemplo, Negocio Local). |
| Subcategoría | Especifica la subcategoría del negocio (por ejemplo, Negocio Automotriz). |
| Idioma | Idioma del bot. |
| Descripción de la cuenta | Descripción del bot visible para todos los suscriptores. |
| Dirección del sitio web | Tu sitio web. |
| Dirección de correo electrónico | Dirección de correo electrónico de contacto. |
| Ubicación | Ubicación del negocio. |
Hay un interruptor en el formulario de registro llamado "La cuenta contiene contenido para adultos."
¡NO HABILITES ESTA OPCIÓN!
De lo contrario, todos los usuarios verán una advertencia antes de abrir tu bot indicando que contiene contenido para adultos.

Acepta el acuerdo de licencia y haz clic en Crear.

Si todo se ha completado correctamente, recibirás el token de tu bot.
Lo necesitarás para el siguiente paso.

Tu bot ya está listo.
El único paso restante es conectarlo a Salebot.
Ve a la sección Canales y selecciona Viber.
Ingresa el token que recibiste.

Haz clic en Listo para conectar el bot a Salebot.
Recibirás una notificación en la aplicación móvil de Viber confirmando que el bot ha sido creado junto con la información proporcionada durante el registro.
Nueva Versión (Disponible desde el 5 de febrero de 2024)
A partir del 5 de febrero de 2024, Viber cambió las condiciones para crear y conectar chatbots.
El servicio ahora es de pago.
Los chatbots creados antes de esta fecha continúan operando bajo las condiciones anteriores.
Lee más aquí.
Según la oferta comercial de Viber, se cobra una tarifa de €100 por cada chatbot creado o conectado.
Cada mensaje enviado por el bot está incluido en la tarifa mensual que paga el cliente.
El precio de cada mensaje depende del país de destino.
Por ejemplo:
- Rusia — €0.0196
- Bielorrusia — €0.0138
- Ucrania — €0.0196
- Kazajistán — €0.0137
Si el número de mensajes excede el límite cubierto por la tarifa mensual de €100, se pueden aplicar cargos adicionales.
Para más información, consulta las secciones Tarifa y Tarifas de la documentación de Viber.
Para conectar un chatbot a Viber, debes enviar una solicitud bajo los términos comerciales.
El formulario de solicitud tiene el siguiente aspecto.
El formulario de solicitud debe completarse en inglés.
El formulario de ejemplo traducido (Figura 2 arriba) se proporciona solo como referencia.
En el campo Su consulta, especifica que deseas conectar un chatbot ya creado.
Después de enviar la solicitud, los especialistas de Viber la revisarán individualmente y proporcionarán instrucciones para los siguientes pasos de integración.
Antes de enviar la solicitud, lee la oferta comercial de Viber sobre la creación y conexión de chatbots.
Cómo Obtener un Enlace a tu Bot de Viber
El enlace del bot está disponible inmediatamente después de que el bot se conecta.
Debido a las limitaciones de Viber, los bots no se pueden encontrar a través de la búsqueda de Viber.
Los usuarios solo pueden abrir un bot usando su botón o enlace directo.
Los enlaces internos
viber://no son reconocidos por muchos navegadores o aplicaciones.Si deseas distribuir tu bot, puedes:
- usar páginas de aterrizaje mini de MaviBot;
- acortar el enlace usando un servicio como:
Cómo Crear un Carrusel en Viber

- Viber admite hasta 6 tarjetas en un carrusel.
- Viber permite usar botones de colores.
Formatos de imagen admitidos
- JPEG
- PNG
Tamaño máximo de imagen
- 500 KB
Veamos un ejemplo de un carrusel que contiene 3 tarjetas.
Para crear las tarjetas, ingresa el siguiente código en el campo Calculadora:
p =[{"title":"TITLE 1", "description": "DESCRIPTION ", "image": "IMAGE LINK 1", "buttons":[{"text":"BUTTON TEXT 1","color":"#4BB34B"}]}, {"title":"TITLE 1", "description": "DESCRIPTION ", "image": "IMAGE LINK 1", "buttons":[{"text":"BUTTON TEXT 1"}]}, {"title":"TITLE 2", "description": "DESCRIPTION ", "image": "IMAGE LINK 2", "buttons":[{"text":"BUTTON TEXT 2", "url":"LINK"}]}, {"title":"TITLE 3", "description": "DESCRIPTION", "image": "IMAGE LINK 3", "buttons":[{"text":"BUTTON TEXT 3"}]}]
r = send_carousel(p, '')
Primero, guarda el array que contiene title, description, image y buttons en la variable p (puedes usar cualquier nombre de variable). Luego úsalo en el método send_carousel(p, '').
Para que un botón sea de color, agrega el parámetro adicional "color":"#4BB34B" al array buttons.
El color debe especificarse como un valor hexadecimal que comience con #.
Puedes elegir cualquier color usando un selector de color, por ejemplo:
Puedes insertar URL en los botones de las tarjetas del carrusel usando el parámetro url. Cuando el cliente haga clic en el botón, será redirigido al enlace especificado, y el enlace también se recibirá como un mensaje.
Los botones de las tarjetas del carrusel también pueden incluir el parámetro payload. Este parámetro no se muestra al cliente, pero permite analizar la selección del cliente.
[
{
"title":"TITLE 1",
"description":"DESCRIPTION",
"image":"IMAGE LINK 1",
"buttons":[
{
"text":"BUTTON TEXT 1",
"color":"#4BB34B",
"url":"BUTTON LINK",
"payload":"1"
}
]
}
]
Si usas botones con texto idéntico, puedes usar el parámetro payload. No es visible para el cliente, pero permite analizar la opción seleccionada por el usuario.
Consejos y Mejores Prácticas para Bots de Viber
Al crear bots de Viber, hay varias características importantes que debes tener en cuenta.
Comprender estas te ahorrará tiempo y te ayudará a aprovechar al máximo las capacidades de Viber.
Cómo Configurar el Primer Mensaje y Crear un Botón de Llamada a la Acción
Al contactar a un usuario por primera vez, Viber permite a los bots enviar solo un mensaje hasta que el usuario responda.
Por lo tanto, tan pronto como un usuario abre tu bot usando el enlace del bot, recibe automáticamente el primer mensaje.
En este mensaje, debes pedir al cliente que:
- presione un botón; o
- envíe cualquier mensaje.
De lo contrario, ninguno de tus mensajes posteriores se entregará.
Una vez que el usuario responda, puedes enviarle una cantidad ilimitada de mensajes.
El primer mensaje motivacional para Viber se configura en la configuración del proyecto.
Los botones incrustados dentro del texto del mensaje no se envían cuando el usuario abre el bot.
Solo se deben usar botones del teclado.
Después de la primera acción del usuario, puedes enviar cualquier contenido sin restricciones.
Ejemplo de cómo se ve el primer mensaje después de abrir el bot:
Cómo Probar el Primer Mensaje de Nuevo
Realiza estos pasos cada vez que pruebes el primer mensaje.
Para hacer esto:
- Elimina la conversación de la sección Clientes en el constructor.
- Elimina la conversación con el bot haciendo clic en Eliminar y Cancelar Suscripción.
Después de eso, abrir el bot nuevamente usando el enlace activará el mensaje de bienvenida una vez más.
Posibles Errores de Viber
Si ves la siguiente notificación en la conversación con un cliente en la sección Clientes, puede significar una de las siguientes:
- El usuario canceló la suscripción a tus mensajes (bloqueó el bot en su cuenta de Viber).
- Enviaste el segundo (o posterior) mensaje antes de que el usuario respondiera a tu primer mensaje.
- Tu primer mensaje contiene botones dentro del texto.
Construye el flujo de tu conversación para que después del primer mensaje el usuario responda o configura el campo Responder al primer mensaje del usuario en la configuración del constructor.
Pide al usuario que te envíe una respuesta o presione un botón.
El primer mensaje puede contener solo botones del teclado.
No se permiten botones dentro del texto del mensaje.
Cómo Iniciar una Conversación Correctamente
El bloque que contiene #{none} es obligatorio.
Activa el bot sin consumir el límite para enviar el primer mensaje de Viber.
A continuación, compara el valor de la variable client_type, que almacena el identificador numérico interno del mensajero.
Para Viber:
client_type = 2