API de JavaScript
Métodos globales disponibles después de cargar el script del widget.
Respondo.init(config)#
Inicializa y monta el widget. Debe llamarse una sola vez. Devuelve la instancia del widget.
const widget = Respondo.init({
agentId: 'YOUR_AGENT_ID'
});Respondo.identify(identity)#
Adjunta la identidad del usuario a la sesión actual. Llámalo después del inicio de sesión.
Respondo.identify({
email: 'user@example.com',
name: 'John Doe',
userId: 'usr_123',
userHash: 'hmac_sha256_signature', // opcional, para la verificación de identidad
metadata: { plan: 'pro' },
properties: { // propiedades de contacto personalizadas
account_type: 'enterprise', // claves definidas en Agent Settings
region: 'eu-west'
}
});Respondo.track(name, properties?)#
Registra un evento del lado del cliente para el visitante actual (p. ej., compra, mejora de plan). Los eventos pueden iniciar Tours activados por eventos y contar para los objetivos de los tours. Entrega de mejor esfuerzo con keepalive, de modo que los eventos disparados justo antes de una navegación (redirección al checkout) siguen llegando. Llámalo después de init().
Respondo.track('purchase_completed', {
plan: 'pro',
amount: 49
});Respondo.destroy()#
Elimina el widget de la página. Útil para SPAs al navegar a páginas donde el widget no debe aparecer. No borra la identidad del visitante ni la conversación almacenada — para el cierre de sesión, usa Respondo.reset().
// Elimina el widget de la página
Respondo.destroy();
// Reinicialízalo más tarde si es necesario (reanuda la misma conversación)
Respondo.init({ agentId: 'YOUR_AGENT_ID' });Respondo.reset()#
Cierre de sesión / traspaso en un dispositivo compartido. Borra del navegador el id de visitante anónimo, la conversación almacenada y el token de sesión, revoca el token de sesión en el servidor para que las copias dejen de funcionar, y vuelve a montar un widget anónimo nuevo. Llámalo desde el hook de cierre de sesión de tu aplicación.
// Al cerrar sesión — borra identidad, conversación y sesión, y empieza de cero
Respondo.reset();Recopilación automática de datos
El widget captura y almacena automáticamente lo siguiente con cada conversación:
| Dato | Fuente |
|---|---|
| IP del cliente | Cabeceras HTTP |
| Navegador / SO | Cabecera User-Agent |
| Idioma | Cabecera Accept-Language |
| Zona horaria | API Intl (JavaScript) |
| URL de la página | window.location |
| Referente | Cabecera Referer |