Contacto
Español
Prueba gratis

Conector de datos de clientes

Muestra campos de perfil, listas y alertas de tus propios sistemas en el panel Cliente de cada ticket.

Traducido para tu comodidad. El código, los nombres de campos y la referencia de la API siguen en inglés. Versión en inglés

El conector de datos de clientes permite a los agentes ver lo que tus propios sistemas saben de un cliente (plan, pedidos, estado de la cuenta, incidencias abiertas) en el propio ticket, sin app de barra lateral.

Cómo funciona

  1. Un administrador configura el endpoint del conector (URL y autenticación) en Admin Center, Integrations, Customer data.
  2. Cuando un agente abre un ticket, HelpFalcon llama a tu endpoint con los identificadores del solicitante (correo, id externo, teléfono).
  3. Tu endpoint responde con JSON: campos de perfil, listas (por ejemplo los últimos pedidos) y alertas (por ejemplo «pago vencido»).
  4. HelpFalcon muestra la respuesta en el panel Cliente.

Tu endpoint

  • HTTPS, accesible desde nuestras direcciones IP de salida publicadas.
  • Autenticación: una clave de API en la cabecera que elijas (por ejemplo X-API-Key o Authorization: Bearer ...) o credenciales de cliente OAuth (URL del token, client id y secret, scope y audience opcionales).
  • Tiempo de espera: de 1 a 15 segundos (5 por defecto). Pasado ese tiempo, el panel avisa al agente de que tu sistema no respondió, sin bloquear el ticket.
  • Caché: de 0 a 86400 segundos por cliente (300 por defecto). Los agentes pueden refrescar el panel a mano; los fallos se guardan en caché 15 segundos.
  • Responde 404 o "found": false cuando no tengas registro; el panel lo indica.
  • HelpFalcon no guarda ninguno de esos datos y el panel nunca escribe en tu sistema.

El contexto del cliente también está disponible en la API REST en GET /api/users/{id}/customer_context, para que reglas e integraciones usen los mismos datos.