Verifica quiénes son tus visitantes

Indica al chat quién es un visitante con sesión iniciada con Chatixy.identify() y firma su correo en tu servidor, para que tu equipo vea una identidad verificada en la conversación.

Cómo funciona la verificación de identidad

Cuando un visitante ha iniciado sesión en tu web, tu página puede decirle al chat quién es con Chatixy.identify(). Su correo, nombre y teléfono aparecen entonces en la conversación de tu bandeja de entrada, y el chat deja de pedirle el correo.

Sin firma, identify() funciona como el formulario previo al chat: los datos solo rellenan campos vacíos y la conversación queda marcada como no verificada. Añade una firma generada en tu servidor, el user_hash, y Chatixy marca la identidad como verificada: los datos sustituyen lo que escribió el visitante y la ficha de contacto de tu bandeja muestra la etiqueta Verificado. A tu agente de soporte solo se le dice que la identidad está verificada cuando lo está.

Consejos

  • Se aplican las reglas de campos del formulario previo al chat: un teléfono solo se guarda si tu chat lo pide, y un nombre salvo que el campo de nombre de tu chat esté desactivado.

Encuentra tu secreto de identidad

Cada chat tiene su propio Secreto de identidad. Solo los administradores de tu espacio de trabajo pueden verlo.

Pasos

  1. 1

    Abre los ajustes del chat

    En tu proyecto, haz clic en Configurar en el sitio y abre Configuración avanzada.

  2. 2

    Copia el secreto

    En Secreto de identidad, haz clic en Mostrar y después en Copiar.

  3. 3

    Guárdalo en tu servidor

    Guárdalo donde solo tu servidor pueda leerlo, por ejemplo en la variable de entorno CHATIXY_IDENTITY_SECRET.

Importante

  • Nunca pongas el secreto de identidad en el código de tu página, en tu JavaScript ni en un repositorio público. Quien lo tenga puede hacer que cualquier correo parezca verificado.
  • Regenerar crea un secreto nuevo, y las firmas hechas con el anterior dejan de verificarse al instante. Úsalo si el secreto puede haberse filtrado y pon enseguida el nuevo en tu servidor.

Firma el correo en tu servidor

La firma es un HMAC-SHA256 del correo del visitante, hecho con tu secreto de identidad como clave y escrito en hexadecimal en minúsculas: 64 caracteres.

Firma exactamente el correo que pasas a identify(). Chatixy no cambia mayúsculas y minúsculas antes de comprobarlo, así que Ann@Example.com y ann@example.com dan firmas distintas. Genera la firma en tu servidor, al servir la página o al responder tu propia API, nunca en el navegador.

Node.js

const crypto = require('crypto');

const userHash = crypto
  .createHmac('sha256', process.env.CHATIXY_IDENTITY_SECRET)
  .update(user.email)
  .digest('hex');

PHP

$userHash = hash_hmac('sha256', $user->email, getenv('CHATIXY_IDENTITY_SECRET'));

Python

import hashlib
import hmac
import os

user_hash = hmac.new(
    os.environ['CHATIXY_IDENTITY_SECRET'].encode(),
    user.email.encode(),
    hashlib.sha256,
).hexdigest()

Ruby

require 'openssl'

user_hash = OpenSSL::HMAC.hexdigest('SHA256', ENV.fetch('CHATIXY_IDENTITY_SECRET'), user.email)

Pasa la identidad al chat

Llama a Chatixy.identify() con el correo del visitante y la firma como user_hash; name y phone son opcionales. Escribe en la página los valores que generó tu servidor; el ejemplo de abajo muestra marcadores.

Puedes llamarlo en cuanto tu página sepa quién es el visitante. Las llamadas hechas antes de que el chat esté listo esperan y se ejecutan cuando lo está, y una identidad dada antes del primer mensaje se asocia a la conversación que ese mensaje inicia.

HTML

<script>
  window.chatixyAsyncInit = function (Chatixy) {
    Chatixy.identify({
      email: 'ann@example.com',
      name: 'Ann',
      user_hash: 'SIGNATURE_FROM_YOUR_SERVER',
    });
  };
</script>
<script src="https://chatixy.com/source/YOUR_WIDGET_KEY.js" async></script>

Si una firma no coincide

Un user_hash que no coincide no guarda nada de esa llamada: ni correo, ni nombre, ni teléfono, ni etiqueta Verificado. El chat sigue funcionando con normalidad y el visitante no ve ningún error.

Una conversación verificada sigue verificada: una llamada posterior a identify() sin firma no puede deshacerlo.

¿Por qué no aparece la etiqueta Verificado?

Comprueba que firmas exactamente el correo que pasas, letra por letra; que usas el secreto de este chat, porque cada chat tiene el suyo; que la firma está escrita en hexadecimal; y que nadie ha regenerado el secreto después de que lo copiaras.

¿Tengo que firmar el correo?

No. identify() sin user_hash sigue pasando los datos del visitante a tu bandeja. Quedan marcados como no verificados y solo rellenan campos que siguen vacíos.