> For the complete documentation index, see [llms.txt](https://guia-de-uso.tiflux.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://guia-de-uso.tiflux.com/faq/duvidas-frequentes/chat/kcs-chat-como-usar-a-url-para-consultar-ou-iniciar-uma-conversa.md).

# KCS - Chat - Como Usar a URL para Consultar ou Iniciar uma Conversa

### 📞 Como Usar a URL para Consultar ou Iniciar uma Conversa

🕒 Tempo aproximado para leitura: 00:01:00 min

***

### ❓ Dúvida

Como utilizar uma URL direta para buscar o histórico, consultar conversas ativas ou iniciar um novo *chat* com um cliente no TiFlux utilizando apenas o número de telefone?<br>

***

### 🔎 Causa / Contexto

Esta funcionalidade permite agilizar o atendimento abrindo a tela de conversa diretamente pelo navegador através de um *link* estruturado, facilitando a integração do TiFlux com CRMs, discadores, sistemas internos ou atalhos de navegação.<br>

***

### ✅ Solução / Passo a Passo de Utilização

#### 1. Estrutura da URL Base

Para utilizar o recurso, monte o *link* utilizando a seguinte estrutura:<br>

`https://app.tiflux.com/v/chats/search_by_number/<Número de telefone>`<br>

#### 2. Inserção do Número de Telefone

Substitua o trecho `<Número de telefone>` pelo número de contato do cliente.<br>

> ⚠️ Atenção: O número deve ser inserido obrigatoriamente com o código do país (DDI) e o código da região (DDD), sem espaços, traços ou parênteses.\
> Exemplo: Para o número `99999-8888` em São Paulo/SP (DDD 11) no Brasil (+55), a estrutura final da URL será: `https://app.tiflux.com/v/chats/search_by_number/+5511999998888`<br>

#### 3. Comportamento e Direcionamento do Sistema

Ao acessar a URL completa no navegador, o TiFlux analisará o número inserido e direcionará automaticamente o usuário para o cenário correspondente:<br>

* 🟢 Novo Chat: Se o número for novo e não possuir nenhum histórico de conversas no sistema, será iniciado um novo chat com o contato.
* 🟡 Chat em Andamento: Se já houver um chat em andamento (ativo) com o número, você será direcionado diretamente para essa conversa ativa.
* 🔵 Histórico de Chat: Se o número não tiver um chat *em andamento*, mas possuir histórico de conversas finalizadas, você será direcionado para o último chat realizado com esse número para consulta do histórico.

> 💡 Dica de Especialista / Nota: Esta URL pode ser configurada como campo dinâmico ou botão de ação dentro de CRMs externos para que os analistas iniciem o atendimento no TiFlux com apenas um clique.

***

### 🔍 Palavras-chave para busca

```
iniciar chat por url tiflux,
buscar conversa por telefone url,
search_by_number tiflux,
abrir chat por link direto,
integracao discador crm chat tiflux,
consultar historico chat por numero,
url busca chat numero telefone
```