> ## Documentation Index
> Fetch the complete documentation index at: https://docs.suasofia.online/llms.txt
> Use this file to discover all available pages before exploring further.

# Flow Builder

> Projete fluxos de conversa visualmente com uma interface intuitiva de arrastar e soltar

O Flow Builder é um editor visual de fluxo de conversa de arrastar e soltar que permite projetar scripts de assistente de IA sem escrever código. Crie fluxos de conversa de múltiplas etapas conectando nós que representam diferentes ações e pontos de decisão.

## Visão Geral

O Flow Builder fornece:

* **Design visual** - Nós de arrastar e soltar em uma tela
* **Múltiplos tipos de nós** - Mensagens, prompts, ações e mais
* **Lógica de ramificação** - Crie caminhos diferentes com base nas respostas
* **Painel de configurações** - Configure personalidade e comportamento do agente
* **Importar/Exportar** - Salve e compartilhe fluxos como arquivos JSON

<Frame>
  <img src="https://mintcdn.com/sofia-00a9d19b/OLdR4sG9DiTXE0SO/resources/ai-assistants/flow-builder-overview.png?fit=max&auto=format&n=OLdR4sG9DiTXE0SO&q=85&s=5b85ccc6dd87ed44db0c00813fe871c1" alt="Interface do Flow Builder" width="937" height="610" data-path="resources/ai-assistants/flow-builder-overview.png" />
</Frame>

## Quando Usar o Flow Builder

<CardGroup cols={2}>
  <Card title="Use Flow Builder para" icon="check">
    * Scripts de conversa estruturados
    * Árvores de decisão de múltiplos caminhos
    * Fluxos de chamada complexos com ramificações
    * Pensadores visuais que preferem diagramas
  </Card>

  <Card title="Use Editor Clássico para" icon="pen">
    * Conversas simples e lineares
    * Respostas de IA altamente dinâmicas
    * Iterações rápidas de prompt
    * Edição focada em texto
  </Card>
</CardGroup>

## Primeiros Passos

<Steps>
  <Step title="Abra seu assistente">
    Navegue até **Assistentes** e clique no assistente que você deseja editar.
  </Step>

  <Step title="Encontre o Flow Builder">
    No formulário de edição, role até a seção **Prompt do Sistema** e clique na aba **Flow Builder**.
  </Step>

  <Step title="Inicie o Flow Builder">
    Clique em **Iniciar Flow Builder**. Um editor em tela cheia será aberto.
  </Step>

  <Step title="Escolha como começar">
    * **Continuar com existente** - Edite seu fluxo atual
    * **Começar do zero** - Comece apenas com um nó Início
    * **Começar com modelo** - Carregue um modelo de fluxo pré-construído
  </Step>
</Steps>

## Visão Geral da Interface

### Área da Tela (Centro)

O espaço de trabalho principal onde você constrói seu fluxo:

* **Nós** - Arraste para reposicionar
* **Conexões** - Linhas mostrando fluxo entre nós
* **Fundo em grade** - Ajuda com alinhamento
* **Controles de zoom** - Ampliar/reduzir e ajustar à visualização
* **Panorâmica** - Clique e arraste no espaço vazio para mover

### Barra de Ferramentas Inferior

Ações rápidas para gerenciar seu fluxo:

| Botão               | Ação                                              |
| ------------------- | ------------------------------------------------- |
| ⚡ Layout Automático | Organizar nós automaticamente de forma organizada |
| 📋 Duplicar         | Copiar nó selecionado                             |
| 🗑️ Excluir         | Remover nó ou conexão selecionada                 |
| **+ Adicionar Nó**  | Adicionar um novo nó à tela                       |

### Painel de Configurações (Lado Direito)

Configure a personalidade e comportamento do seu assistente:

* **Nome do Agente** - O nome que sua IA usará
* **Tipo de Agente** - Vendas, Suporte, Pesquisa, etc.
* **Idioma** - Idioma falado para chamadas
* **Assertividade** - Quão insistente a IA deve ser
* **Humor** - Nível de humor nas respostas
* **Variáveis** - Campos de dados pré-chamada
* **Campos Pós-Chamada** - Dados para coletar após chamadas

## Tipos de Nós

O Flow Builder tem 5 tipos de nós, cada um com um propósito específico:

<Frame>
  <img src="https://mintcdn.com/sofia-00a9d19b/OLdR4sG9DiTXE0SO/resources/ai-assistants/flow-builder-nodes.png?fit=max&auto=format&n=OLdR4sG9DiTXE0SO&q=85&s=2d84ff7b03f545980c047df2d5084388" alt="Tipos de Nós do Flow Builder" width="907" height="590" data-path="resources/ai-assistants/flow-builder-nodes.png" />
</Frame>

### Nó Início (Verde)

<Card title="Nó Início" icon="play" color="#22c55e">
  O ponto de entrada de cada conversa. Todo fluxo deve ter exatamente um nó Início.

  **Propriedades:**

  * **Saudação** - A mensagem inicial quando a chamada começa

  **Exemplo:** "Oi, aqui é a Sarah da Acme Insurance. Como você está hoje?"
</Card>

### Nó Falar (Azul)

<Card title="Nó Falar" icon="volume-high" color="#3b82f6">
  Entrega uma mensagem pré-escrita exatamente como especificado. Use quando precisar de palavras precisas.

  **Propriedades:**

  * **Texto** - A mensagem exata para falar
  * **Resultados** - Caminhos diferentes baseados na resposta do cliente

  **Exemplo:** "Estamos oferecendo um desconto limitado de 20% em todos os planos. Gostaria de ouvir mais?"
</Card>

### Nó Prompt (Roxo)

<Card title="Nó Prompt" icon="message" color="#a855f7">
  Dá instruções à IA sobre como responder. Mais flexível que nós Falar - a IA gera respostas contextuais.

  **Propriedades:**

  * **Prompt** - Instruções para a IA
  * **Resultados** - Caminhos diferentes baseados nas categorias de resposta

  **Exemplo de prompt:** "Pergunte ao cliente sobre sua cobertura de seguro atual. Seja conversacional e empático. Ouça por menções do tamanho da família, preocupações com orçamento ou cronograma."
</Card>

### Nó Ação (Laranja)

<Card title="Nó Ação" icon="bolt" color="#f97316">
  Executa ações especiais durante a chamada.

  **Tipos de Ação:**

  * **Transferir Chamada** - Transferir para outro número
  * **Agendar Compromisso** - Agendar usando calendário conectado
  * **Ação Personalizada** - Disparar uma ferramenta personalizada durante a chamada

  **Exemplo:** Transferir para equipe de vendas em +1-555-123-4567 quando cliente está pronto para comprar.
</Card>

### Nó Fim (Vermelho)

<Card title="Nó Fim" icon="phone-slash" color="#ef4444">
  Termina a chamada ou transfere para outro destino.

  **Tipos de Fim:**

  * **Encerrar Chamada** - Desligar com uma mensagem de encerramento
  * **Transferir Chamada** - Transferir para um número de telefone
  * **Transferir Agente** - Passar para outro assistente

  **Exemplo de encerramento:** "Obrigada pelo seu tempo hoje. Tenha um ótimo dia!"
</Card>

## Trabalhando com Nós

### Adicionando Nós

1. Clique em **+ Adicionar Nó** na barra de ferramentas inferior
2. Selecione o tipo de nó no menu suspenso
3. O nó aparece na tela
4. Arraste-o para a posição desejada

### Conectando Nós

1. Passe o mouse sobre a borda inferior de um nó para ver o **manipulador de saída** (círculo pequeno)
2. Clique e arraste do manipulador de saída
3. Conecte ao **manipulador de entrada** de outro nó (borda superior)
4. Solte para criar a conexão

### Editando Nós

1. Clique em qualquer nó para selecioná-lo
2. As propriedades do nó aparecem em um painel
3. Edite o texto, prompt ou configurações
4. As mudanças são salvas automaticamente na tela

### Excluindo Nós

* Selecione um nó e pressione a tecla **Delete**, ou
* Selecione um nó e clique no botão 🗑️ na barra de ferramentas

<Warning>
  O nó Início não pode ser excluído. Todo fluxo deve ter um nó Início.
</Warning>

## Resultados (Múltiplos Caminhos)

Nós Falar e Prompt podem ter múltiplos **resultados** - caminhos diferentes baseados em como o cliente responde.

### Adicionando Resultados

1. Selecione um nó Falar ou Prompt
2. No painel de propriedades, encontre **Resultados**
3. Clique em **Adicionar Resultado**
4. Nomeie o resultado (ex: "Interessado", "Não interessado", "Quer retorno")

### Conectando Resultados

Cada resultado aparece como um ponto colorido na parte inferior do nó. Conecte cada resultado a um nó de destino diferente para criar lógica de ramificação.

<Frame>
  <img src="https://mintcdn.com/sofia-00a9d19b/OLdR4sG9DiTXE0SO/resources/ai-assistants/flow-builder-branching.png?fit=max&auto=format&n=OLdR4sG9DiTXE0SO&q=85&s=3189dfeb19e2a2e627a6fb8962aa7a56" alt="Ramificação de Conversa com Resultados" width="547" height="425" data-path="resources/ai-assistants/flow-builder-branching.png" />
</Frame>

**Exemplo de fluxo:**

```
[Início] → [Perguntar sobre interesse]
               ↓
          [Prompt: "Perguntar se interessado"]
               ↓
     ┌─────────┼─────────┐
     ↓         ↓         ↓
[Interessado] [Talvez] [Não Interessado]
     ↓         ↓         ↓
[Agendar Demo] [Enviar Info] [Agradecer & Fim]
```

## Painel de Configurações

<Frame>
  <img src="https://mintcdn.com/sofia-00a9d19b/OLdR4sG9DiTXE0SO/resources/ai-assistants/flow-builder-settings.png?fit=max&auto=format&n=OLdR4sG9DiTXE0SO&q=85&s=cd702139f23c7759959fcc7a623c0077" alt="Painel de Configurações do Flow Builder" width="287" height="627" data-path="resources/ai-assistants/flow-builder-settings.png" />
</Frame>

### Identidade do Agente

| Configuração       | Descrição                                                  |
| ------------------ | ---------------------------------------------------------- |
| **Nome do Agente** | Nome que a IA usa para se apresentar                       |
| **Tipo de Agente** | Personalidade predefinida: Vendas, Suporte, Pesquisa, etc. |
| **Idioma**         | Idioma principal para a conversa                           |

### Personalidade

| Configuração      | Opções                           | Descrição                    |
| ----------------- | -------------------------------- | ---------------------------- |
| **Assertividade** | Baixa / Média / Alta             | Quão persistente a IA é      |
| **Humor**         | Desligado / Baixo / Médio / Alto | Nível de humor nas respostas |

### Variáveis

Adicione dados pré-chamada que podem ser usados em suas mensagens:

1. Clique em **Adicionar Variável**
2. Digite um **Nome** (ex: `interesse_produto`)
3. Defina um **Valor Padrão**

Use variáveis em mensagens com chaves: `{nome_variavel}`

**Exemplo:** "Oi {nome_cliente}, vejo que você estava interessado em nosso {interesse_produto}."

### Campos Pós-Chamada

Defina dados para extrair das chamadas:

1. Clique em **Adicionar Campo**
2. Digite **Nome**, **Tipo** e **Descrição**
3. A IA tentará preencher estes baseados na conversa

**Tipos:** `string`, `number`, `boolean`

## Importar/Exportar

### Exportar Seu Fluxo

1. Abra o painel Configurações
2. Role até o final
3. Clique em **Exportar JSON**
4. Salve o arquivo `.json`

### Importar um Fluxo

1. Clique em **Importar JSON** nas configurações
2. Selecione seu arquivo `.json`
3. O fluxo carrega na tela

<Tip>
  Exporte seus fluxos regularmente como backup. Você também pode compartilhar fluxos com membros da equipe desta forma.
</Tip>

## Configurações de Correio de Voz

Configure o que acontece quando correio de voz é detectado:

* **Mensagem de Correio de Voz** - Mensagem para deixar se o correio de voz atender
* **Encerrar Chamada no Correio de Voz** - Alternar para automaticamente desligar no correio de voz

## Salvando Seu Fluxo

Clique no botão **Salvar** no canto superior direito para salvar seu fluxo no assistente.

<Note>
  O fluxo é armazenado como JSON no campo de prompt do sistema do seu assistente. Se você mudar para o Editor Clássico, verá os dados JSON brutos.
</Note>

## Melhores Práticas

<CardGroup cols={2}>
  <Card title="Comece Simples" icon="seedling">
    Comece com um fluxo básico e adicione complexidade gradualmente. Teste a cada etapa.
  </Card>

  <Card title="Use Nós Prompt" icon="brain">
    Nós Prompt dão flexibilidade à IA. Use-os para respostas dinâmicas e conscientes do contexto.
  </Card>

  <Card title="Planeje Seus Resultados" icon="diagram-project">
    Antes de construir, esboce os caminhos principais: respostas positivas, negativas e neutras.
  </Card>

  <Card title="Teste Completamente" icon="vial">
    Faça chamadas de teste cobrindo todos os caminhos. Verifique se cada resultado leva ao destino correto.
  </Card>
</CardGroup>

## Solução de Problemas

<AccordionGroup>
  <Accordion title="Nós não se conectam">
    * Certifique-se de estar arrastando de um **manipulador de saída** (inferior) para um **manipulador de entrada** (superior)
    * Verifique se você não está criando uma conexão circular
    * O nó Início só tem saída, nó Fim só tem entrada
  </Accordion>

  <Accordion title="Fluxo não está salvando">
    * Verifique sua conexão com a internet
    * Certifique-se de ter pelo menos um nó (além do Início)
    * Procure por erros de validação no painel de configurações
  </Accordion>

  <Accordion title="IA não está seguindo o fluxo">
    * Use nós Falar para requisitos de palavras exatas
    * Torne as instruções do nó Prompt mais específicas
    * Verifique se os resultados estão claramente definidos e conectados
  </Accordion>
</AccordionGroup>

## Recursos Relacionados

* [Editor de Prompt de IA](/ai-assistants/ai-prompt-editor) - Alternativa baseada em chat para edição de prompt
* [Guia de Prompts do Sistema](/ai-assistants/system-prompt) - Entendendo fundamentos de prompt
* [Testando Seu Assistente](/ai-assistants/testing) - Como testar seus fluxos