> ## Documentation Index
> Fetch the complete documentation index at: https://docs.maketalk.ai/llms.txt
> Use this file to discover all available pages before exploring further.
# Bloco Roteador
> Direcione a conversa por intenção do cliente usando IA, com múltiplas rotas que viram caminhos no canvas
## O que é o Bloco Roteador?
O bloco **Roteador** é o ponto de decisão principal do seu fluxo. Ele usa a IA para identificar **o que o cliente quer** — reservar, tirar dúvida, falar com humano, etc. — e direciona automaticamente para o bloco certo do fluxo.
Cada intenção configurada vira uma **saída** no canvas. Você conecta cada saída a um bloco diferente (Cotação, Base de Conhecimento, Transferência, Coleta de Dados) e a IA escolhe o caminho baseado na conversa.
### Por que usar?
| Benefício | Descrição |
| --------------------------- | ----------------------------------------------------------------------- |
| **Decisão por intenção** | A IA entende a mensagem e escolhe o caminho, sem menus rígidos |
| **Fluxo organizado** | Cada rota vira uma ramificação visual no canvas |
| **Prioridade configurável** | Intenções no topo têm prioridade quando há ambiguidade |
| **Fallback seguro** | Quando nada se encaixa, você decide: continuar, perguntar ou transferir |
Use o Roteador como **primeiro ponto de decisão** após o bloco de Início. Para decisões internas (verificar plano, status, dados), prefira o bloco **Condição**.
***
## Quando usar
Use o Roteador sempre que o agente precisa entender **a intenção do cliente** antes de continuar. Alguns cenários típicos:
* Hotel que recebe clientes querendo cotar, tirar dúvida ou mudar reserva
* E-commerce com perguntas sobre compra, rastreio, troca ou devolução
* Clínica onde o cliente quer agendar, remarcar, saber resultado ou tirar dúvida
* Qualquer fluxo B2B onde você precisa separar leads qualificados de dúvidas gerais
Se o seu fluxo tem 3 ou mais "caminhos" diferentes que dependem do que o cliente quer, o Roteador é o bloco certo.
***
## Como funciona
```
Mensagem do cliente
↓
IA analisa a conversa
↓
Identifica a intenção (usando as descrições configuradas)
↓
┌──────────────┼──────────────┬─────────────┐
│ │ │ │
Intenção 1 Intenção 2 Intenção N Fallback
(Cotação) (Dúvida) (Outros) (nenhuma)
```
A IA usa as **descrições de cada intenção** que você configura para decidir. Quanto mais claras e específicas as descrições, mais precisa a escolha.
***
## Campos principais
### Identificação
| Campo | Descrição | Exemplo |
| -------------------- | ------------------------------------------ | --------------------- |
| **Nome do Roteador** | Identificação visual do roteador no canvas | "Atendimento Inicial" |
### Intenções (Rotas)
Cada intenção é uma rota com os seguintes campos:
| Campo | Descrição | Exemplo |
| ------------------------------------ | ----------------------------------------------- | --------------------------------------------------------------------------------------------- |
| **Nome da intenção** | Nome curto da rota, exibido no bloco | "Fazer reserva" |
| **Ícone** | Emoji identificador visual | 🏨, 💰, ❓, 👤 |
| **Quando identificar** | Descrição para a IA entender quando usar a rota | "Quando o cliente manifesta interesse em reservar, verificar disponibilidade ou saber preços" |
| **Exemplos de mensagens do usuário** | Frases reais (3-5) que acionam a intenção | "Quero cotar", "Qual o valor?", "Tem vaga em março?" |
As **intenções no topo da lista têm prioridade maior** quando a IA fica em dúvida entre duas. Arraste para reordenar.
### Comportamento padrão (Fallback)
O que fazer quando **nenhuma intenção** for identificada:
| Opção | Comportamento |
| -------------------------- | ------------------------------------------------------------ |
| **Continuar conversa** | O agente segue conversando normalmente, usando o prompt base |
| **Perguntar ao usuário** | O agente pede esclarecimento (você define a mensagem) |
| **Transferir para humano** | Encaminha a conversa para atendimento humano |
***
## Exemplo de uso em fluxo
**Cenário — Hotel:**
```
[Início]
↓
[Roteador: Atendimento Inicial]
├── 🏨 Quer reservar → [Cotação Hotel]
├── ❓ Dúvidas gerais → [Base de Conhecimento]
├── 👤 Falar com humano → [Transferência]
└── Fallback: Continuar → IA responde com prompt base
```
**Configuração da intenção "Quer reservar":**
* Ícone: 🏨
* Quando identificar: "Quando o cliente quer fazer uma reserva, saber preços, verificar disponibilidade ou tarifas de hospedagem"
* Exemplos: `Quero reservar`, `Tem vaga?`, `Qual o valor da diária?`
Com essa configuração, quando o cliente diz "oi, queria ver um quarto pra maio", a IA identifica a intenção "Quer reservar" e direciona para o bloco Cotação Hotel automaticamente.
***
## Boas práticas
* Escreva descrições **detalhadas** em "Quando identificar". Liste todas as variações que o cliente pode usar.
* Use **3 a 5 intenções** por Roteador. Muitas rotas confundem a IA — se precisar de mais, considere um segundo Roteador encadeado.
* Adicione **exemplos de mensagens** reais. Eles ajudam a IA a reconhecer intenções mesmo quando o cliente escreve de forma diferente da descrição.
* Ordene por **prioridade de negócio**: intenções comerciais (vender, cotar) geralmente vão no topo.
* Configure o **fallback** de forma coerente com o seu fluxo. "Continuar" é o padrão seguro para a maioria dos casos.
***
## Blocos relacionados
Para decisões internas baseadas em dados (plano, status, etc.).
Qualifique o lead depois que a intenção comercial for detectada.
Transfira para humano quando a intenção exigir atendimento pessoal.
Veja todos os blocos do Flow Builder.