Five9xOdoo
Módulo Five9xOdoo Chat: Guía de Configuración Amigable
¡Hola! Bienvenido a la configuración del Módulo Five9xOdoo Chat. Esta herramienta combina dos sistemas poderosos: Five9 (para chats con agentes) y Odoo (para gestionar datos y conversaciones). Es como darle a tu bot dos líneas telefónicas: una para hablar con agentes y otra para organizar información en Odoo. Todo lo configuras en una ventana sencilla, ¡sin necesidad de saber programar!
¿Qué hace el Módulo Five9xOdoo Chat?
El Módulo Five9xOdoo Chat le dice a tu bot:
- Cómo conectarse a Five9 y Odoo al mismo tiempo.
- Qué campaña de Five9 usar para los agentes.
- Dónde enviar datos a Odoo (como nombres o pedidos).
- Qué decir si algo falla.
Lo configurarás en una ventana emergente con varios campos que llenas como si estuvieras completando un formulario.
Configuración Paso a Paso en la Ventana Emergente
Cuando abras esta herramienta, verás una ventana titulada "Five9xOdoo Chat Config" (Configuración de Five9xOdoo 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 identificar este módulo (como "Chat Doble" o "Soporte Integrado").
- Cómo configurarlo: Escribe algo corto y claro. ¡Es obligatorio!
Ejemplo: Escribe "Soporte Five9xOdoo" para un chat de soporte combinado.
2. Ingresa la URL de la Instancia de Odoo
- Dónde: El cuadro "OdooInstanceUrl" (URL de la Instancia de Odoo).
- Qué hace: Es la dirección web de tu Odoo (como "https://miempresa.odoo.com").
- Cómo configurarlo: Copia y pega la URL que te dieron para Odoo. ¡Es obligatorio!
Ejemplo: Escribe "https://tiendaXYZ.odoo.com".
3. Define el ID de la Instancia de Odoo
- Dónde: El cuadro "OdooInstanceId" (ID de la Instancia de Odoo).
- Qué hace: Es el código que identifica tu cuenta en Odoo.
- Cómo configurarlo: Escribe el ID que te dieron para Odoo (pregunta a tu equipo si no lo tienes). ¡Es obligatorio!
Ejemplo: Escribe "5678" si ese es tu ID.
4. Elige la Campaña de Five9
- Dónde: El cuadro "Five9Campaign" (Campaña de Five9).
- Qué hace: Le dice al bot en qué grupo de agentes de Five9 participar (como "Ventas" o "Soporte").
- Cómo configurarlo: Escribe el nombre de la campaña que te dio tu equipo de Five9. ¡Es obligatorio!
Ejemplo: Escribe "Soporte Clientes".
5. Define el Tenant de Five9
- Dónde: El cuadro "Five9Tenant" (Tenant de Five9).
- Qué hace: Es 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 Five9. ¡Es obligatorio!
Ejemplo: Escribe "miempresa123".
6. Escribe un Mensaje de Error
- Dónde: El cuadro "Error Message" (Mensaje de Error).
- Qué hace: Es lo que el bot dirá si falla la conexión con Five9 o Odoo (como "Lo siento, algo salió mal").
- Cómo configurarlo: Escribe un mensaje claro para los usuarios. ¡Es obligatorio!
Ejemplo: Escribe "Ups, no pudimos conectar, intenta de nuevo".
7. Agrega Atributos de Five9 (Opcional)
- Dónde: La sección "Five9Attributes" (Atributos de Five9), que parece una tabla.
- Qué hace: Envía datos extra a Five9, como el nombre del cliente o un número de pedido.
- Cómo configurarlo: Haz clic para agregar una fila y escribe:
- Name: El nombre del dato (como "Cliente").
- Value: El valor o dónde buscarlo (como "communication.name"). Pregunta a tu equipo por los valores correctos.
Ejemplo: "Name: Teléfono", "Value: communication.phone".
8. Agrega Atributos de Odoo (Opcional)
- Dónde: La sección "OdooAttributes" (Atributos de Odoo), también una tabla.
- Qué hace: Envía datos extra a Odoo, como un correo o un ID de cliente.
- Cómo configurarlo: Igual que con Five9, agrega filas con "Name" y "Value".
Ejemplo: "Name: Email", "Value: communication.email".
9. Guarda tu Configuración
- Dónde: El botón "Save" (Guardar) al final.
- Qué hace: Guarda todo para que el bot use Five9 y Odoo juntos.
- Cómo configurarlo: Haz clic en "Save". Si todo está bien, la ventana se cerrará y verás un mensaje de éxito. Si falta algo, te pedirá completarlo.
Consejo: Asegúrate de llenar todos los campos obligatorios (Name, OdooInstanceUrl, OdooInstanceId, Five9Campaign, Five9Tenant, Error Message).
¿Qué Sucede Cuando Se Ejecuta?
- El bot se conecta a Five9 usando "Five9Tenant" y "Five9Campaign" para hablar con agentes.
- También se conecta a Odoo con "OdooInstanceUrl" y "OdooInstanceId" para enviar datos.
- Usa los "Five9Attributes" y "OdooAttributes" (si los pusiste) para enviar información extra.
- Si algo falla, muestra el "Error Message" que escribiste.
Ejemplo Práctico
Imagina un bot para una tienda que usa ambos sistemas:
- Abres la ventana "Five9xOdoo Chat Config".
- En "Name", escribes "Chat Tienda".
- En "OdooInstanceUrl", escribes "https://tiendaABC.odoo.com".
- En "OdooInstanceId", escribes "9876".
- En "Five9Campaign", escribes "Soporte Tienda".
- En "Five9Tenant", escribes "tiendaABC".
- En "Error Message", escribes "No pudimos conectar, intenta otra vez".
- En "Five9Attributes", añades "Name: Cliente", "Value: communication.name".
- En "OdooAttributes", añades "Name: Pedido", "Value: communication.order".
- Haces clic en "Save".
Resultado: El bot conecta con la campaña "Soporte Tienda" en Five9 y envía el nombre del cliente. También manda el número de pedido a "https://tiendaABC.odoo.com". Si falla, dice "No pudimos conectar, intenta otra vez".
Trucos Especiales Simplificados
Doble Conexión
- Qué hace: El bot maneja Five9 y Odoo al mismo tiempo, como un puente entre agentes y datos.
- Cómo configurarlo: Solo llena los campos de ambos sistemas y guarda.
Ejemplo: Los agentes ven el nombre del cliente mientras Odoo guarda su pedido.
Atributos Personalizados
- Qué hace: Envía información útil a Five9 y Odoo por separado.
- Cómo configurarlo: Usa las tablas para añadir datos que quieras compartir.
Ejemplo: "Five9Attributes: Teléfono" y "OdooAttributes: Email" envían datos distintos a cada sistema.
Consejos para Solucionar Problemas
- ¿No puedes guardar? Revisa que todos los campos obligatorios estén llenos.
- ¿No conecta a Five9 o Odoo? Confirma que los Tenant, Campaign, URL e ID sean correctos.
- ¿Los atributos no llegan? Verifica con tu equipo que los "Value" estén bien escritos (como "communication.name").
- ¿Ves el mensaje de error mucho? Asegúrate de que ambos sistemas estén activos y accesibles.
¡Listo! Ya configuraste tu bot para usar Five9 y Odoo juntos. Llena los campos, guarda y observa cómo conecta ambos mundos. Si algo no funciona, revisa los datos o pide ayuda a quien maneja Five9 y Odoo en tu equipo. ¡A integrar se ha dicho!