Principal ConexĂ”es com canais externos (caixas de entrada) 💬 CloudChat Web Widget — Ativar mĂșltiplas conversas por usuĂĄrio

💬 CloudChat Web Widget — Ativar mĂșltiplas conversas por usuĂĄrio

Última atualização em Nov 13, 2025

O que Ă© o modo de mĂșltiplas conversas?

A nova feature de mĂșltiplas conversas permite que um mesmo usuĂĄrio mantenha diferentes threads de atendimento dentro do Web Widget, em vez de ter apenas uma conversa contĂ­nua. Essa funcionalidade Ă© ideal para ambientes logados, onde Ă© possĂ­vel identificar de forma segura cada usuĂĄrio.

Como fica a visualização para o cliente?

đŸ§© PrĂ©-requisitos

Para ativar o modo de mĂșltiplas conversas no CloudChat Web Widget, Ă© necessĂĄrio:

  1. Habilitar a validação de identidade de usuårio (User Identity Validation).
    Isso garante que cada usuĂĄrio autenticado no seu site seja de fato quem diz ser.

  2. Integrar o script do Web Widget no seu site, utilizando o cĂłdigo fornecido na sua inbox de Web Widget dentro do painel CloudChat.

⚠ Importante:
A feature de mĂșltiplas conversas foi pensada exclusivamente para ĂĄreas logadas do seu site, onde hĂĄ um identificador Ășnico por usuĂĄrio.
Ela nĂŁo deve ser utilizada em seçÔes pĂșblicas ou anĂŽnimas.

⚙ Como habilitar mĂșltiplas conversas

  1. Acesse o painel do CloudChat.

  2. VĂĄ atĂ© Inboxes → Web Widget → Configuração.

  3. Ative a flag “MĂșltiplas conversas por usuĂĄrio”.

  4. Copie o script exibido após a ativação e cole no HTML da sua aplicação (normalmente antes do fechamento da tag <body>).

đŸ§Ÿ Exemplo de script

VocĂȘ pode obter esse exemplo de script em Inboxes → Web Widget → Widget Scripts.

🔐 Sobre o user_id e o identifier_hash

Esses dois parùmetros são fundamentais para a autenticação do usuårio:

  • user_id → identificador Ășnico e permanente do usuĂĄrio no seu sistema (por exemplo, o UUID da tabela de usuĂĄrios).

  • identifier_hash → assinatura criptogrĂĄfica gerada pelo seu backend, garantindo a integridade do user_id.

O CloudChat usa o identifier_hash para validar que o user_id foi realmente autenticado pelo seu sistema e nĂŁo foi adulterado no lado do cliente.

🧼 Como gerar o identifier_hash no backend

O hash deve ser gerado no seu backend, nunca no frontend, pois utiliza o token privado de User Identity Validation fornecido pelo CloudChat.
Isso evita que o token seja exposto no cĂłdigo pĂșblico do site.

import { createHmac } from 'node:crypto';

/**
 * Generates an HMAC SHA256 hash to identify the user
 * @param {string|number} userIdentifier - Unique ID of the user
 * @param {string} hmacToken - Private token provided by CloudChat
 * @returns {string} HMAC hash in hexadecimal format
 */
function generateUserIdentifier(userIdentifier, hmacToken) {
  if (!userIdentifier) {
    throw new Error('userIdentifier is required');
  }

  const identifierHash = createHmac('sha256', hmacToken)
    .update(userIdentifier.toString())
    .digest('hex');

  console.log('Generated Identifier Hash:', identifierHash, 'for user:', userIdentifier);
  return identifierHash;
}

O endpoint backend pode ser algo como:

GET /cloudchat/identity-hash?user_id=12345

Retornando:

{ "identifier_hash": "d35b5c2e3b7b2f..." }

✅ Boas práticas

  1. Use um user_id estĂĄvel (nunca mude o identificador de um usuĂĄrio existente).

  2. NĂŁo exponha o token HMAC no frontend.

  3. Gere o hash sempre no backend e o envie para o cliente apenas no momento de inicializar o widget.

  4. O identifier_hash deve ser regenerado toda vez que o widget for carregado para um usuĂĄrio autenticado.