Skip to main content

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.
Fluxo do Flow Builder com blocos conectados

Categorias de Blocos

Configuração

BlocoFunçãoDocumentação
InícioDefine configurações do agenteVer abaixo
Prompt BasePersonalidade e regras do agentePágina dedicada

Fontes de Dados

BlocoFunçãoDocumentação
Cotação HotelConsulta preços em motores de reservasPágina dedicada
Base de ConhecimentoConecta documentos e FAQsVer abaixo
Página WebExtrai informações de websitesVer abaixo
Buscar DadosConsulta dados de APIs ou atributos do ChatwootPágina dedicada

Integrações

BlocoFunçãoDocumentação
Integração APIConecta APIs externas para o agente usarPágina dedicada

Fluxo

BlocoFunçãoDocumentação
RoteadorDireciona conversas por intençãoVer abaixo
CondiçãoCria ramificações por IA ou regra fixaPágina dedicada
Qualificação de LeadAvalia potencial de leadsVer abaixo

Ações

BlocoFunçãoDocumentação
Envio de MensagemEnvia conteúdo fixo com anexosVer abaixo
Coleta de DadosCaptura informações estruturadasVer abaixo
TransferênciaEncaminha para atendimento humanoVer 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.
Bloco de início do Flow Builder

Configurações

CampoDescrição
Nome do AgenteIdentificador único do agente
Modelo de IAClaude Sonnet 3.5 (recomendado) ou Haiku (mais rápido)
TemperaturaCriatividade das respostas (0.0 a 1.0)
Use temperatura baixa (0.3-0.5) para respostas mais consistentes em atendimento. Valores mais altos (0.7-0.9) geram respostas mais criativas.

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.
Configuração de mensagem de aviso

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

CampoDescrição
Ativar mensagem de avisoLiga/desliga o envio automático
Texto da mensagemConteúdo que será enviado

Exemplo de mensagem

🤖 Olá! Sou a assistente virtual do Hotel Bogari.

Posso ajudar com:
• Informações sobre o hotel
• Cotações de hospedagem
• Reservas de espaços para eventos

Como posso ajudar você hoje?
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.
Configuração de recuperação de conversas

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

CampoDescriçãoPadrão
Ativar recuperaçãoHabilita o envio automático de follow-upDesativado
Inatividade (min)Tempo sem resposta antes de enviar mensagem60
Máx. TentativasQuantidade de mensagens de follow-up2
Intervalo entre tentativasTempo entre cada tentativa (minutos)120
Tipo de MensagemAI (contextual) ou FixaAI
Horário de Recovery24h ou horário comercial08:00-20:00

Tipos de mensagem

A IA analisa o contexto da conversa e cria uma mensagem personalizada:
"Oi João! Vi que nossa conversa sobre quartos ficou em aberto.
Posso te ajudar com a reserva? 😊"
Vantagens:
  • Mensagem personalizada ao contexto
  • Detecta se conversa já foi concluída
  • Evita envio quando não faz sentido
Janela de 24h do WhatsApp: A recuperação só funciona dentro da janela de 24 horas após a última mensagem do cliente. Após esse período, seria necessário usar templates aprovados (funcionalidade futura).

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
Para hotéis: Configure 60 minutos de inatividade e 2 tentativas. Isso dá tempo suficiente para o cliente decidir sem ser invasivo.

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

Cliente envia mensagem → Verifica atributos do contato → Regra dispara? → Executa ações

                                                         Não dispara → IA responde normalmente
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:
1

Condição (quando disparar)

Selecione um atributo do contato no Chatwoot e defina a condição:
OperadorSignificadoExemplo
Igual aValor exatotipo_cliente igual a agencia
Diferente deQualquer valor excetostatus diferente de ativo
ContémTexto parcialobservacoes contém vip
Não contémTexto não presentecategoria não contém teste
Os atributos disponíveis são buscados automaticamente do Chatwoot. São os mesmos atributos personalizados que você configura em Configurações > Atributos Personalizados.
2

Ações (o que fazer)

Quando a regra dispara, você pode executar múltiplas ações ao mesmo tempo:
AçãoO que faz
Enviar mensagemEnvia uma mensagem fixa ao contato
Pausar AIInterrompe a IA até que um atendente resolva manualmente
Transferir para humanoEncaminha para a equipe/agente configurado no bloco Transferência
Adicionar tagsAplica etiquetas automaticamente na conversa
3

Mensagem e tags

Se a ação incluir envio de mensagem, defina o texto. Se incluir tags, selecione quais etiquetas aplicar (as etiquetas são buscadas automaticamente do Chatwoot).

Exemplos práticos

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
Resultado: O cliente é reconhecido e transferido diretamente para um atendente, sem passar pela IA.
Se o atributo não existir no contato (nunca foi preenchido), a regra não dispara. Isso é um comportamento de segurança para evitar ações indevidas em contatos novos que ainda não têm atributos configurados.

Bloco Prompt Base

O Prompt Base define a personalidade, regras e comportamento do agente.
Bloco de prompt base

Seções disponíveis

SeçãoO que configurar
ContextoQuem é o agente, onde atua, tom de voz
RegrasO que o agente DEVE fazer
RestriçõesO que o agente NÃO pode fazer
ExemplosPares de pergunta/resposta ideais
GuardrailsProteções de segurança
AvançadoInstruçõ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.
Bloco de cotação de hotel

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).
Bloco de base de conhecimento

Como funciona

Cliente pergunta algo → Agente busca na base → Encontra informação relevante → Responde
A tecnologia RAG permite que o agente consulte seus documentos em tempo real, garantindo respostas precisas e atualizadas sem “inventar” informações.

Configurações

CampoDescrição
Base selecionadaQual base de conhecimento usar
PropósitoDescriçã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.
Bloco de página web

Casos de uso

  • Consultar promoções atualizadas do site
  • Verificar informações de produtos
  • Buscar conteúdo dinâmico que muda frequentemente

Configurações

CampoDescrição
URLEndereço da página a consultar
InstruçõesO que extrair da página
CacheTempo para manter informação em cache (minutos)
Use com moderação. Cada consulta leva alguns segundos. Para informações estáticas, prefira a Base de Conhecimento.

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.
Bloco de busca de dados

Fontes disponíveis

FonteDescrição
Atributo do ContatoCampos personalizados do contato no Chatwoot
Atributo da ConversaCampos personalizados da conversa
API ExternaConsulta HTTP a um sistema externo

Como usar

[Buscar Dados] → armazena em "fetched.plano" → [Condição Determinística] → true/false

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.
Bloco de integração 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)
Bloco de condição

Modos de avaliação

ModoComo funcionaSaídas
LLMIA decide baseado na conversaMúltiplas ramificações + Else
DeterminísticoRegra 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.
Bloco roteador

Como funciona

Mensagem do cliente → [Roteador] → Identifica intenção → Direciona para bloco
A IA analisa o contexto da conversa e determina qual rota seguir, não apenas palavras-chave específicas.

Configuração

1

Adicione rotas

Clique em “Adicionar Rota” para criar um novo caminho.
2

Configure cada rota

Para cada rota, defina:
CampoDescriçãoExemplo
NomeIdentificador da rota”Interesse comercial”
DescriçãoQuando esta rota deve ser acionada”Cliente demonstra interesse em comprar”
DestinoBloco para onde direcionarBloco de Qualificação
3

Configure o fallback

Defina o que acontece quando nenhuma rota corresponde:
  • Responder naturalmente (usar KB)
  • Transferir para humano
  • Pedir esclarecimento

Boas práticas

Use descrições detalhadas nas rotas. A IA usa essas descrições para entender quando ativar cada caminho.
Exemplo de descrições eficazes:
RuimBom
”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

RotaDescrição
CompraCliente quer comprar, perguntar preço, ver catálogo
RastreioCliente quer saber status do pedido, entrega
Troca/DevoluçãoCliente quer trocar ou devolver produto
ReclamaçãoCliente 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.
Bloco de qualificação de lead

Como funciona

Lead entra → [Qualificação] → IA faz perguntas → Atribui pontos → Lead qualificado ou não
A IA conduz a conversa naturalmente, extraindo informações que são usadas para pontuar o lead.

Critérios de qualificação

Defina os critérios que serão avaliados:
CritérioPergunta (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çãoClassificaçãoAção
8-13Lead quenteTransferir imediatamente
4-7Lead mornoColeta de dados → Follow-up
0-3Lead frioContinuar com IA

Ações pós-qualificação

  • 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:
CampoDescriçãoExemplo
metadata.conversation_idID da conversa no Chatwoot"123"
metadata.contact_idID do contato"456"
metadata.account_idID da conta"1"
metadata.contact.nameNome do contato"João Silva"
metadata.contact.phoneTelefone do contato"+5511999999999"
metadata.contact.emailEmail do contato"joao@email.com"
Use os dados de contato no payload para enriquecer seu CRM ou sistema de vendas automaticamente, sem precisar fazer chamadas adicionais à API do Chatwoot.

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.
Bloco de envio de mensagem

Como funciona

Cliente pergunta algo → IA decide se é relevante → Envia mensagem + anexos
Este bloco segue a abordagem LLM-First: o agente de IA decide autonomamente quando usar este conteúdo com base na conversa. Você configura quando usar (via descrição), mas a IA determina o momento ideal.

Configurações

CampoDescriçãoExemplo
IdentificadorID único para referência interna (sem espaços)locacao_salas
NomeNome amigável exibido no Flow Builder”Informações sobre Locação”
Descrição para o AgenteExplica quando o agente deve usar este conteúdo”Use quando o cliente perguntar sobre locação de salas para eventos”
Dica de UsoPalavras-chave que indicam quando usar”eventos, salas, locação, reuniões”

Conteúdo da Mensagem

O texto que será enviado ao cliente. Suporta formatação WhatsApp:
  • *negrito*negrito
  • _itálico_itálico
  • ~riscado~riscado
Temos ótimos espaços para eventos! 🎉

*Opções disponíveis:*
• Sala de Reuniões (até 10 pessoas)
• Auditório (até 50 pessoas)
• Salão de Festas (até 200 pessoas)

Para mais informações, entre em contato: (11) 99999-9999

Opções de comportamento

OpçãoDescrição
Confirmar antes de enviarSugere 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

MensagemDescriçãoAnexo
Espaços para EventosCliente pergunta sobre salas ou eventosPDF com fotos e capacidades
Cardápio do RestauranteCliente pergunta sobre alimentaçãoPDF do menu
TarifárioCliente quer saber preços sem cotaçãoPDF 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:
[Roteador]

    ├─ "Quer informações sobre eventos" → [Envio: PDF de Eventos]

    ├─ "Quer ver cardápio" → [Envio: PDF do Cardápio]

    └─ Outras perguntas → IA responde normalmente
Ao conectar ao Roteador, o bloco só será considerado quando aquela rota for ativada. Isso dá mais controle sobre quando o conteúdo é enviado.

Bloco Coleta de Dados

O bloco de Coleta de Dados captura informações específicas do cliente de forma estruturada.
Bloco de coleta de dados

Como funciona

Cliente entra → [Coleta] → IA solicita campos → Valida respostas → Dados salvos

Tipos de campos

TipoValidaçãoExemplo
TextoNenhuma ou regexNome, Observações
EmailFormato de emailemail@empresa.com
TelefoneFormato de telefone(11) 99999-9999
NúmeroApenas númerosQuantidade, Idade
DataFormato de data25/12/2024
SeleçãoOpções predefinidasSim/Não, Lista

Modos de coleta

A IA pergunta um campo por vez, em ordem:
IA: Qual seu nome completo?
Cliente: João Silva

IA: E seu telefone para contato?
Cliente: 11 99999-9999

IA: Por último, qual seu email?
Cliente: joao@email.com
Quando usar: Cadastros formais, muitos campos obrigatórios

Configurações avançadas

OpçãoDescrição
Pular se conhecidoNão pergunta campos já informados anteriormente
Confirmar antes de salvarPede confirmação: “Os dados estão corretos?”
Validação regexAplica validação customizada (ex: CPF)

Bloco Transferência (Handoff)

O bloco de Transferência encaminha a conversa para um atendente humano.
Bloco de transferência

Como funciona

Trigger → [Handoff] → Verifica disponibilidade → Transfere → Notifica atendente

Configuração

1

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
2

Configure a mensagem

Mensagem enviada ao cliente durante a transferência:
"Vou transferir você para um de nossos especialistas.
Aguarde um momento, por favor!"
3

Defina etiquetas automáticas

Tags aplicadas automaticamente:
  • “lead-qualificado”
  • “urgente”
  • “vip”
4

Configure indisponibilidade

O que fazer se ninguém estiver disponível:
  • Informar horário de atendimento
  • Coletar dados para retorno
  • Manter na fila com IA

Mensagens personalizadas

"Certo! Vou transferir você para {nome_atendente} que
poderá ajudá-lo melhor com essa questão. Um momento!"

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:
[Roteador]
    |
    |-- Quer comprar --> [Handoff Vendas]
    |
    |-- Problema técnico --> [Handoff Suporte]
    |
    |-- Dúvida financeira --> [Handoff Financeiro]
Nesse cenário, se o cliente começar falando sobre um problema técnico, a IA direciona para o Handoff de Suporte. Se no meio da conversa ele mencionar que quer comprar algo, a IA pode direcionar para o Handoff de Vendas em uma próxima interação.
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.
Para fluxos com múltiplas equipes, combine o Roteador com vários blocos de Transferência. Use descrições claras nas rotas para que a IA consiga diferenciar bem cada caso e direcionar para o destino correto.

Combinando Blocos

Os blocos podem ser combinados para criar fluxos sofisticados:

Fluxo de vendas completo

[Roteador]

    ├─ Interesse → [Qualificação]
    │                   │
    │                   ├─ Qualificado → [Coleta] → [Handoff Vendas]
    │                   │
    │                   └─ Não qualificado → IA continua

    ├─ Suporte → [Handoff Suporte]

    └─ Outros → IA responde

Fluxo de hotel

[Roteador]

    ├─ Quer reservar → [Cotação Hotel] → [Coleta Dados]
    │                                         │
    │                                         └─ [Handoff Reservas]

    ├─ Dúvidas → [Base de Conhecimento]

    └─ Problema → [Handoff Suporte]

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.