Intake

Identificar a tus usuarios en el chat: el código, el token y los atributos

El código que le dice al chat quién es cada usuario, cómo se firma el token en tu servidor y qué datos llegan al agente, a los flujos y a las acciones.

Escrito por Oscar FernandezÚltima actualización hace 6 días

Esta es la parte técnica de instalar el chat para usuarios con sesión iniciada: el código que le dice al chat quién escribe, el token que lo demuestra y los atributos con los que tu producto le cuenta lo que ya sabe. Si todavía no sabes si te conviene, empieza por «Visitantes anónimos o usuarios identificados».

El código

En Ajustes › Chat de la web › Instalación, elige «Para usuarios con sesión iniciada» y copia el código. Tiene esta forma:

<script>
  window.intakeSettings = {
    workspaceKey: '…',
    embedSlug: '…',
    apiBaseUrl: '…',
    userContext: {
      user_id: currentUser.id,
      email: currentUser.email,
      name: currentUser.name,
      company: currentCompany.name,
      attributes: {
        plan: currentUser.plan
      }
    },
    userToken: currentUser.intakeToken
  };
</script>
<script async src="…"></script>

Las tres primeras claves ya vienen con los datos de tu widget. El resto lo rellena tu producto, en cada página donde esté el chat, con los datos de la persona que ha iniciado sesión:

  • user_id: su identificador en tu producto. Es lo que mejor la identifica, porque no cambia aunque cambie de correo.
  • email, name y company: su correo, su nombre y su empresa.
  • attributes: datos propios de la persona, con las claves que hayas creado en Ajustes › Datos › Personas.
  • userToken: el token, que se firma en tu servidor.

Si tu producto está hecho con React, en la misma tarjeta tienes el código como componente.

El token

El token demuestra que esos datos los ha puesto tu producto, y no alguien desde la consola del navegador. Sin él, cualquiera podría escribir el correo de otra persona.

Actívalo en la tarjeta «Verificación de identidad» de la misma pestaña: en «Obtén tu secreto», pulsa «Generar secreto». Guárdalo en tu servidor como cualquier otra clave: nunca en el código de la web ni en una app que se descarga.

El token es un JWT firmado con HS256 y ese secreto. Lleva las mismas claves que userContext: user_id, email, name, company y, si los usas, attributes. Lo que va dentro del token queda probado; lo que va fuera, no. Ponle una caducidad, por ejemplo de un día. Se firma en tu servidor y se pasa a la página junto con los datos del usuario. En Node:

import jwt from 'jsonwebtoken';

const userToken = jwt.sign(
  { user_id: String(user.id), email: user.email, name: user.name },
  process.env.INTAKE_IDENTITY_SECRET,
  { algorithm: 'HS256', expiresIn: '1d' },
);

En Python:

import os
from datetime import datetime, timedelta, timezone

import jwt  # PyJWT

user_token = jwt.encode(
    {
        "user_id": str(user.id),
        "email": user.email,
        "name": user.name,
        "exp": datetime.now(timezone.utc) + timedelta(days=1),
    },
    os.environ["INTAKE_IDENTITY_SECRET"],
    algorithm="HS256",
)

La tarjeta tiene el mismo ejemplo en PHP, Go y Ruby, y el paso «Comprobar token» para probar un token antes de salir a producción: te dice si vale y con qué usuario entra, o por qué no vale.

Con la verificación activada, solo cuenta como usuario quien llega con un token correcto. Quien llega sin él, o con uno caducado o mal firmado, se trata como un visitante.

Si ya usas la firma de antes («userHash»)

Antes, el chat se firmaba con userHash: un HMAC-SHA256 del user_id con el mismo secreto. Si tu web todavía la manda, sigue valiendo, y nadie se queda sin identificar mientras cambias al token.

Pero solo firma el identificador: el correo, el nombre y los atributos van sin firmar, y se dan por buenos tal como llegan. Con el token, todo lo que va dentro está probado.

Para cambiar:

  1. Firma el token en tu servidor y pásalo como userToken. Puedes mandar los dos a la vez: si el token falla, se usa la firma de antes.
  2. En la tarjeta, en «La firma de antes («userHash»)», mira «Última sesión con el token» y «Última sesión con la firma de antes».
  3. Cuando ya solo lleguen sesiones con el token, pulsa «Dejar de aceptarla». Desde entonces, quien llegue solo con userHash entra como visitante.

Si generas un secreto nuevo con «Generar uno nuevo», la firma de antes deja de aceptarse: con un secreto nuevo solo vale el token.

Los atributos

Con attributes, tu producto le cuenta a Intake lo que ya sabe de la persona: su plan, su rol, la cuenta que está mirando. Así el agente lo sabe desde el primer mensaje, sin preguntarlo y sin consultarlo a tu API en cada conversación.

  • Solo se guardan las claves creadas en Ajustes › Datos › Personas que no estén archivadas. Las demás se ignoran.
  • Los valores pueden ser texto (hasta 255 caracteres), números o sí/no. Como máximo, 30 por sesión.
  • Marca como «Solo actualizaciones verificadas» los que deciden algo, como un plan, un rol o un saldo. Esos solo se guardan si van dentro del token, en su attributes, o, mientras aceptes la firma de antes, con ella, como hasta ahora. Sin firma, cualquiera podría ponerse el plan que quisiera.
  • Se guardan en la ficha de la persona al cargar el chat. Si cambian en tu producto, se actualizan en la siguiente carga.

Qué recibe cada parte de Intake

Intake solo usa lo que sabe de una persona si esta ha probado quién es. La da por probada en tres casos:

  • Llega con el token, o con la firma de antes mientras la aceptes.
  • Escribe desde el mismo navegador donde Intake ya la conocía.
  • Escribe por un canal que ya lo demuestra, como WhatsApp o el correo.

Con la identidad probada:

  • El agente ve su nombre, su correo, su teléfono, sus etiquetas, sus atributos y los datos de su empresa.
  • Los flujos tienen esos datos en sus variables y sus ramas, y pueden escribir en su ficha.

Las acciones van más allá: reciben su correo, su teléfono y su identificador solo si esa conversación del chat llegó firmada, con el token o con la firma de antes. Haber escrito antes desde el mismo navegador no basta, porque ese navegador pudo escribir el correo de otra persona. En WhatsApp y en el correo, el canal ya lo demuestra.

Sin probar, Intake la trata como a alguien que no conoce. El agente solo sabe el nombre y el correo que escribió, marcados como no verificados. Los flujos no ven ni tocan su ficha, y las acciones no reciben sus datos. Así nadie consigue los datos de otra persona escribiendo su correo.

Si tu API decide según quién es

Si una acción llama a tu API y esta decide qué puede ver o hacer cada persona, identifícala con las variables de la persona, como {{personEmail}} o {{personId}}, que solo llevan valor con la identidad probada. No uses para eso un dato que el agente haya preguntado en la conversación: lo escribe el cliente y nadie lo comprueba.

Con la firma de antes solo va firmado el identificador. Si tu API decide por el correo, cambia al token: con él, el correo también está probado.

En tu API, comprueba además que la llamada viene de Intake, con una clave secreta en una cabecera que solo conozcáis tu API y la acción.

En WhatsApp

En WhatsApp lo que se prueba es el número desde el que se escribe, no la persona. Si un número lo comparten varios, como el móvil de una tienda, quien lo tenga en la mano actúa como su dueño. Tenlo en cuenta antes de dar a un número permisos que dependan de quién es.

Para unir un número de WhatsApp a un usuario de tu producto, usa una comprobación propia, como un código que le llegue a su correo y que escriba en el chat.

Comprobarlo

Abre tu producto con un usuario de prueba y escribe en el chat. En la bandeja, la conversación tiene que salir con su nombre y su correo, y en su ficha, los atributos que mandaste.

Después pregúntale al agente algo que dependa de quién eres. Tiene que contestar sin pedirte el correo. Si te lo pide, el token no está llegando o no vale: pruébalo en el paso «Comprobar token».

¿Te ha resultado útil?