Integración de CRM mediante Toolbar de Campaña (iframe y Browser Tab)

¿Qué es la Toolbar?

La Toolbar es el área de la campaña telefónica donde Neotel permite visualizar el CRM del cliente en simultáneo con la gestión de llamadas.

Desde esta sección es posible:

• Mostrar la web del CRM del cliente integrada en la pantalla del agente

• Enviar datos del contacto automáticamente

• Sincronizar la gestión entre Neotel y el sistema del cliente

La Toolbar funciona como el vínculo entre la telefonía y el CRM, evitando que el agente tenga que trabajar con múltiples sistemas en paralelo.

Modos de uso de la Toolbar

La Toolbar puede operar de dos formas:

🔹 Opción 1 – Iframe embebido

El CRM del cliente se muestra dentro de la propia pantalla de Neotel, sin abrir nuevas pestañas.

✔ Todo queda integrado en una sola vista
✔ Mejor experiencia para el agente
✔ Mayor control del entorno de trabajo

🔹 Opción 2 – Browser Tab (pestaña de navegador)

El CRM se abre en una pestaña independiente del navegador, en lugar de embeberse dentro de Neotel.

✔ Útil cuando el CRM no permite iframe por seguridad
✔ Evita bloqueos por políticas del navegador
✔ Permite usar autenticaciones más estrictas

📌 En este modo:

• El agente trabaja con dos pestañas activas

• La llamada sigue gestionándose desde Neotel

• El CRM se mantiene como sistema externo sincronizado por URL y/o API

¿Para qué sirve la Toolbar?

La Toolbar permite:

• Abrir automáticamente la ficha del cliente cuando ingresa una llamada

• Mantener visible esa ficha durante toda la gestión

• Enviar datos del contacto al CRM en tiempo real

• Integrar botones de acción desde el CRM usando la API (si se desea)

👉 La llamada se maneja desde Neotel
👉 La información se gestiona desde el CRM

¿Qué se configura en la Toolbar?

En cada campaña se definen los siguientes parámetros:

⏱ POSTVIEW TIMEOUT

Tiempo adicional luego de finalizar la llamada para completar la gestión antes de que el agente quede disponible nuevamente.

🧭 MODO

Define si el CRM se abrirá:

• Dentro de Neotel (iframe)

• En una pestaña nueva del navegador (browser tab)

🏠 HOME

Es la pantalla que se muestra cuando el agente no está gestionando un contacto.
Suele ser la home del CRM o una pantalla informativa.

🌐 URL

Es la dirección base del CRM, a la que Neotel le agrega automáticamente los datos del contacto.

Ejemplo:

Donde:

• [[CLAVE]] → identificador principal del contacto

• [[DATA]] → información adicional del cliente

🔗 SEPARADOR

Permite dividir correctamente los valores que llegan dentro de DATA.

Flujo normal de funcionamiento

El proceso es el mismo tanto en iframe como en browser tab:

1. Entra una llamada al agente

2. Neotel toma los datos del contacto

3. Arma la URL de la Toolbar

4. Abre esa URL:

   • Dentro de Neotel (iframe)

   • O en una pestaña nueva (browser tab)

5. El CRM:

   • Lee los parámetros

   • Busca o crea el cliente

   • Muestra la ficha correcta

📌 En muchas implementaciones solo con esto ya alcanza, sin necesidad de usar la API.

Uso de la API para integraciones más avanzadas

La API de Neotel se utiliza cuando el cliente necesita mayor control desde su propio CRM.

Los usos más comunes son:

🔐 Login y sesión del agente

Permite:

• Iniciar sesión del agente desde el CRM

• Validar sesión

• Cerrar sesión en forma sincronizada

📞 Control de llamadas desde el CRM

Permite crear botones propios como:

• Llamar

• Cortar

• Pausa

• Tiempo administrativo

• Descanso

El agente opera todo directamente desde el CRM y Neotel ejecuta la telefonía.

📂 Sincronización de contactos

Permite:

• Informar a Neotel qué contacto está viendo el agente

• Cerrar gestiones automáticamente

• Actualizar datos de contactos

• Controlar disponibilidad del agente desde el CRM

📡 Eventos de Neotel

Permiten al CRM recibir información como:

• Ingreso de llamadas

• Cambios de estado

• Transferencias

• Cierres de gestión

Consideraciones técnicas clave

🔒 HTTPS obligatorio

Si Neotel opera en HTTPS, el CRM también debe estar en HTTPS.

⚠️ Uso de iframe

Si se utiliza el modo embebido:

• El CRM debe permitir abrirse dentro de un iframe

• No debe bloquearse por políticas de seguridad del navegador

Si esto no es posible, se recomienda directamente usar Browser Tab.

🔑 Login del CRM

Buenas prácticas:

✅ El agente se loguea primero en su CRM
✅ Luego ingresa a Neotel
✅ La sesión ya queda activa

❌ No se recomienda:

• Enviar usuario y contraseña por URL

• Manejar autenticaciones sensibles dentro del iframe