Helpium

Identificación y Seguimiento de Clientes

La identificación de clientes conecta a los visitantes anónimos de widgets con perfiles de clientes conocidos, lo que permite un soporte personalizado y un historial de conversaciones a través de sesiones.

Cómo Funciona la Identificación

Cuando un visitante utiliza por primera vez el widget de chat, Helpium crea un registro de cliente anónimo. Una vez que los identificas (generalmente después de que inician sesión en tu aplicación), sus conversaciones anónimas se vinculan a su perfil conocido.

Identificación de Clientes a través de JavaScript

Después de que tu usuario inicia sesión, llama a Helpium.identify():

Helpium.identify({
    email: 'jane@example.com',
    name: 'Jane Smith',
    id: 'user_123',
    metadata: {
        plan: 'Pro',
        company: 'Acme Corp',
    }
});

El campo email es el identificador único. Si ya existe un cliente con ese correo electrónico, su perfil se actualiza. De lo contrario, se crea un nuevo cliente.

Identificación a través de API

También puedes identificar clientes del lado del servidor:

POST /api/customer/tracking/identify
X-API-Key: your_widget_key

{
    "email": "jane@example.com",
    "name": "Jane Smith",
    "id": "user_123",
    "widget_token": "conversation_widget_token",
    "metadata": { "plan": "Pro" }
}

El widget_token es opcional; si se proporciona, vincula la conversación especificada al cliente identificado.

Autenticación con Token Bearer

Para las Acciones de IA que llaman a tu API en nombre del cliente, pasa un token bearer durante la identificación:

// En tu aplicación, crea un token Sanctum para el usuario
const token = await createSanctumToken();

Helpium.identify({
    email: user.email,
    name: user.name,
    bearerToken: token,
});

El token bearer se almacena en el registro del cliente y es utilizado por las Acciones de IA configuradas con autenticación Customer Bearer. Esto permite que el chatbot de IA realice llamadas API autenticadas a tu aplicación.

Lo que Ven los Agentes

Cuando un cliente es identificado, los agentes ven su perfil en la barra lateral de la conversación:

Nombre y correo electrónico
Avatar (si se proporciona a través de avatarUrl)
ID Externo (tu ID de usuario interno)
Metadatos personalizados (plan, empresa, rol, etc.)
Historial de conversaciones a través de todas las sesiones
Última vez visto timestamp

Continuidad de Sesión

Los clientes identificados pueden reanudar conversaciones anteriores. Cuando regresan a tu sitio y son reidentificados, ven su historial de conversaciones en el widget.

Mejores Prácticas

Llama a identify() tan pronto como el usuario esté autenticado; no esperes a que abra el widget
Siempre incluye email; es el identificador principal
Usa metadata para la información que los agentes necesitan (plan, empresa, rol)
Rota los tokens bearer periódicamente por seguridad
Usa el campo id para vincular de nuevo a tus registros internos de usuarios

Identificación y seguimiento de clientes