Conexiones externas
Cómo configurar conexiones HTTP a sistemas externos para mostrar datos en el inbox.
Las conexiones externas permiten mostrar datos de tus sistemas (CRM, ERP, facturación) directamente en el panel de contacto del inbox. Cuando un agente abre una conversación, CX Inbox consulta tu sistema y muestra los datos del cliente en la sección "Datos del cliente".
Cómo funciona
Agente abre conversación → CX Inbox envía HTTP request con el teléfono del cliente
→ Tu sistema responde con datos → Se muestran en el panel de contactoLa conexión es genérica: funciona con cualquier API REST que devuelva JSON. CX Inbox no tiene conocimiento del sistema externo — todo se configura vía endpoint, headers y field mappings.
Configurar una conexión
Ve a Configuración → Conexiones externas.
Configura el endpoint
| Campo | Descripción |
|---|---|
| URL | URL del API con variables: {{phone}} (completo), {{phone10}} (últimos 10 dígitos) |
| Método HTTP | GET, POST, PUT, etc. |
| Headers | Encabezados con soporte para {{secret}} |
| Body | Cuerpo de la petición (para POST/PUT) |
| Timeout | Tiempo máximo de espera |
Define los field mappings
Los field mappings indican cómo extraer y mostrar los datos del JSON de respuesta:
| Campo | Descripción |
|---|---|
| Ruta | Dot-notation al dato (ej: data.customer.name) |
| Label | Nombre que se muestra al agente |
| Tipo | Texto, moneda, fecha, booleano, email, link, estado, badge, lista |
Configura credenciales
Los secrets son pares key-value encriptados que se interpolan como {{nombre}} en URL, headers o body. Ideales para API keys y tokens.
Probar la conexión
Haz clic en Probar conexión para ejecutar una llamada de prueba y verificar que los datos se extraen correctamente.
Cache
Los datos se cachean en memoria por organización y teléfono. El TTL (tiempo de vida) es configurable — el default es 5 minutos. El agente puede forzar un refresh con el icono ↻ en el panel de contacto.
Reintentos
| Campo | Descripción |
|---|---|
| Reintentos | 0–10 intentos ante fallas transitorias |
| Timeout de reintentos | Tiempo máximo total para reintentos |
Solo errores 5xx y de red se reintentan. Errores 4xx fallan inmediatamente.
Si tu sistema retorna múltiples registros (ej: varios contratos), se muestran como acordeones colapsables en el panel de contacto.
¿Esta página fue útil?