Flow Builder

Variáveis criadas pelo bloco Pergunta

Ao configurar um bloco Pergunta, você define o nome da variável que vai guardar a resposta. Exemplo: bloco pergunta "Qual o seu CPF?" com variável cpf_cliente. A partir daí, o bloco de HTTP Request pode usar ${cpf_cliente} na URL ou no body da requisição.

Variáveis criadas pelo bloco HTTP Request

O bloco HTTP Request permite mapear campos da resposta JSON para variáveis. Exemplo: a API retorna { "status": "ativo", "plano": "premium" }. Você mapeia status → variável status_cliente e plano → variável plano_cliente. O bloco de Condição pode então checar se ${status_cliente} é igual a ativo e bifurcar o fluxo.

Follow-up automático

O Follow-up lembra o contato quando ele ainda não respondeu a uma pergunta ou não escolheu uma opção do menu. Ele aparece na barra lateral do editor, mas não é um bloco ligado por setas: é uma configuração geral do flow.

Como os intervalos são contados

Cada espera começa depois da etapa anterior. Exemplo:

• etapa 1: aguardar 10 minutos;
• etapa 2: aguardar mais 1 hora;
• encerramento: aguardar 24 horas depois da etapa 2.

Sem resposta, a primeira mensagem chega aproximadamente 10 minutos depois da pergunta, a segunda aproximadamente 1h10 depois da pergunta e o ticket é encerrado 24 horas após a segunda mensagem.

Exemplo de mensagens

Após 10 minutos: “Oi, ainda estou por aqui. Você conseguiu escolher uma das opções?”

Depois de mais 1 hora: “Se ainda precisar de ajuda, responda esta mensagem e continuamos de onde paramos.”

Boas práticas

• Use mensagens curtas e diferentes entre si.
• Evite intervalos muito pequenos.
• Não repita a pergunta inteira em todas as etapas.
• Teste se uma resposta cancela a mensagem seguinte.
• Use encerramento automático somente quando combinar com o processo da equipe.

Configurar o bloco HTTP Request

Use o HTTP Request para consultar ou atualizar outro sistema durante o flow. Ele aceita URL com variáveis, métodos GET/POST/PUT/PATCH/DELETE, headers, query params, body e timeout.

Campos principais

Exemplo: consultar cliente pelo CPF

Depois de salvar a resposta de uma Pergunta em cpf_cliente, configure:

Método: GET
URL: https://api.exemplo.com/clientes/${cpf_cliente}
Timeout: 10000

Headers:

{
  "Authorization": "Bearer SEU_TOKEN",
  "Accept": "application/json"
}

Para uma resposta como:

{
  "data": {
    "status": "ativo",
    "plano": "premium"
  }
}

Mapeie os caminhos:

data.status → status_cliente
data.plano  → plano_cliente

Salve também o código HTTP em http_status e o resultado em consulta_ok. Em seguida, conecte um bloco Condição para separar sucesso e erro.

Testar a requisição

1. Preencha valores fictícios nas variáveis de teste.
2. Clique no botão de teste do bloco.
3. Confira status, resposta e caminhos JSON.
4. Salve somente depois de validar os dois caminhos do flow.

Configurar Segunda via de boleto

O bloco consulta cobranças pelo documento informado na conversa. Dependendo do provedor, pode devolver valor, vencimento, link da fatura, linha digitável, PIX e PDF.

Escolha o provedor e configure as credenciais dentro do próprio bloco. Depois, selecione a variável que contém o CPF/CNPJ e personalize as mensagens para:

• cobrança encontrada;
• cliente não encontrado;
• nenhuma cobrança em aberto;
• documento inválido;
• erro de integração.

Criar um flow básico (menu de departamentos)

Vincular um flow à conexão ou fila

Existem duas formas de acionar um flow de conversa:

• Flow de boas-vindas (conexão) — aciona o flow quando um cliente manda mensagem pela primeira vez naquele número. Configure em Conexões → Editar → "Flow de boas-vindas".
• Flow de fila — aciona o flow quando o ticket entra em uma fila específica. Configure em Filas → Editar → "Integração".

Aba: Fluxo por palavra chave

Esta aba permite disparar um flow automaticamente quando o cliente enviar uma frase ou palavra específica. É diferente do flow de conversa — não precisa estar vinculado a uma conexão nem a uma fila. Funciona como uma palavra de ativação: o cliente digita a frase e o flow inicia imediatamente.

A lista exibe os disparos cadastrados com Nome, Status (Ativo / Desativado) e ícones de Editar e Excluir.

Criar um disparo por palavra chave

Testar o flow

No editor, clique em "Testar Fluxo" para simular o fluxo como se fosse o cliente. O simulador mostra as mensagens que seriam enviadas e permite navegar pelas opções de menu. Teste sempre antes de ativar o flow em produção — principalmente quando usar blocos de Condição ou variáveis vindas de Perguntas.