šŸ” ConfiguraĆ§Ć£o para Ɓrea Logada

Configure o widget TAU para identificar usuĆ”rios logados e personalizar sua experiĆŖncia. Esta funcionalidade permite que o chat mantenha contexto entre sessƵes e ofereƧa suporte personalizado.

security SeguranƧa em Primeiro Lugar

A autenticaĆ§Ć£o usa HMAC SHA-256 para garantir que as informaƧƵes do usuĆ”rio nĆ£o possam ser falsificadas. Toda a geraĆ§Ć£o de hash deve ocorrer no servidor.

šŸ”‘ GeraĆ§Ć£o do HMAC (Backend)

O HMAC deve ser gerado no seu servidor usando a chave secreta fornecida pelo TAU. Aqui estĆ£o exemplos para diferentes linguagens:

šŸ ImplementaĆ§Ć£o em Python

import hmac
import hashlib

def create_hmac(user_id: str, secret_key: str) -> str:
    return hmac.new(
        secret_key.encode(),
        user_id.encode(),
        hashlib.sha256
    ).hexdigest()

# Exemplo de uso
user_id = "user123"
secret_key = "sua_chave_secreta"  # Fornecida pelo TAU
hash_value = create_hmac(user_id, secret_key)

āš” ImplementaĆ§Ć£o em Node.js

const crypto = require('crypto');

function createHmac(userId, secretKey) {
    return crypto
        .createHmac('sha256', secretKey)
        .update(userId)
        .digest('hex');
}

// Exemplo de uso
const userId = "user123";
const secretKey = "sua_chave_secreta"; // Fornecida pelo TAU
const hash = createHmac(userId, secretKey);

šŸ˜ ImplementaĆ§Ć£o em PHP

āš™ļø ConfiguraĆ§Ć£o do Widget

No frontend, configure o widget com as informaƧƵes do usuƔrio logado:

ConfiguraĆ§Ć£o Completa

window.taubotConfig = {
    appId: 'SEU_APP_ID',
    user: {
        id: 'user123',                    // ID Ćŗnico do usuĆ”rio
        hash: 'HMAC_GERADO_NO_SERVIDOR',  // HMAC do user.id
        name: 'JoĆ£o Silva',               // Nome do usuĆ”rio
        email: 'joao@example.com',        // Email do usuƔrio
        phone: '+5511999999999',          // Telefone (opcional)
        profile_picture_url: 'https://...', // URL da foto (opcional)
        created_at: 1701967378            // Unix timestamp (opcional)
    }
};

šŸ“‹ Campos do UsuĆ”rio

user.id string obrigatĆ³rio

Identificador Ćŗnico do usuĆ”rio no seu sistema.

user.hash string obrigatĆ³rio

HMAC SHA-256 do user.id gerado no servidor com a chave secreta.

user.name string

Nome completo do usuĆ”rio para personalizaĆ§Ć£o do atendimento.

user.email string

Email do usuĆ”rio para contato e identificaĆ§Ć£o.

user.phone string

Telefone do usuƔrio no formato internacional.

user.profile_picture_url string

URL da foto de perfil do usuƔrio.

user.created_at number

Timestamp Unix de quando o usuƔrio foi criado no seu sistema.

šŸš€ BenefĆ­cios da Ɓrea Logada

Vantagens para UsuƔrios Autenticados

šŸ”’ ConsideraƧƵes de SeguranƧa

warning Importante: SeguranƧa

Nunca exponha sua chave secreta no frontend! O HMAC deve sempre ser gerado no servidor.

Melhores PrƔticas

šŸ§Ŗ Testando a ConfiguraĆ§Ć£o

Como Verificar se EstĆ” Funcionando

  1. Configure o widget com informaƧƵes de usuƔrio vƔlidas
  2. Abra o console do navegador (F12)
  3. Procure por logs de autenticaĆ§Ć£o do widget
  4. Inicie uma conversa e verifique se o nome aparece no chat
  5. Confirme no dashboard TAU se o usuƔrio foi identificado corretamente
verified_user UsuƔrios Autenticados

Com a configuraĆ§Ć£o de Ć”rea logada, vocĆŖ oferece uma experiĆŖncia de suporte muito mais personalizada e eficiente para seus usuĆ”rios cadastrados.