# KCS - 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

***

#### Visão Geral da Funcionalidade

Esta funcionalidade permite que você utilize uma URL específica para realizar a consulta de conversas existentes ou iniciar um novo chat com um cliente, utilizando apenas o número de telefone.

#### Passos para Utilização

1. Copie a URL Base:

   * A URL que você deve utilizar é a seguinte:

   > `https://app.tiflux.com/v/chats/search_by_number/<Número de telefone>`
2. Insira o Número de Telefone:
   * Substitua o trecho `<Número de telefone>` pelo número de contato do cliente.
   * ⚠️ Atenção: O número deve ser inserido obrigatoriamente com o código do país e o código do estado (DDD).
     * *Exemplo:* Para um número de São Paulo (DDD 11) no Brasil (+55), a estrutura seria: `+5511999998888`.
3. Acesse a URL:
   * Cole a URL completa no seu navegador e acesse.

#### Comportamento do Sistema

O sistema irá analisar o número inserido e direcionar você para o local apropriado:

* 🟢 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.

***


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://guia-de-uso.tiflux.com/faq/duvidas-frequentes/chat/kcs-como-usar-a-url-para-consultar-ou-iniciar-uma-conversa.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
