Cómo verificar a los usuarios con sesión iniciada en el widget de chat

Firma en tu servidor a los usuarios con sesión iniciada y pasa el token al widget de Sell Whisper AI para que el agente sepa con quién habla. Desde Starter.

Pasos

Hazlo en este orden

  1. Genera el secreto de identidad

    Abre el agente, ve a Configuración (Settings), luego a Seguridad (Security), y haz clic en Generar secreto (Generate secret) en la tarjeta Verificación de identidad (Identity verification). Guarda el secreto solo en tu servidor. La verificación de identidad está disponible desde Starter.

    Configuración de seguridad del agente
  2. Firma al usuario en tu servidor

    Cuando un usuario tenga la sesión iniciada, crea un JSON Web Token firmado con el secreto usando HS256. Incluye user_id (o sub) y una fecha de vencimiento. Agrega el correo electrónico y el nombre del usuario si los tienes; cualquier otro claim se guarda como atributo en el perfil del usuario.

  3. Llama a identify en la página

    Cuando el widget haya cargado, llama a SellWhisperWidget.identify con el token. Llámalo con null cuando el usuario cierre sesión, para que la siguiente persona que use ese navegador empiece como anónima.

  4. Revisa una conversación verificada

    Abre una conversación de ese usuario en Registros de chat (Chat logs). Lleva una insignia Verificado (Verified) con el ID de usuario y los atributos, y el usuario tiene una entrada en Perfiles (Profiles).

Por qué verificar

Sin verificación, el widget solo sabe lo que escribe un visitante. Cualquiera puede escribir la dirección de correo de otra persona. Un token firmado en tu servidor demuestra que tu propio sitio inició la sesión de esa persona, así que el agente puede dar por ciertos el ID de usuario y los atributos.

Qué lleva el token

ClaimObligatorioSignificado
user_id o subSíTu ID estable del usuario
expSíFecha de vencimiento; mantenla corta y emite un token nuevo en cada carga de página
email, nameNoSe muestran con la conversación
Cualquier otro claimNoSe guarda como atributo en el perfil del usuario, por ejemplo el nombre de un plan

Fírmalo con HS256 y el secreto de los ajustes de Seguridad (Security) del agente. Si no puedes emitir un JSON Web Token, pasa un user_id con un user_hash, un HMAC del ID de usuario generado con el mismo secreto.

Reglas que debes seguir

  • El secreto se queda en tu servidor. Nunca lo pongas en el código de tu sitio web, en una app móvil ni en un repositorio público. Si se filtra, rótalo desde la misma tarjeta.
  • Firma por usuario y por sesión. Crea el token cuando la página se renderiza para un usuario con sesión iniciada.
  • Bórralo al cerrar sesión. Llama a identify(null) para que una computadora compartida no conserve la identidad.

Qué obtienes

  • Una insignia Verificado (Verified) en la conversación en Registros de chat (Chat logs).
  • Un perfil por usuario en Perfiles (Profiles), con los atributos que enviaste.
  • Atributos que puedes insertar en las acciones personalizadas, de modo que una llamada a tu API lleve el ID del usuario verificado.

Un usuario verificado no equivale a un inicio de sesión en la tienda: las acciones de Shopify y WooCommerce siguen dependiendo de que la tienda confirme al comprador.

Los ejemplos en Node.js y Python para firmar el token, y los fragmentos de código para la página, están en Verificación de identidad.

Preguntas frecuentes

Preguntas comunes

¿Un usuario verificado cuenta como inicio de sesión en la tienda?
No. Shopify, WooCommerce y otras acciones protegidas por inicio de sesión siguen pidiendo a la tienda que verifique al comprador. La verificación de identidad le dice al agente quién es el usuario según tu propio sitio.
¿Qué pasa con un token falsificado o vencido?
Se ignora y la conversación continúa como anónima. A tu cliente no se le muestra ningún error.
¿Puedo usar los datos del usuario en las acciones?
Sí. Los atributos del perfil se pueden insertar en la solicitud de una acción personalizada, de modo que una llamada a tu API lleve el ID o el plan del usuario verificado.

Documentación relacionada

Empieza

Pon los pasos en práctica

Empieza gratis, sin tarjeta de crédito.