Your AI Connector Docs

Viber

Conecta tu propio bot de Viber para que tus conversaciones de Viber fluyan hacia la aplicación y un Agente de IA pueda responder. Te conectas pegando un valor (el token de autenticación de tu bot) y nosotros nos encargamos del resto de la configuración por ti.


¿Qué es la integración de Viber?

La integración de Viber vincula un bot de Viber de tu propiedad a la plataforma utilizando la API oficial de bots de Viber, el propio sistema de Viber para enviar y recibir mensajes automáticamente, en lugar de que los escribas a mano. Las conversaciones entre tu bot y las personas que lo siguen pasan a estar disponibles dentro de la aplicación, y un Agente de IA y una bandeja de entrada compartida funcionan sobre ellas.

Esta es una integración oficial, por lo que es estable y cumple con las normas de Viber.

Disponibilidad. Viber se utiliza más ampliamente en Filipinas, Vietnam y otras partes del sudeste asiático, así como en Europa del Este y Grecia.


Antes de empezar

Necesitas tu propio bot de Viber, y Viber solo emite bots en un plan de negocios de pago. Desde febrero de 2024, Viber ya no crea bots gratuitos. Configuras la cuenta directamente con Viber, y esa cuenta y sus tarifas son un asunto entre tú y Viber. Nosotros no la revendemos, no le añadimos margen ni nos llevamos una comisión, y no podemos crear el bot en tu nombre.

En el momento de escribir este artículo, Viber cobra una tarifa mensual por bot más un cargo por mensaje para los mensajes que inicia tu bot (consulta Coste a continuación). Consulta los términos actuales de Viber cuando te registres, ya que sus precios pueden cambiar.

No existe un formulario de registro de autoservicio. Viber revisa manualmente cada solicitud de chatbot, y puede realizarla de dos maneras:

  • A través de un socio verificado de Viber, que es la vía que Viber recomienda y, por lo general, la más rápida.
  • Directamente con Viber, enviando un correo electrónico a partners@viber.com. Si ya trabaja con Viber, su gestor de cuenta empresarial puede iniciar el proceso en su lugar.

Una vez que se apruebe su solicitud, firmará el acuerdo de Viber y aceptará sus términos comerciales, y su bot será creado.

Después de eso, encontrará su token en la aplicación Viber en Más → Ajustes → Bots → Editar información → Su clave de aplicación. Viber lo llama clave de aplicación; su documentación de API llama al mismo valor token de autenticación, y los administradores de bots también pueden verlo en el propio panel de administración de Viber. Independientemente de cómo esté etiquetado, es el único valor que esta aplicación solicita.

Ese token es lo único que necesita de Viber. La configuración aquí toma alrededor de un minuto.


Configuración de Viber

Paso 1: Copia el token de autenticación de tu bot

El lugar más rápido para encontrarlo es la aplicación Viber en su teléfono.

  1. Abra Viber en el teléfono cuya cuenta es propietaria del bot.
  2. Vaya a Más → Ajustes → Bots.
  3. Seleccione su bot y toque Editar información.
  4. Copie el valor que aparece en Su clave de aplicación. Ese es el token.

Mantén este token en privado. Cualquiera que lo tenga puede enviar mensajes como tu bot.

Paso 2: Conecta Viber en la aplicación

  1. En la barra lateral izquierda, haz clic en Settings (Configuración) cerca de la parte inferior.
  2. En el panel izquierdo de Settings, bajo Channels (Canales), haz clic en Channels.
  3. Busca la tarjeta Viber y haz clic en Connect (Conectar).
  4. Pega tu auth token (token de autenticación).
  5. Haz clic en Connect.
  6. La aplicación verifica el token con Viber y muestra “Connected to: <tu nombre de bot>”.

No hay ningún webhook que configurar. A diferencia de la mayoría de los otros canales, nosotros registramos todo en Viber por ti como parte de la conexión, por lo que no hay nada que copiar en otra consola. La pantalla de conexión muestra la dirección a la que llegan tus mensajes simplemente para que puedas compartirla con el soporte técnico si alguna vez lo necesitas.

Paso 3: Probar el bot

  1. Desde otro teléfono, abre Viber y sigue a tu bot (búscalo o usa su enlace).
  2. Envíale un mensaje.
  3. Abre la aplicación y ve a Chats. El mensaje entrante aparecerá en la lista de conversaciones.
  4. Si un agente de IA está gestionando este canal, verás que responde automáticamente.

Una vez conectado, tu bot de Viber aparecerá como Connected (Conectado) en la página de Channels y la IA responderá a los mensajes entrantes.


A quién puede enviar mensajes tu bot

Esto es lo más importante que debes entender sobre Viber, y es diferente a cualquier otro canal:

Tu bot solo puede enviar mensajes a las personas que lo siguen. Alguien tiene que encontrar tu bot y seguirlo antes de que puedas enviarle algo. No hay forma de enviar un mensaje a un usuario de Viber que no haya seguido a tu bot primero.

Si alguien deja de seguir o bloquea a tu bot, no podrás enviarle mensajes de nuevo hasta que lo siga y te envíe un mensaje. Cuando eso sucede, la aplicación marca la conversación para que deje de intentarlo, y cualquier respuesta que envíes aparecerá como fallida con una explicación en lugar de desaparecer silenciosamente.

Debido a esto, Viber funciona muy bien como canal de soporte y respuesta (alguien te envía un mensaje, la IA responde) y mal como canal de contacto en frío.


Coste

Viber es un canal gratuito en la aplicación: no hay cargo por mensaje ni tarifa de conexión mensual por nuestra parte.

Tus costos provienen de Viber, en tu propia cuenta:

  • Una tarifa mensual por bot (alrededor de 100 € en el momento de escribir este artículo).
  • Las respuestas dentro de una conversación iniciada por alguien son gratuitas e ilimitadas. Esto cubre casi todo lo que hace un agente de IA.
  • Los mensajes que inicia tu bot, fuera de una conversación que la persona comenzó, se cobran por mensaje a una tarifa que depende del país del destinatario.

La conclusión práctica: responder a las personas no te cuesta nada más allá de la tarifa mensual. Las difusiones y los seguimientos proactivos son los que aumentan los costos.


Mensajes multimedia

Las fotos, videos, archivos, stickers, ubicaciones y contactos compartidos entrantes son reconocidos para que la IA sepa que se envió contenido multimedia (se añade una nota breve a la conversación). Las respuestas salientes de la IA son texto e imágenes en esta versión. Las respuestas largas se recortan automáticamente al límite de 7000 caracteres de Viber.


Gestión de sesiones

Comprobación del estado de la conexión

El estado de tu conexión de Viber se muestra en la tarjeta Viber en la página Channels:

Estado Significado
Conectado Un bot de Viber está vinculado a esta cuenta
Conectado, requiere acción Otra herramienta ha tomado el control de tu bot; los mensajes no nos están llegando
No conectado No hay ninguna conexión configurada

La tarjeta vuelve a comprobar tu bot cada vez que abres la página de Canales. Un bot de Viber solo puede enviar sus mensajes a un lugar a la vez, por lo que si conectas el mismo bot a otra herramienta, esa herramienta toma el control y tus mensajes dejan de llegar aquí, sin previo aviso por parte de Viber. Eso es lo que significa “Conectado, requiere acción”. Abre la tarjeta y vuelve a conectar para recuperar el control.

Desconexión

Abre la tarjeta de Viber y haz clic en Gestionar, luego haz clic en Desconectar y confirma en ¿Eliminar Viber?. Esto evita que recibamos los mensajes del bot y lo elimina de tu cuenta. Tu bot seguirá siendo tuyo. Nada cambia en tu cuenta de Viber.


Limitaciones

  • Solo seguidores. Tu bot solo puede enviar mensajes a las personas que lo siguen. Consulta A quién puede enviar mensajes tu bot.
  • Necesitas tu propio bot de Viber de pago. Nosotros no podemos proporcionarte uno.
  • Un bot por conexión. Conecta cada bot por separado; un bot solo puede estar vinculado a una cuenta.
  • Envío de texto + imagen. La IA responde con texto e imágenes; en esta versión no se envían carruseles ni tarjetas enriquecidas.
  • Sin mensaje de bienvenida. Cuando alguien abre tu bot por primera vez pero aún no lo ha seguido, Viber permite un saludo instantáneo. Esta versión no envía ninguno. La conversación comienza cuando envían su primer mensaje.

Solución de problemas

Token rechazado al conectar

  • Asegúrate de haber copiado el valor de Editar información → Tu clave de aplicación en la aplicación Viber, no un ID diferente.
  • Comprueba que tu bot siga activo en tu cuenta de Viber.
  • La conexión también verifica que Viber pueda comunicarse con nosotros. Si tu token es definitivamente correcto y sigue fallando, espera un minuto e inténtalo de nuevo; si persiste, contacta con el soporte técnico.

“Este bot de Viber ya está conectado a otra cuenta”

El mismo bot está vinculado a una cuenta diferente en la aplicación. Desconéctalo allí primero o utiliza un bot diferente.

El bot no responde

  • Confirma que la tarjeta muestra Conectado, no Conectado, requiere acción.
  • Confirma que la persona con la que estás haciendo la prueba ha seguido a tu bot. Viber solo entrega mensajes de seguidores.
  • Comprueba que haya un Agente de IA asignado a este canal.

Los mensajes han dejado de llegar

Esto es casi siempre el problema de toma de control descrito en Comprobar el estado de la conexión: el mismo bot se conectó a otra herramienta. Abre la tarjeta de Viber y vuelve a conectar.

Una respuesta falló con “No suscrito”

La persona dejó de seguir o bloqueó tu bot. No puedes enviarle mensajes hasta que vuelva a seguirlo y te envíe un mensaje primero.


Mejores prácticas

  • Prioriza el soporte, no la prospección. Las respuestas dentro de una conversación iniciada por alguien son gratuitas e ilimitadas; los mensajes que tú inicias tienen coste y solo llegan a los seguidores.
  • Haz que tu bot sea fácil de seguir. Pon su enlace en tu sitio web, en tu firma de correo electrónico y en tus otros canales. Seguirlo es la única forma en que las personas pueden contactarlo.
  • Mantén tu token de autenticación seguro. Cualquiera que lo tenga puede enviar mensajes como tu bot. Si se filtra, regenera el token en la aplicación Viber y luego vuelve a conectarlo aquí.
  • No conectes el mismo bot a dos herramientas. La segunda tomará el control silenciosamente.