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

<Note>
  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**.
</Note>

***

## 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?" |

<Tip>
  As **intenções no topo da lista têm prioridade maior** quando a IA fica em dúvida entre duas. Arraste para reordenar.
</Tip>

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

<CardGroup cols={2}>
  <Card title="Bloco Condição" icon="code-branch" href="/administradores/flow-builder/bloco-condicao">
    Para decisões internas baseadas em dados (plano, status, etc.).
  </Card>

  <Card title="Bloco Qualificação" icon="star" href="/administradores/flow-builder/bloco-qualificacao">
    Qualifique o lead depois que a intenção comercial for detectada.
  </Card>

  <Card title="Bloco Handoff" icon="user" href="/administradores/flow-builder/bloco-handoff">
    Transfira para humano quando a intenção exigir atendimento pessoal.
  </Card>

  <Card title="Blocos Disponíveis" icon="grid-2" href="/administradores/flow-builder/blocos-disponiveis">
    Veja todos os blocos do Flow Builder.
  </Card>
</CardGroup>


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.