Five9 Chat

Módulo Five9 Chat: Guía de Configuración Amigable

¡Hola! Bienvenido a la configuración del Módulo Five9 Chat. Esta herramienta permite que tu bot se conecte con un sistema llamado Five9 para chatear con agentes humanos o manejar conversaciones en plataformas como WhatsApp o Facebook. Es como darle a tu bot un teléfono para que hable con un equipo de soporte. Todo lo configuras en una ventana sencilla, ¡sin necesidad de saber programar!

¿Qué hace el Módulo Five9 Chat?

El Módulo Five9 Chat le dice a tu bot:

• Cómo conectarse a Five9 (un sistema para chats con agentes).
• En qué "campaña" o grupo de agentes participar.
• Qué decir si algo sale mal.
• Si debe esperar a que alguien lo active manualmente o empezar automáticamente.

Lo configurarás en una ventana emergente con casillas que llenas como si estuvieras preparando un formulario.

Configuración Paso a Paso en la Ventana Emergente

Cuando abras esta herramienta, verás una ventana titulada "Five9 Chat Config" (Configuración de Five9 Chat). Aquí te explico cómo usarla:

1. Dale un Nombre al Módulo

• Dónde: El cuadro de texto "Name" (Nombre).
• Qué hace: Es una etiqueta para que identifiques este módulo (como "Chat con Agentes" o "Soporte WhatsApp").
• Cómo configurarlo: Escribe algo corto y claro. ¡Es obligatorio!

Ejemplo: Escribe "Soporte Tienda" si es para una tienda online.

2. Elige la Campaña

• Dónde: El cuadro "Campaign" (Campaña).
• Qué hace: Esto le dice al bot en qué grupo de agentes de Five9 debe participar (como "Ventas" o "Soporte Técnico").
• Cómo configurarlo: Escribe el nombre de la campaña que te dio tu equipo de Five9. ¡También es obligatorio!

Ejemplo: Escribe "Soporte Técnico" si ese es el equipo que atenderá los chats.

3. Define el Tenant (Inquilino)

• Dónde: El cuadro "Tenant" (Inquilino).
• Qué hace: Es como el "ID" de tu cuenta en Five9, para que el bot sepa a qué cuenta conectarse.
• Cómo configurarlo: Escribe el código o nombre que te dieron para tu cuenta de Five9. ¡Obligatorio otra vez!

Ejemplo: Escribe "miempresa123" si ese es tu tenant en Five9.

4. Escribe un Mensaje de Error

• Dónde: El cuadro "Error Message" (Mensaje de Error).
• Qué hace: Esto es lo que el bot dirá si algo falla (como "Lo siento, no puedo conectar con un agente ahora").
• Cómo configurarlo: Escribe un mensaje claro para los usuarios. ¡Es obligatorio!

Ejemplo: Escribe "Ups, algo salió mal. ¡Intenta de nuevo!".

5. Decide el Tipo de Conexión

• Dónde: La casilla "Connection Type" (Tipo de Conexión) con una opción "Manual".
• Qué hace: Define si el bot empieza el chat automáticamente o espera a que alguien lo active manualmente.
• Cómo configurarlo: Marca la casilla "Manual" si quieres que un humano dé el primer paso. Déjala sin marcar para que el bot comience solo.

Ejemplo: Marca "Manual" si un agente debe iniciar el chat.

6. Agrega Atributos (Opcional)

• Dónde: La sección "Attributes" (Atributos), que parece una tabla.
• Qué hace: Aquí puedes añadir datos extra que el bot envíe a Five9, como el nombre del cliente o un número de pedido.
• Cómo configurarlo: Haz clic para agregar una fila en la tabla y escribe:
  • Name: El nombre del dato (como "Cliente").
  • Value: El valor o dónde buscarlo (como "communication.name" para tomar el nombre del chat). Pregunta a tu equipo por los valores correctos.

Ejemplo: Agrega una fila con "Name: Cliente" y "Value: communication.name" para enviar el nombre del cliente.

7. Guarda tu Configuración

• Dónde: El botón "Save" (Guardar) al final.
• Qué hace: Guarda todo lo que configuraste para que el bot lo use.
• Cómo configurarlo: Haz clic en "Save". Si llenaste todo bien, la ventana se cerrará y verás un mensaje de éxito. Si falta algo, te pedirá completarlo.

Consejo: Revisa que los campos obligatorios (Name, Campaign, Tenant, Error Message) estén llenos.

¿Qué Sucede Cuando Se Ejecuta?

1. El bot se conecta a Five9 usando el "Tenant" y la "Campaign" que indicaste.
2. Si no es "Manual", empieza el chat automáticamente. Si es "Manual", espera a que alguien lo active.
3. Envía los "Attributes" (si los pusiste) y comienza la conversación.
4. Si algo falla, muestra el "Error Message" y termina el intento.

Ejemplo Práctico

Imagina un bot para soporte en WhatsApp:

1. Abres la ventana "Five9 Chat Config".
2. En "Name", escribes "Soporte WhatsApp".
3. En "Campaign", escribes "Soporte Clientes".
4. En "Tenant", escribes "tiendaXYZ".
5. En "Error Message", escribes "No pudimos conectar, intenta otra vez".
6. No marcas "Manual" para que sea automático.
7. En "Attributes", añades "Name: Teléfono" y "Value: communication.phone".
8. Haces clic en "Save".

Resultado: El bot se conecta a la campaña "Soporte Clientes" en Five9, envía el número de teléfono del cliente y empieza el chat. Si falla, dice "No pudimos conectar, intenta otra vez".

Trucos Especiales Simplificados

Conexión Manual

• Qué hace: Si marcas "Manual", el chat no empieza hasta que un agente lo active.
• Cómo configurarlo: Marca la casilla "Manual" y espera a que alguien del equipo lo inicie.

Ejemplo: Útil si quieres que los agentes decidan cuándo entrar.

Enviar Datos Extra

• Qué hace: Los "Attributes" permiten enviar información útil a los agentes.
• Cómo configurarlo: Usa la tabla para añadir pares de "Name" y "Value". Por ejemplo, "Name: Pedido" y "Value: communication.order".

Ejemplo: Los agentes ven el número de pedido del cliente al empezar el chat.

Consejos para Solucionar Problemas

• ¿No puedes guardar? Asegúrate de llenar Name, Campaign, Tenant y Error Message.
• ¿El chat no empieza? Revisa si "Tenant" y "Campaign" son correctos. Si es "Manual", espera a que alguien lo active.
• ¿El mensaje de error no aparece? Confirma que lo escribiste bien en "Error Message".
• ¿Los atributos no llegan? Verifica con tu equipo que los "Value" estén bien escritos.

¡Listo! Ya configuraste tu bot para chatear con Five9. Llena los campos, guarda y observa cómo conecta con los agentes. Si algo no funciona, revisa los datos o pide ayuda a quien maneja Five9 en tu equipo. ¡A chatear se ha dicho!