🤖 Documentación: Bot

🤖 Definición — Módulo Bot

El Bot es un constructor de flujos omnicanal: usted diseña la conversación una vez (con nodos: menú IVR, asistente de IA, buzón de voz, transferencia, traspaso a asesor, consulta de datos…) y la activa en cualquiera de sus 5 canales. Todo lo atendido queda en una bandeja unificada.

5 canales para activar un bot: Voz (VoIP), Voz WhatsApp, SMS, WhatsApp y Email.

Nota — Voz: Voz (VoIP) y Voz WhatsApp son técnicamente el mismo bot de voz (mismo flujo, IVR, IA y buzón); la única diferencia es por dónde entra la llamada — la red telefónica o WhatsApp.

🗺️ Diagramas por canal

El mismo motor de flujos atiende cada canal; solo cambia por dónde entra la conversación.

📞 Voz (VoIP)

🟢 Voz WhatsApp

💬 SMS

🟢 WhatsApp

📧 Email

Voz (VoIP) y Voz WhatsApp usan el mismo bot de voz (mismo flujo: IVR, IA, buzón); en SMS, WhatsApp y Email el mismo motor da la auto-respuesta.

📘 Explicación (paso a paso)

El módulo tiene 4 pestañas: Asignar (elija el número y asigne el flujo por canal), Flujos (su biblioteca de flujos y a qué números están aplicados), Crear (plantillas de ejemplo → editor) y Bandeja (log omnicanal).

1. Crear: en la pestaña Crear elija una plantilla de ejemplo (o "desde cero"). El flujo se abre en el editor ahí mismo para verlo, analizarlo y modificarlo; las plantillas quedan siempre visibles (con su descripción) para cambiar entre ellas.
2. Agregue nodos: menú (IVR), asistente de IA, idioma, horarios, captura de datos, consulta de datos (saldo/factura/cuenta), verificación por código, encuesta, buzón de voz, transferencia a cola/extensión, traspaso a asesor, traspaso guiado a WhatsApp, notificación y terminar.
3. Al tocar Guardar flujo se crea un flujo nuevo en su biblioteca (le pide el nombre; la plantilla original no se toca) y pasa a Flujos. Desde Asignar (o Flujos → Aplicar) asigne el flujo a los canales por número: Voz, Voz WhatsApp, SMS, WhatsApp o Email. Un mismo flujo puede compartirse en varios números — al editarlo, cambia en todos.
4. Configure las notificaciones del flujo (buzón de voz → email y/o WhatsApp) con un check para activar/probar.
5. Revise la Bandeja Bot: log omnicanal (voz, SMS, WhatsApp, Email) con el resultado de cada interacción y el audio del buzón.

Ayuda en línea: el constructor incluye ayuda en línea para armar y editar los flujos de llamada y de conversación.

🔎 Autoservicio: Consulta de datos

El nodo Consulta de datos permite que quien llama se atienda solo: el bot lo identifica (por el número que llama o pidiéndole su número de cuenta), le pide un PIN y le entrega sus datos —por ejemplo saldo, factura y cuenta— leídos por voz o enviados por mensaje.

Fuentes de datos (se eligen por cliente):

Datos que puede entregar: cuenta, nombre, saldo, factura (monto, vencimiento, estado) y campos adicionales. Prueba integrada: cada conexión tiene un botón Probar que valida el acceso y muestra los datos de ejemplo, sin exponer credenciales ni el PIN.

Seguridad: conexiones de solo lectura, PIN nunca leído en voz alta, credenciales cifradas y consultas parametrizadas.

💬 Traspaso guiado a WhatsApp

Desde una llamada de voz, el bot puede continuar la conversación por WhatsApp: le envía un WhatsApp a quien llama y, al responder, la charla sigue por WhatsApp con el contexto de la llamada (nombre, cuenta, datos ya consultados). Así el cliente no repite nada.

Requiere que el cliente tenga un número WhatsApp con bot. El primer mensaje se envía como plantilla aprobada; al responder, la conversación queda abierta y el bot continúa en el punto indicado.

🎬 Video: recorrido por el Bot (edición)

Unos cuatro minutos: entrar con seguridad, las cuatro pestañas, elegir el flujo de un número, partir de una plantilla o desde cero, la paleta de nodos y cómo armar un flujo en el lienzo, el editor de nodos, pedirle una propuesta al Asistente IA, guardar con aviso de nombre repetido, deshacer con las versiones anteriores y qué pasa con un flujo compartido. Tiene narración: active el sonido.

Datos de ejemplo: empresa, usuaria y números ficticios. La pantalla del Bot no tiene traductor: sale en español también en el video en inglés — solo la narración y las tarjetas de texto están en inglés. Vista de quien PUEDE editar (administrador o supervisor con el módulo Bot habilitado); hoy ningún supervisor lo tiene todavía. Toque la imagen para verla en tamaño completo.

🤖 De un vistazo: 4 pestañas

Asignar, Flujos, Crear y Bandeja: todo el Bot vive en estas cuatro pestañas.

Datos de ejemplo: empresa, usuaria y números ficticios. La pantalla del Bot no tiene traductor: sale en español también en la versión en inglés — solo el menú y la cabecera se traducen. Toque la imagen para verla en tamaño completo.

1. 1
   Bot — Motor de flujos omnicanal

   El título resume el módulo: el flujo se crea y edita aquí; Telefonía solo enruta.

2. 2
   Asignar

   Elija el número y actívele los canales que debe atender.

3. 3
   Flujos

   Su biblioteca: cada flujo guardado, en qué números se usa y cuántos nodos tiene.

4. 4
   Crear

   Plantillas de ejemplo que abren directo en el editor para verlas, analizarlas y modificarlas.

5. 5
   Bandeja

   El registro unificado de voz, WhatsApp, SMS y correo que el bot atendió.

📌 Elegir el flujo de un número

Paso 1: el número. Paso 2: los canales que atiende y el flujo de cada uno.

Datos de ejemplo: empresa, usuaria y números ficticios. Toque la imagen para verla en tamaño completo.

1. 1
   Número o Email

   Elija el número (DID) o la cuenta de correo — solo uno a la vez.

2. 2
   Servicios

   Marque los canales que atiende este número. Puede activar varios a la vez.

3. 3
   Canales y flujo

   Voz, WA Voz, WhatsApp, SMS y Email — cada uno con el flujo que le corresponde; un mismo flujo puede repetirse en varios canales.

🧰 Partir de una plantilla, o desde cero

13 plantillas listas para ajustar — recepción con Asistente IA, IVR bilingüe, menús a colas o extensión, WhatsApp, agendar cita, y más — o un lienzo en blanco.

Datos de ejemplo: empresa, usuaria y números ficticios. Toque la imagen para verla en tamaño completo.

1. 1
   Desde cero

   Un lienzo en blanco, para armar el flujo nodo por nodo.

2. 2
   Las plantillas

   12 ejemplos reales: recepción con Asistente IA, IVR bilingüe (ES/EN), menús a colas o a una extensión, buzón de voz, WhatsApp con Asistente IA, colas de agentes y agendar cita. Cada tarjeta muestra una vista previa de sus nodos.

3. 3
   Usar plantilla

   Abre esa plantilla en el mismo editor del paso 4, lista para ajustar. El original no cambia: lo que edite queda en su propio flujo nuevo al guardar.

🎨 La paleta de nodos

Agrupada por tipo, sobre el lienzo: clic para colocar, arrastre el cuerpo para mover, arrastre su punto hasta otro nodo para conectarlos.

Datos de ejemplo: empresa, usuaria y números ficticios. Toque la imagen para verla en tamaño completo.

1. 1
   7 grupos

   Mensaje y voz · Menús y captura · Datos y lógica · Horarios y ruteo · Transferencias · Utilidades · Fin.

2. 2
   Agregar nodo, Limpiar, Refrescar

   Junto al conteo de nodos y el enlace a versiones anteriores.

3. 3
   Cómo se arma

   Clic en un chip para colocar ese nodo; arrastre el CUERPO de una tarjeta para reubicarla; arrastre desde su PUNTO (○) hasta otro nodo para conectarlos — así se dibujan las flechas.

⚠️ Consulta de datos, API externa y Consulta BD aparecen en la paleta para cualquier persona, pero son de uso interno de TelHarbor: hoy el servidor rechaza el guardado completo del flujo (con un error técnico) si un cliente coloca uno de estos tres nodos. No arme un flujo con ellos: pídalo por la Mesa de Ayuda.

🗂️ Un flujo ya armado

Cada tarjeta es un nodo; las flechas muestran hacia dónde va cada salida.

Datos de ejemplo: empresa, usuaria y números ficticios. Toque la imagen para verla en tamaño completo.

1. 1
   Salidas etiquetadas

   El menú principal muestra 1, 2, 3 (sus opciones), «t/o» (tiempo agotado) e «inv» (respuesta inválida); el horario muestra abierto/cerrado/feriado. Cada punto (○) es una salida distinta del nodo.

2. 2
   Inicio

   La píldora verde marca el nodo de entrada del flujo.

🧩 El editor de nodos

Un clic en cualquier tarjeta del diagrama abre su detalle para editarlo.

Datos de ejemplo: empresa, usuaria y números ficticios. Toque la imagen para verla en tamaño completo.

1. 1
   Editar nodo

   El título dice cuál paso del flujo está abierto.

2. 2
   Clave (id único)

   El identificador del paso; otros nodos lo usan para apuntar aquí (por ejemplo, una opción del menú).

3. 3
   Tipo de nodo

   Menú IVR, Asistente IA, transferencia, buzón de voz, consulta de datos, y más — agrupados por categoría.

✨ El Asistente IA propone, usted decide

Descríbalo en sus palabras; la propuesta se revisa antes de cargarla en el diagrama, y nada se guarda hasta "Guardar flujo".

Datos de ejemplo: empresa, usuaria y números ficticios; la propuesta de este documental es simulada. Toque la imagen para verla en tamaño completo.

1. 1
   ¿Qué debe hacer este flujo?

   Descríbalo en sus palabras. El aviso dice qué se envía: solo puede usar extensiones, colas, números y correos de su propia empresa.

2. 2
   La propuesta

   Un resumen de lo que armó y cuántos nodos propuso.

3. 3
   Advertencias

   Lo que descartó y por qué — por ejemplo, una extensión que no es de su empresa. Revíselas antes de guardar.

4. 4
   Cargar en el diagrama

   Recién ahí se dibuja la propuesta; hasta ese momento no se ha tocado nada.

Techo de 30 solicitudes por empresa al día. El diccionario de pronunciación sigue siendo exclusivo de TelHarbor.

💾 Guardar, con aviso si hay otros números

Si el flujo también lo usan otros números, se avisa antes de guardar — y el cambio se aplica a todos a la vez.

Datos de ejemplo: empresa, usuaria y números ficticios. Toque la imagen para verla en tamaño completo.

1. 1
   El flujo en edición

   Se guarda desde el número elegido en el paso 1 — no desde "Sus flujos" (ahí se edita por su propio id y no dispara este aviso).

2. 2
   El aviso

   Aparece ANTES de guardar, con la lista exacta de los otros números que comparten ese flujo por nombre.

↺ Versiones anteriores: deshacer

Cada guardado queda registrado; puede restaurar cualquier versión anterior, hasta las últimas 20.

Datos de ejemplo: empresa, usuaria y números ficticios. El enlace "Ver versiones anteriores" está junto al Asistente IA, sobre el diagrama. Toque la imagen para verla en tamaño completo.

1. 1
   Fecha, quién y vía

   Cuándo se guardó, quién lo hizo, y por qué camino: guardado manual, Asistente IA, aplicar/asignar flujo, clonar o restaurar.

2. 2
   Nodos

   Cuántos nodos tenía el flujo en ese momento.

3. 3
   Restaurar

   Pide confirmar. El estado actual se guarda antes de reemplazarlo, así que restaurar también se puede deshacer.

🔗 Un flujo compartido de otra empresa

No se edita ahí directamente: se ofrece "Guardar como" para hacer su propia copia.

Datos de ejemplo: empresa, usuaria y números ficticios. Toque la imagen para verla en tamaño completo.

1. 1
   El aviso

   «Es un flujo compartido de otra empresa. No se puede editar aquí» — aparece al elegir ese flujo en la comparación de canales del número.

2. 2
   Guardar como (copia propia)

   Crea su propio flujo con el mismo contenido, sin tocar el original — desde ahí ya se edita libremente.