Page cover
For the complete documentation index, see llms.txt. This page is also available as Markdown.

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?


🔎 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.


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

1. Estrutura da URL Base

Para utilizar o recurso, monte o link utilizando a seguinte estrutura:

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

2. Inserção do 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 (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

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:

  • 🟢 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

Atualizado