Saltar a contenido

SDD — Bot Copar R.L. · Aurora

Ficha técnica

Campo Valor
Repositorio / carpeta salesiq/bot-copar/
Plataforma Zoho SalesIQ · Codeless Bot Builder (sin Deluge)
Disparo Mensaje entrante (WhatsApp y otros canales de la marca)
Departamento 1101764000000031003
Código flujos/copar-rl.json (exportación, 88 tarjetas) · flujos/archivos/ (9 imágenes y 1 formulario)
Integraciones Ninguna API externa; solo enlaces a App Copar RL, App Rinde y copargt.com
Proceso de negocio PDD

Contenido variable, estructura estable

Los encargados de Copar piden cambios de forma constante (productos, campañas, metas, ejecutivas) y el implementador de Copar asigna cada tarea. Este documento describe la estructura del bot y cómo aplicar los cambios frecuentes (sección 10). No lista el inventario vigente: la fuente de verdad es el bot publicado y su exportación en flujos/, que se actualiza en cada cambio.

1. Arquitectura general

flowchart LR
    V[Visitante<br/>WhatsApp / web] --> SIQ[SalesIQ<br/>Codeless Bot]
    SIQ -->|asociar etiqueta| T[Etiquetas de SalesIQ]
    SIQ -->|forward| G1[Grupo general<br/>6 operadoras]
    SIQ -->|forward| G2[Grupo inversiones<br/>1 operadora]
    SIQ -->|forward| G3[Grupo CDS<br/>4 operadoras]
    SIQ -->|enlaces| L[App Copar RL · App Rinde · copargt.com]

El bot no tiene código ni servidor propio. Todo está en tarjetas del Codeless Bot Builder y se ejecuta en Zoho. No llama APIs ni guarda datos fuera de la conversación; lo que el visitante escribe queda en la transcripción y en los campos del visitante (nombre, teléfono).

2. Componentes (tipos de tarjeta)

Tipo en la exportación Tarjeta en el builder Uso en este bot
type 1 · reply Enviar mensaje Textos, imágenes (file) y enlaces (links)
type 1 · suggestions Botón Todos los menús; enrutan por el id del botón
type 1 · visitor_name / visitor_phone Nombre / Teléfono Identificación del visitante
type 1 · files Carga de archivos Formulario y DPI en el flujo de documentos
type 17 · text Introducción de texto Monto y datos de contacto en créditos
type 6 Enrutador de criterios Entrada por mensaje, visitante conocido, canal
type 9 · associate_tags Agregar etiqueta(s) Clasificación por producto
type 2 · forward Reenviar a operador Traspaso a un grupo de operadoras
type 4 · operator_busy Respuesta ocupado Salidas de forward sin operadora
type 5 · end Finalizar chat Cierres

3. Flujo detallado

3.1 Entrada e identificación

  1. Bienvenida (tarjeta raíz 1101764000000024017): saludo de Aurora.
  2. Enrutador 87: si el mensaje de entrada es "Continuar con agente" → grupo de inversiones. Si no, pasa al enrutador 55.
  3. Enrutador 55: copar-cds → etiqueta Soporte cds → grupo CDS; copar-rrhh → etiqueta → el mismo grupo CDS. Cualquier otro mensaje → identificación. [confirmar: el criterio 55 parece ser el mensaje inicial del visitante, usado por los enlaces wa.me con texto precargado]
  4. Visitante conocido (criterio 36): si ya se conoce → menú principal.
  5. Nombre → Validar WhatsApp: en WhatsApp salta al menú; en otro canal pide el celular con prefijo +502 y lo confirma.

3.2 Menú principal

"Menú bienvenida" con tres botones: Cooperativa, Aplicación Rinde y Atención inmediata. Casi todos los submenús regresan aquí con su botón "Menú principal" (17 tarjetas apuntan a ella). Texto libre → mensaje de error y vuelve a mostrar el menú.

3.3 Patrón de producto

Todas las ramas de la cooperativa repiten esta secuencia:

flowchart LR
    M[Submenú<br/>Botón] --> T[Agregar etiqueta]
    T --> I[Enviar mensaje<br/>texto + imagen]
    I --> A[Botón de acción]
    A --> F[Reenviar a operador]
    A --> P[Instrucciones App]
    A --> M0[Menú principal]

Para agregar un producto se copia esta secuencia; ver 10.1.

3.4 Ramas actuales

Submenú (tarjeta) Particularidad técnica
Inversiones Producto → etiqueta → imagen → "¿Cómo deseas continuar?" → grupo de inversiones. Todos los productos comparten etiqueta
Menú asociación "Iniciar proceso" va directo a Información app (sin etiqueta); por "Requisitos" se llega al mismo punto con etiqueta
Menú créditos "Solicitar crédito" abre el flujo de calificación (3.5); "Información" muestra imagen y "Menú créditos 2"
Menú cuentas cooperativa Producto → etiqueta → imagen → "Menú cierre final" (instrucciones de App)
Opciones depósitos/Pagos Una sola etiqueta para las tres opciones; "Enviar boleta" deriva al grupo general
Menú app Rinde Solo información (enlaces e imágenes) → "Menú cierre". No etiqueta
Atención inmediata Tres opciones, misma etiqueta, todas al grupo general

3.5 Flujo de calificación de crédito

  1. Bienvenida crédito → Pregunta situación laboral (Empresa, Negocio propio, Otra).
  2. Empresa o negocio → Destino crédito (5 botones, todos van a la misma tarjeta; el destino solo queda en la transcripción).
  3. Monto (texto libre) → datos de contacto: nombre, DPI y empresa (texto libre, un solo mensaje, sin validación).
  4. Mensaje de agradecimiento → Derivar con ejecutiva.
  5. "Otra situación" o texto libre → oferta de ahorro: Sí → Menú cuentas cooperativa; No → Rechazo ahorro (fin).

Los datos de calificación no se guardan en campos del visitante; la ejecutiva los lee en la transcripción.

3.6 Flujo de documentos de asociación

Adjunto_asociación envía Formulario.xlsx y pide, en este orden, el formulario lleno (xlsx o pdf), DPI frontal y DPI reverso (pdf, jpg, jpeg o png, uno por tarjeta). Termina en Menú agente. Hoy solo se llega a este flujo por el botón "Menú principal" de Menú asociación, que es un error (sección 9).

4. Sistemas y dependencias

Sistema Uso Acceso Notas
SalesIQ, departamento …31003 Operadoras y horario Configuración del bot Las operadoras se eligen por correo dentro de cada tarjeta forward
Etiquetas de SalesIQ Clasificación por producto Tarjetas associate_tags Se referencian por ID (sección 6)
App Copar RL Asociación y apertura de cuentas Enlaces bit.ly (Android, iOS) Repetidos en Información app y Menú cierre final
App Rinde Información y descarga Play Store, App Store, copargt.com Solo en la rama Rinde
copargt.com Página de asociación Enlace fijo —

5. Credenciales y configuración

El bot no usa credenciales. La configuración relevante está en SalesIQ:

Elemento Dónde
Grupos de operadoras Lista de correos dentro de cada tarjeta forward
Horario de atención Horario del departamento; el texto "8:30am-5pm" está escrito en 4 tarjetas de ocupado
Inactividad Propiedades del bot: recordatorio a los 5 min y cierre a los 10 min
Idioma Español; los botones de seguimiento de inactividad siguen en inglés

6. Estados y datos persistentes

Elemento Uso
siq_fullname, siq_phone Nombre y celular del visitante
Etiquetas de la conversación Producto consultado; base de los reportes
Transcripción Datos de calificación y archivos recibidos

Etiquetas usadas (IDs de SalesIQ). El nombre de cada una se ve en SalesIQ:

ID de etiqueta Dónde se aplica
1101764000001674026 Inversiones: todos los productos y "Hablar con asesor"
1101764000001674053 Asociación: Requisitos
1101764000001674051 Asociación: Iniciar proceso (desde Proceso de asociación)
1101764000001501266 Asociación: "Hablar con asesor"
1101764000001501220 Créditos: Información y Solicitar crédito (desde Menú créditos 2)
1101764000001501218 Créditos: Hablar con asesor
1101764000001501240 Cuentas: Ahorro programado y Cuenta corriente
1101764000001501242 Cuentas: Hablar con asesor
1101764000001674095 Operaciones: las tres opciones
1101764000001674039 Atención inmediata: las tres opciones
1101764000001654002 Entrada copar-cds
1101764000001674274 Entrada copar-rrhh

7. Manejo de errores y reintentos

Tipo Ejemplo Comportamiento
Negocio Texto libre en un menú Cada menú tiene una salida por defecto: repetir, derivar o seguir a una tarjeta (ver la exportación)
Negocio Nombre o teléfono inválido Mensaje de error de la tarjeta y se vuelve a pedir
Aplicación forward sin operadoras conectadas Regla -3/-4: "deje un mensaje"
Aplicación forward fuera de horario Regla -2: mensaje con el horario
Aplicación Visitante inactivo Recordatorio a 5 min, cierre a 10 min

No hay integraciones, así que no hay fallas de API que manejar.

8. Monitoreo y notificaciones

El bot no escribe bitácora propia. Las métricas salen de SalesIQ: conversaciones por etiqueta, por operadora y por resultado (atendida, perdida). Las conversaciones que llegan a un forward sin respuesta quedan como chats perdidos y entran al circuito de ReenvioZoho. [confirmar]

9. Restricciones conocidas y trampas

El enrutamiento es por id del botón, no por texto

A diferencia de los bots en Deluge, aquí cada regla compara el id interno del botón. Se puede cambiar el texto o el emoji sin romper nada. Pero si se borra y se vuelve a crear un botón, cambia su id y hay que reconectar la rama.

Botones conectados a la tarjeta equivocada

  • Menú asociación › "Hablar con asesor" lleva a Beneficios, no a una ejecutiva.
  • Menú asociación › "Menú principal" abre el flujo de formulario y DPI.
  • Menú créditos 2 › "Menú principal" deriva a un agente.
  • Menú agente › "Finalizar chat" vuelve al menú.
  • Menú app Rinde › "Ir al menú principal" va a Menú cierre, no al menú.

Etiquetas inconsistentes

"Solicitar crédito" desde Menú créditos no etiqueta; desde Menú créditos 2 sí. "Iniciar proceso" de asociación etiqueta solo si se entra por Requisitos. Varios productos comparten etiqueta (inversiones, cuentas, operaciones), así que los reportes no distinguen entre ellos.

Operadoras duplicadas en dos tarjetas

Derivar con agente y Derivar con ejecutiva tienen las mismas 6 operadoras. Al dar de alta o baja a una ejecutiva hay que cambiar las dos. Lo mismo con el texto del horario, que está en 4 tarjetas de ocupado.

Textos repetidos

Las instrucciones y enlaces de la App Copar RL están en Información app y en Menú cierre final. Si cambian los enlaces, hay que editar ambas.

Detalles menores

El error del menú principal dice "Elige una de las 2 opciones" y hay 3. La tarjeta Nombre tiene "Aurora" como valor de ejemplo del apellido. En la calificación de crédito se pide "empresa que laboras" también a quien tiene negocio propio. copar-rrhh termina en el mismo grupo que copar-cds.

10. Cómo aplicar cambios

Cada cambio llega como tarea asignada por el implementador de Copar. Al terminar cualquiera de ellos: exportar el bot, reemplazar flujos/copar-rl.json (y flujos/archivos/ si cambiaron), actualizar sincronizado_el en meta.yml y hacer commit con el número de ticket.

10.1 Agregar un producto a una familia
  1. En el submenú de la familia, agrega un botón con el nombre del producto. Respeta el orden que pida Copar (las metas comerciales suelen definir qué va primero).
  2. Crea la tarjeta Agregar etiqueta(s). Si el producto debe medirse por separado, crea antes una etiqueta nueva en SalesIQ; si no, usa la de la familia.
  3. Crea Enviar mensaje con el texto y la imagen del producto.
  4. Crea el Botón de acción ("Quiero invertir", "Solicitar", etc.) y "Volver" o "Menú principal".
  5. Conecta la acción al forward del grupo que atiende ese producto.
  6. Prueba la rama completa desde el menú principal, incluida la respuesta con texto libre.
10.2 Retirar o pausar un producto
  1. Borra el botón del submenú. No borres las tarjetas de la rama si el producto puede volver; quedan desconectadas.
  2. Si otra tarjeta apuntaba a esa rama ("Volver a…"), reconéctala.
10.3 Cambiar información de un producto (tasa, requisitos, imagen)
  1. Edita la tarjeta Enviar mensaje de ese producto. Para la imagen, sube el archivo nuevo y quita el anterior.
  2. Guarda la imagen nueva en flujos/archivos/.
10.4 Nueva campaña o meta comercial
  • Si la campaña llega por un enlace con texto precargado, agrega una regla en el Enrutador 55 (o en el 87) con ese texto, una etiqueta propia y el forward del grupo responsable.
  • Si solo cambia la prioridad, reordena los botones del submenú o del menú principal.
10.5 Alta o baja de una ejecutiva
  1. Identifica el grupo: general (Derivar con agente y Derivar con ejecutiva), inversiones (Reenviar a operador 66) o CDS (Contacto con operador cds).
  2. Edita la lista de operadoras en todas las tarjetas del grupo.
  3. Actualiza costo.agentes en meta.yml si cambió el número de licencias.
10.6 Cambio de horario

Cambia el horario del departamento en SalesIQ y el texto "8:30am-5pm" en las 4 tarjetas de Respuesta ocupado que lo mencionan.

10.7 Nueva familia en el menú principal

Es un cambio de estructura: agrega el botón en Menú bienvenida, crea su submenú con el patrón de 3.3, corrige el texto de error del menú y actualiza el PDD (secciones 3 y 4).

11. Historial de cambios

Versión Fecha Cambio Autor
1.0 2026-10-08 Documento inicial a partir de la exportación del bot Angel