Essa funcionalidade é ideal para:

• Portais de clientes
• Aplicativos próprios
• Sistemas parceiros
• Plataformas white-label
• Ambientes internos corporativos

Como funciona

O fluxo ocorre em três etapas:

Sua aplicação
↓
Solicita token de login na API
↓
Recebe URL autenticada
↓
Redireciona usuário
↓
Usuário acessa a Digitalizei já autenticado

Pré-requisitos

Para utilizar o Login Integrado é necessário possuir um token permanente da API.

O token pode ser obtido em:

Configurações > Integrações > API

Importante

⚠️

Segurança

Nunca realize esta chamada diretamente pelo frontend.

O endpoint deve ser consumido exclusivamente pelo backend da sua aplicação.

Isso evita a exposição do token permanente da API.

Endpoint

POST /auth/v1/login/authenticate

Headers

Authorization: Bearer SEU_TOKEN

Parâmetros da Requisição

Identificação do usuário

É necessário informar ao menos um identificador: phoneNumber ou email.

Exemplo de Requisição

{
  "phoneNumber": "5531999999999",
  "email": "[email protected]",
  "redirectUrl": "/chat2/sessions/df98b9fb-2280-45z5-bce1-3fe8aa7047e5/preview"
}

Exemplo em cURL

curl --request POST \
--url https://api.wts.chat/auth/v1/login/authenticate \
--header 'Authorization: Bearer SEU_TOKEN' \
--header 'Content-Type: application/json' \
--data '{
  "phoneNumber":"5531999999999",
  "email":"[email protected]"
}'

Resposta

{
  "userId": "48525e80-43a7-4e06-86e0-f6b67b7d6629",
  "tenantId": "d4ed253d-f0c6-435c-8f7f-59a0598885fe",
  "urlRedirect": "https://wts.chat/auth/external-login?...",
  "expiresIn": "2026-01-01T00:00:00Z"
}

Redirecionando o usuário

Após receber a resposta, utilize o valor retornado em:

"urlRedirect"

para redirecionar o usuário.

Exemplo:

window.location.href = response.urlRedirect;

Ao acessar a URL retornada, o usuário iniciará a sessão já autenticado.

Componente de Conversas

Além do login integrado, é possível direcionar o usuário diretamente para uma conversa específica.

Estrutura da URL

/chat2/sessions/{conversationId}

Onde:

conversationId = ID da conversa

Opções disponíveis

Modo Preview

Oculta menus e elementos da plataforma, exibindo apenas a conversa.

/preview

Exemplo:

/chat2/sessions/XXXXXXXX/preview

Modo Interativo

Permite que o usuário interaja imediatamente com a conversa.

?interactive=true

Exemplo:

/chat2/sessions/XXXXXXXX?interactive=true

Combinação recomendada

/chat2/sessions/XXXXXXXX/preview?interactive=true

Esse formato:

• Exibe apenas a conversa
• Remove distrações da interface
• Permite interação imediata

Ideal para portais de atendimento e áreas do cliente.

Casos de Uso

Portal do Cliente

Cliente acessa portal
↓
Portal autentica via API
↓
Portal redireciona para conversa específica
↓
Cliente continua atendimento

Aplicativo Mobile

Usuário abre aplicativo
↓
Aplicativo solicita login integrado
↓
Usuário acessa conversa sem precisar autenticar novamente

Erros Comuns

Usuário não encontrado

Verifique se o telefone ou e-mail informado está cadastrado na plataforma.

Token inválido

Verifique o Header:

Authorization: Bearer SEU_TOKEN

URL expirada

O link retornado possui validade.

Caso expire, gere uma nova URL realizando novamente a requisição de autenticação.