Verificación de identidad

La verificación de identidad le dice a Helpium, de manera segura, quién de sus usuarios está chateando. Su servidor firma un token corto con el secreto de identidad de su espacio de trabajo, y el widget web o el SDK móvil lo envían.

Con una identidad verificada:

• El cliente mantiene una conversación que lo sigue a través de dispositivos: desde su sitio web a la aplicación y de vuelta.
• Se omite el formulario previo al chat, porque Helpium ya conoce su nombre y correo electrónico.
• Las acciones de IA pueden actuar en su cuenta (consultar pedidos, cambiar una reserva) porque Helpium sabe que la solicitud realmente proviene de ese usuario.

Sin ello, un visitante aún puede chatear y dejar un correo electrónico, pero se le trata como no verificado.

1. Copie el secreto de identidad

En Helpium, abra Canales → Chat en Vivo y copie el secreto de identidad. Mantenlo solo en su servidor. Cualquiera que lo tenga podría hacerse pasar por cualquiera de sus usuarios.

2. Firme un token en su servidor

El token es un JWT HS256 con estos reclamos:

Reclamo	Requerido	Descripción
user_id	Sí (o email)	El id de su usuario, como una cadena
email	Recomendado	Necesario para que la conversación siga al usuario a otro dispositivo
exp	Sí	Cuándo expira el token, como un timestamp Unix

Exponer un endpoint para usuarios autenticados, como GET /api/helpium-token, que lo devuelva:

use Firebase\JWT\JWT;

$userJwt = JWT::encode([
    'user_id' => (string) $user->id,
    'email' => $user->email,
    'exp' => time() + 3600,
], env('HELPIUM_IDENTITY_SECRET'), 'HS256');

const jwt = require('jsonwebtoken');

const userJwt = jwt.sign(
  { user_id: String(user.id), email: user.email },
  process.env.HELPIUM_IDENTITY_SECRET,
  { algorithm: 'HS256', expiresIn: '1h' }
);

import jwt, os, time

user_jwt = jwt.encode(
    {"user_id": str(user.id), "email": user.email, "exp": int(time.time()) + 3600},
    os.environ["HELPIUM_IDENTITY_SECRET"],
    algorithm="HS256",
)

3. Páselo a Helpium

Widget web

Helpium.identify({ userJwt: tokenFromYourServer, email: user.email });

iOS

Helpium.identify(userJwt: tokenFromYourServer)

Android

Helpium.identify(tokenFromYourServer);

React Native

Helpium.identify({ userJwt: tokenFromYourServer });

Llámelo justo después de que el usuario inicie sesión. Cuando cierre sesión, llame a Helpium.logout() en las aplicaciones para que la próxima persona en el mismo teléfono comience de nuevo.

Rotación del secreto

Si el secreto se filtra, regénere en Canales → Chat en Vivo. Los tokens firmados con el antiguo secreto dejarán de funcionar de inmediato, así que actualice su servidor al mismo tiempo.