Visão geral dos blocos
O Flow Builder oferece diferentes tipos de blocos para construir seus fluxos de atendimento. Cada bloco tem uma função específica e pode ser configurado de acordo com suas necessidades.
Categorias de Blocos
Configuração
| Bloco | Função | Documentação |
|---|---|---|
| Início | Define configurações do agente | Ver abaixo |
| Prompt Base | Personalidade e regras do agente | Página dedicada |
Fontes de Dados
| Bloco | Função | Documentação |
|---|---|---|
| Cotação Hotel | Consulta preços em motores de reservas | Página dedicada |
| Base de Conhecimento | Conecta documentos e FAQs | Ver abaixo |
| Página Web | Extrai informações de websites | Ver abaixo |
| Buscar Dados | Consulta dados de APIs ou atributos do Chatwoot | Página dedicada |
Integrações
| Bloco | Função | Documentação |
|---|---|---|
| Integração API | Conecta APIs externas para o agente usar | Página dedicada |
Fluxo
| Bloco | Função | Documentação |
|---|---|---|
| Roteador | Direciona conversas por intenção | Ver abaixo |
| Condição | Cria ramificações por IA ou regra fixa | Página dedicada |
| Qualificação de Lead | Avalia potencial de leads | Ver abaixo |
Ações
| Bloco | Função | Documentação |
|---|---|---|
| Envio de Mensagem | Envia conteúdo fixo com anexos | Ver abaixo |
| Coleta de Dados | Captura informações estruturadas | Ver abaixo |
| Transferência | Encaminha para atendimento humano | Ver abaixo |
Bloco Início
O bloco Início é o ponto de partida do fluxo e define as configurações gerais do agente.O bloco Início é obrigatório e não pode ser removido do fluxo. Todo agente precisa dele para funcionar.

Configurações
| Campo | Descrição |
|---|---|
| Nome do Agente | Identificador único do agente |
| Modelo de IA | Claude Sonnet 3.5 (recomendado) ou Haiku (mais rápido) |
| Temperatura | Criatividade das respostas (0.0 a 1.0) |
Mensagem de Aviso (Boas-vindas)
O bloco Início permite configurar uma Mensagem de Aviso que é enviada automaticamente antes da resposta da IA quando o cliente inicia uma nova conversa.
Quando usar
- Avisar que o atendimento é feito por IA
- Informar horário de funcionamento
- Dar boas-vindas personalizadas
- Avisar sobre tempo de resposta
Configurações
| Campo | Descrição |
|---|---|
| Ativar mensagem de aviso | Liga/desliga o envio automático |
| Texto da mensagem | Conteúdo que será enviado |
Exemplo de mensagem
A mensagem de aviso é enviada apenas na primeira mensagem do cliente em uma nova conversa. Conversas em andamento não recebem esta mensagem novamente.
Recuperação de Conversas Abandonadas
O bloco Início também possui uma seção de Recuperação de Conversas, que permite reengajar automaticamente clientes que abandonaram a conversa.
Quando usar
- Cliente começou uma conversa mas parou de responder
- Processo de cotação/reserva ficou incompleto
- Lead demonstrou interesse mas não finalizou
Configurações de Recovery
| Campo | Descrição | Padrão |
|---|---|---|
| Ativar recuperação | Habilita o envio automático de follow-up | Desativado |
| Inatividade (min) | Tempo sem resposta antes de enviar mensagem | 60 |
| Máx. Tentativas | Quantidade de mensagens de follow-up | 2 |
| Intervalo entre tentativas | Tempo entre cada tentativa (minutos) | 120 |
| Tipo de Mensagem | AI (contextual) ou Fixa | AI |
| Horário de Recovery | 24h ou horário comercial | 08:00-20:00 |
Tipos de mensagem
- Gerada por IA
- Mensagem Fixa
A IA analisa o contexto da conversa e cria uma mensagem personalizada:Vantagens:
- Mensagem personalizada ao contexto
- Detecta se conversa já foi concluída
- Evita envio quando não faz sentido
Condições de parada automática
A régua de recuperação para automaticamente quando:- Cliente responde qualquer mensagem
- Conversa é resolvida/fechada
- Atendente humano assume a conversa
- AI detecta que a conversa foi concluída naturalmente
Gate de Contato (Regras por Atributo)
O bloco Início permite criar regras automáticas baseadas nos atributos do contato no Chatwoot. Essas regras são avaliadas antes da IA responder, permitindo tomar ações imediatas sem processamento de linguagem.Quando usar
- Reconhecer automaticamente clientes recorrentes (ex: hóspedes frequentes)
- Identificar clientes de agências e encaminhar para equipe dedicada
- Pausar a IA para contatos marcados como “VIP” e transferir direto
- Adicionar tags automaticamente com base em atributos do contato
Como funciona
As regras são avaliadas em ordem. A primeira regra que corresponder ao atributo do contato será executada. Regras seguintes não são avaliadas.
Configuração de regras
Cada regra é composta por três partes:Condição (quando disparar)
Selecione um atributo do contato no Chatwoot e defina a condição:
| Operador | Significado | Exemplo |
|---|---|---|
| Igual a | Valor exato | tipo_cliente igual a agencia |
| Diferente de | Qualquer valor exceto | status diferente de ativo |
| Contém | Texto parcial | observacoes contém vip |
| Não contém | Texto não presente | categoria não contém teste |
Ações (o que fazer)
Quando a regra dispara, você pode executar múltiplas ações ao mesmo tempo:
| Ação | O que faz |
|---|---|
| Enviar mensagem | Envia uma mensagem fixa ao contato |
| Pausar AI | Interrompe a IA até que um atendente resolva manualmente |
| Transferir para humano | Encaminha para a equipe/agente configurado no bloco Transferência |
| Adicionar tags | Aplica etiquetas automaticamente na conversa |
Exemplos práticos
- Hotel - Cliente recorrente
- Agência de viagens
- Pausar IA para VIP
Condição:
cliente_habitue igual a trueAções:- Enviar mensagem: “Que bom ter você de volta! Já sou o contato de sempre do hotel.”
- Transferir para humano
Bloco Prompt Base
O Prompt Base define a personalidade, regras e comportamento do agente.
Seções disponíveis
| Seção | O que configurar |
|---|---|
| Contexto | Quem é o agente, onde atua, tom de voz |
| Regras | O que o agente DEVE fazer |
| Restrições | O que o agente NÃO pode fazer |
| Exemplos | Pares de pergunta/resposta ideais |
| Guardrails | Proteções de segurança |
| Avançado | Instruções adicionais |
Documentação completa do Bloco Prompt Base
Acesse o guia detalhado com exemplos para cada seção.
Bloco Cotação Hotel
O bloco Cotação Hotel permite consultas automáticas de preços em motores de reservas.
Funcionalidades
- Consulta preços em tempo real (Omnibees)
- Formatação automática para WhatsApp
- Validação de capacidade de quartos
- Cálculo de parcelamento
- Períodos de estadia mínima
- Detecção automática de grupos com transferência para equipe humana
- Sugestão de hotéis alternativos quando sem disponibilidade
Documentação completa do Bloco Cotação Hotel
Acesse o guia detalhado com todas as configurações.
Bloco Base de Conhecimento
O bloco Base de Conhecimento conecta documentos, FAQs e informações ao agente usando tecnologia RAG (Retrieval-Augmented Generation).
Como funciona
Configurações
| Campo | Descrição |
|---|---|
| Base selecionada | Qual base de conhecimento usar |
| Propósito | Descrição do uso (ajuda a IA a entender quando consultar) |
Antes de usar este bloco, você precisa criar uma Base de Conhecimento no painel do Flow Builder e alimentá-la com documentos.
Documentação relacionada
Base de Conhecimento do Agente
Como vincular e configurar bases no Flow Builder.
O que é RAG?
Entenda a tecnologia por trás da busca inteligente.
Criar Base Eficiente
Aprenda a estruturar sua base para melhores resultados.
Manter Atualizado
Boas práticas de manutenção da base.
Bloco Página Web
O bloco Página Web permite que o agente consulte informações de websites em tempo real.
Casos de uso
- Consultar promoções atualizadas do site
- Verificar informações de produtos
- Buscar conteúdo dinâmico que muda frequentemente
Configurações
| Campo | Descrição |
|---|---|
| URL | Endereço da página a consultar |
| Instruções | O que extrair da página |
| Cache | Tempo para manter informação em cache (minutos) |
Bloco Buscar Dados
O bloco Buscar Dados consulta informações de forma automática e silenciosa — sem envolver a IA. Ele busca um dado de uma API externa, de um atributo do contato ou da conversa, e armazena em uma variável para uso em decisões.
Fontes disponíveis
| Fonte | Descrição |
|---|---|
| Atributo do Contato | Campos personalizados do contato no Chatwoot |
| Atributo da Conversa | Campos personalizados da conversa |
| API Externa | Consulta HTTP a um sistema externo |
Como usar
Documentação completa do Bloco Buscar Dados
Acesse o guia detalhado com exemplos para cada fonte de dados.
Bloco Integração API
O bloco Integração API permite que o agente de IA consulte sistemas externos (ERP, CRM, catálogos) durante a conversa. A IA decide automaticamente quando chamar a API.
Funcionalidades
- Suporte a GET, POST, PUT, PATCH, DELETE
- Autenticação via API Key, Bearer Token ou Basic Auth
- Parâmetros dinâmicos (do usuário, contexto ou fixos)
- Templates de resposta e erro personalizáveis
Documentação completa do Bloco Integração API
Acesse o guia detalhado com configuração e exemplos.
Bloco Condição
O bloco Condição cria ramificações no fluxo. Funciona em dois modos:- LLM: A IA analisa a conversa e decide qual caminho seguir
- Determinístico: Uma regra fixa avalia uma variável (sem IA)

Modos de avaliação
| Modo | Como funciona | Saídas |
|---|---|---|
| LLM | IA decide baseado na conversa | Múltiplas ramificações + Else |
| Determinístico | Regra fixa (variável + operador + valor) | True / False |
Documentação completa do Bloco Condição
Acesse o guia detalhado com operadores e exemplos.
Bloco Roteador
O Roteador é o bloco mais importante do fluxo. Ele analisa a mensagem do cliente e direciona para o caminho apropriado.
Como funciona
Configuração
Configure cada rota
Para cada rota, defina:
| Campo | Descrição | Exemplo |
|---|---|---|
| Nome | Identificador da rota | ”Interesse comercial” |
| Descrição | Quando esta rota deve ser acionada | ”Cliente demonstra interesse em comprar” |
| Destino | Bloco para onde direcionar | Bloco de Qualificação |
Boas práticas
Exemplo de descrições eficazes:| Ruim | Bom |
|---|---|
| ”Comprar" | "Cliente demonstra interesse em adquirir produto ou serviço, pergunta sobre preços, disponibilidade ou como comprar" |
| "Suporte" | "Cliente reporta problema, erro, bug, ou precisa de ajuda técnica com produto já adquirido” |
Exemplos por segmento
- E-commerce
- Imobiliária
- Hotel
| Rota | Descrição |
|---|---|
| Compra | Cliente quer comprar, perguntar preço, ver catálogo |
| Rastreio | Cliente quer saber status do pedido, entrega |
| Troca/Devolução | Cliente quer trocar ou devolver produto |
| Reclamação | Cliente está insatisfeito, reporta problema |
Bloco Qualificação de Lead
O bloco de Qualificação avalia o potencial do lead através de perguntas estratégicas feitas de forma natural pela IA.
Como funciona
Critérios de qualificação
Defina os critérios que serão avaliados:| Critério | Pergunta (IA pergunta naturalmente) | Pontos |
|---|---|---|
| Orçamento | ”Qual sua faixa de investimento?“ | 0-5 |
| Urgência | ”Para quando você precisa?“ | 0-3 |
| Autoridade | ”Você é o decisor?“ | 0-2 |
| Necessidade | ”O que você está buscando resolver?“ | 0-3 |
Faixas de pontuação
| Pontuação | Classificação | Ação |
|---|---|---|
| 8-13 | Lead quente | Transferir imediatamente |
| 4-7 | Lead morno | Coleta de dados → Follow-up |
| 0-3 | Lead frio | Continuar com IA |
Ações pós-qualificação
- Lead Qualificado
- Lead Não Qualificado
- Aplicar etiqueta “lead-qualificado”
- Prioridade alta na fila
- Transferir para equipe de vendas
- Mensagem: “Vou transferir você para um especialista!”
Dados enviados para sistemas externos (Webhook)
Quando o lead é qualificado e uma ação de webhook está configurada, o payload enviado inclui automaticamente os dados de contato do cliente:| Campo | Descrição | Exemplo |
|---|---|---|
metadata.conversation_id | ID da conversa no Chatwoot | "123" |
metadata.contact_id | ID do contato | "456" |
metadata.account_id | ID da conta | "1" |
metadata.contact.name | Nome do contato | "João Silva" |
metadata.contact.phone | Telefone do contato | "+5511999999999" |
metadata.contact.email | Email do contato | "joao@email.com" |
Bloco Envio de Mensagem
O bloco Envio de Mensagem permite que o agente envie conteúdo fixo (texto e anexos) quando relevante para a conversa.
Como funciona
Configurações
| Campo | Descrição | Exemplo |
|---|---|---|
| Identificador | ID único para referência interna (sem espaços) | locacao_salas |
| Nome | Nome amigável exibido no Flow Builder | ”Informações sobre Locação” |
| Descrição para o Agente | Explica quando o agente deve usar este conteúdo | ”Use quando o cliente perguntar sobre locação de salas para eventos” |
| Dica de Uso | Palavras-chave que indicam quando usar | ”eventos, salas, locação, reuniões” |
Conteúdo da Mensagem
- Texto
- Anexos
O texto que será enviado ao cliente. Suporta formatação WhatsApp:
- *negrito* → negrito
- _itálico_ → itálico
- ~riscado~ →
riscado
Opções de comportamento
| Opção | Descrição |
|---|---|
| Confirmar antes de enviar | Sugere que o agente pergunte ao cliente antes de enviar (não garante) |
Por ser LLM-First, o agente pode não usar este conteúdo em todas as situações que você considera relevantes. Quanto melhor a descrição, mais precisa será a decisão da IA.
Casos de uso
- Hotel
- Imobiliária
- E-commerce
| Mensagem | Descrição | Anexo |
|---|---|---|
| Espaços para Eventos | Cliente pergunta sobre salas ou eventos | PDF com fotos e capacidades |
| Cardápio do Restaurante | Cliente pergunta sobre alimentação | PDF do menu |
| Tarifário | Cliente quer saber preços sem cotação | PDF de tarifas |
Conectando ao Roteador
O bloco Envio de Mensagem pode ser conectado ao Roteador para ser usado apenas quando uma intenção específica é detectada:Bloco Coleta de Dados
O bloco de Coleta de Dados captura informações específicas do cliente de forma estruturada.
Como funciona
Tipos de campos
| Tipo | Validação | Exemplo |
|---|---|---|
| Texto | Nenhuma ou regex | Nome, Observações |
| Formato de email | email@empresa.com | |
| Telefone | Formato de telefone | (11) 99999-9999 |
| Número | Apenas números | Quantidade, Idade |
| Data | Formato de data | 25/12/2024 |
| Seleção | Opções predefinidas | Sim/Não, Lista |
Modos de coleta
- Sequencial
- Adaptativo
A IA pergunta um campo por vez, em ordem:Quando usar: Cadastros formais, muitos campos obrigatórios
Configurações avançadas
| Opção | Descrição |
|---|---|
| Pular se conhecido | Não pergunta campos já informados anteriormente |
| Confirmar antes de salvar | Pede confirmação: “Os dados estão corretos?” |
| Validação regex | Aplica validação customizada (ex: CPF) |
Bloco Transferência (Handoff)
O bloco de Transferência encaminha a conversa para um atendente humano.
Como funciona
Configuração
Defina o destino
Escolha para onde transferir:
- Equipe específica: Vendas, Suporte, etc.
- Agente específico: João (Gerente)
- Fila geral: Próximo disponível
Mensagens personalizadas
- Com disponibilidade
- Sem disponibilidade
- Fora do horário
Múltiplos blocos de transferência
Você pode ter vários blocos de Transferência no mesmo fluxo, cada um configurado para uma equipe ou agente diferente. A IA analisa o contexto da conversa e decide automaticamente para qual destino transferir. Exemplo prático:Cada bloco de Transferência pode ter sua própria equipe de destino, mensagem personalizada e etiquetas automáticas. Não há limite para a quantidade de blocos de Transferência no mesmo fluxo.
Combinando Blocos
Os blocos podem ser combinados para criar fluxos sofisticados:Fluxo de vendas completo
Fluxo de hotel
Próximos passos
Bloco Cotação Hotel
Guia completo para cotações de hospedagem.
Bloco Prompt Base
Configure a personalidade do seu agente.
Bloco Buscar Dados
Consulte dados para decisões automáticas.
Bloco Condição
Crie ramificações por IA ou regra fixa.
Bloco Integração API
Conecte APIs externas ao seu agente.
Integrar com Inbox
Conecte seu fluxo a uma caixa de entrada.