Centro de ayuda de KWIGA Servicios, integraciones, API, Configuración Servicios Cómo conectar un bot a KWIGA

Cómo conectar un bot a KWIGA

Artículos:

Aprende a conectar un chatbot a KWIGA, configurar integraciones con aplicaciones de mensajería y usarlo para automatizar mensajes y comunicarte con tus clientes.


En este artículo:


En KWIGA, puedes conectar bots y canales de mensajería a través de Telegram, WhatsApp, Facebook Messenger, Instagram Direct y Viber.

Para conectar un bot, abre la sección de configuración correspondiente en tu cuenta de KWIGA, selecciona la aplicación de mensajería, rellena los campos obligatorios y haz clic en «Guardar bot».

1. Telegram

Para conectar un bot de Telegram, introduce:

  • Nombre — el nombre del bot en KWIGA.

  • Token — el token que recibiste en Telegram de @BotFather después de crear el bot.

Importante:

  • No compartas el token con nadie. Permite gestionar el bot.

  • Si el token se ha visto comprometido, revócalo y crea uno nuevo a través de BotFather.

2. WhatsApp

Para conectar WhatsApp, introduce:

  • Nombre — el nombre de la conexión en KWIGA.

  • Token de acceso — un token permanente de usuario del sistema.

  • ID del número de teléfono — el ID del número de teléfono.

  • ID de la cuenta de WhatsApp Business (WABA ID) — el ID de la cuenta de WhatsApp Business.

  • Clave secreta de la aplicación de Meta — la clave secreta de la aplicación de Meta.

Importante antes de conectar

  • El número de teléfono no debe seguir vinculado a la aplicación habitual de WhatsApp ni a la de WhatsApp Business. Desvincúlalo antes de conectarlo siguiendo las instrucciones de integración.

  • Si el número se utiliza con otro proveedor, consulta los requisitos para transferirlo y para la verificación en dos pasos.

  • La aplicación de Meta debe estar en modo Live e incluir un enlace a una política de privacidad.

  • Hasta que Meta complete la verificación de la empresa, la interfaz de KWIGA muestra un límite de 250 clientes nuevos al día como máximo para el envío de mensajes. Antes de publicar, confirma que este límite sigue vigente y a qué se aplica exactamente.

  • Una vez cerrada la ventana de 24 horas desde el último mensaje del cliente, solo puedes enviar plantillas de mensajes aprobadas por Meta.

  • Para contactar con un cliente por primera vez, debes cumplir las normas de WhatsApp sobre el consentimiento del destinatario para recibir mensajes.

Ten en cuenta también que Meta establece las tarifas de los mensajes y puede imponer restricciones según el estado y la calidad de la cuenta.

3. Facebook Messenger

Para conectar Facebook Messenger, introduce:

  • Nombre — el nombre de la conexión en KWIGA.

  • Token de acceso a la página — el token de acceso a la página de Facebook.

  • ID de la página — ID de la página de Facebook.

  • Clave secreta de la aplicación de Meta — clave secreta de la aplicación de Meta.

Importante antes de conectar

  • La aplicación de Meta debe estar en modo activo e incluir un enlace a la política de privacidad.

  • Puedes responder a un cliente con un mensaje normal dentro de las 24 horas posteriores a su último mensaje.

  • Después de ese plazo, las normas de Meta restringen los mensajes normales. Las opciones especiales de mensajería solo están disponibles si se cumplen los requisitos de Meta.

  • La integración requiere los permisos adecuados de la aplicación y acceso a la página de Facebook.

4. Instagram Direct

Para conectar Instagram Direct, introduce:

  • Nombre — nombre de la conexión en KWIGA.

  • Token de acceso de Instagram (de larga duración) — token de acceso.

  • ID de usuario de Instagram — ID de la cuenta profesional de Instagram.

  • Clave secreta de Instagram de la aplicación de Meta — clave secreta de la aplicación de Meta.

Importante antes de conectar

  • La integración requiere una cuenta profesional de Instagram, de empresa o de creador. Las cuentas personales no admiten este tipo de integración mediante API.

  • La aplicación de Meta debe estar en modo activo e incluir un enlace a la política de privacidad.

  • Puedes responder a un cliente con un mensaje normal dentro de las 24 horas posteriores a su último mensaje.

  • La posibilidad de iniciar una conversación, enviar un mensaje o seguir chateando depende de las normas de la API de mensajería de Instagram.

  • La integración requiere que la aplicación tenga los permisos de mensajería necesarios.

5. Viber

Para conectar Viber, introduce:

  • Nombre — nombre del bot en KWIGA.

  • Token del bot de Viber — token obtenido del panel de administración de Viber.

Importante antes de conectar

  • Para crear un chatbot, es necesario registrarse y obtener la aprobación conforme a las condiciones comerciales vigentes de Rakuten Viber.

  • Según el modelo comercial actual de Viber, la tarifa estándar del servicio para un bot nuevo es de 115 € al mes. Los mensajes iniciados por el bot que se entregan generan cargos adicionales. Confirma el coste final con Viber antes de conectar el bot.

  • Según este modelo, los mensajes enviados durante una sesión activa de 24 horas no se cobran individualmente.

  • Una sesión comienza cuando un suscriptor envía un mensaje al bot o responde a un mensaje iniciado por el bot.

  • Los mensajes enviados fuera de una sesión activa están sujetos a las condiciones comerciales de Viber.

Configuración del bot en KWIGA

Después de conectar un bot a KWIGA, puedes configurar su funcionamiento, los mensajes automáticos, los comandos, los botones y otros ajustes para interactuar con los suscriptores.

Los ajustes disponibles dependen de la aplicación de mensajería conectada.

Bandeja de entrada

Configura cómo se gestionan las conversaciones entrantes y el horario de atención del bot.

  • Asignar conversaciones automáticamente — asigna automáticamente las conversaciones a los miembros del equipo por turnos.

  • Horario de atención — establece la zona horaria y el horario de atención.

  • Respuesta automática fuera del horario de atención — envía automáticamente un mensaje a los suscriptores que contacten con el bot fuera de su horario de atención.

Mensajes

Configura los mensajes automáticos que envía el bot en distintas situaciones.

Según las funciones disponibles, puedes configurar un saludo para quienes contacten por primera vez, respuestas a preguntas frecuentes y mensajes sobre el acceso a grupos cerrados.

Comandos

Aquí puedes crear comandos para el bot y configurar las respuestas que reciben los suscriptores al introducirlos.

Los comandos aparecen en el menú del bot y ayudan a los usuarios a encontrar información rápidamente o a realizar una acción. Por ejemplo, puedes crear comandos como «Ayuda», «Mis cursos», «Contactos» o «Soporte».

Para cada comando, puedes establecer su nombre y la respuesta del bot. Para interacciones más complejas —como hacer varias preguntas a los usuarios, recopilar información o realizar acciones—, puedes vincular el comando a una automatización.

También hay comandos del sistema disponibles, como //help, //menu, //stop, //unsubscribe y //subscribe, que gestionan las acciones estándar del bot.

Botones

Configura los botones que los suscriptores pueden usar para interactuar con el bot.

Según las funciones disponibles, puedes configurar un teclado debajo del campo de entrada y botones debajo de los mensajes.

Enlaces

Aquí puedes crear enlaces independientes al bot con etiquetas de origen para saber de dónde llegan los nuevos suscriptores.

Por ejemplo, si compartes un enlace al bot en tu sitio web, en Instagram y en anuncios, crea un enlace independiente para cada origen y asígnale un nombre adecuado: «Sitio web», «Instagram», «Anuncios de Facebook», etc.

Para crear un enlace:

  1. Introduce el nombre del origen.

  2. Haz clic en «Crear enlace».

  3. Copia el enlace generado o descarga el código QR.

  4. Compártelo en el lugar correspondiente.

Cuando alguien sigue el enlace, abre el bot y hace clic en «Iniciar», KWIGA registra el origen. El número de nuevos suscriptores de cada enlace aparece en su configuración y en la sección de análisis «De dónde vienen los suscriptores».

Solo cuentan los nuevos suscriptores: si alguien ya ha interactuado con el bot, no se contabilizará si más adelante sigue otro enlace.

Diagnóstico

Comprueba la conexión entre el bot y KWIGA, consulta su estado y utiliza las herramientas de diagnóstico disponibles.

Las herramientas disponibles dependen de la integración.