🧩 O Construtor de Fluxos

1. Como um fluxo começa? (Gatilhos)

Toda automação precisa de um "empurrãozinho" para iniciar. Na TooChe, você define isso no menu de configurações do fluxo usando duas opções:

• Palavras-chave: Quando o cliente digita termos específicos (ex: "comprar", "quero orçamento"), o bot acorda e responde. Funciona inclusive para comentários em posts do Instagram e Messenger!
• Gatilhos de Sistema: Disparos invisíveis baseados em eventos. Exemplo: "Iniciar quando o cliente pagar o PIX" ou "Iniciar ao responder a uma campanha em massa".

2. Navegando no Canvas

No lado esquerdo do painel fica a gaveta de componentes — pense neles como peças de Lego. Arraste um bloco para a tela e conecte os "fios" saindo de um nó até a entrada do próximo para desenhar o caminho da conversa.

Para quem prefere o teclado, o menu de adição rápida (clique com o botão direito no canvas) responde a atalhos de uma letra — por exemplo, C cria um bloco de Conteúdo e I cria uma Condição — sem precisar sair do mouse para o menu lateral.

3. Os Blocos (Nodes) do Construtor

Cada bloco possui uma função específica para ajudar você a desenhar a jornada perfeita para o seu cliente. Veja o que cada um faz:

Conteúdo & Interação

Lógica & Dados

Inteligência Artificial & Vendas

4. O poder das Variáveis

As variáveis armazenam informações ao longo do fluxo. Por exemplo, se o robô perguntar o nome do lead no passo de Aguardar Resposta, o dado fica salvo em {{nome}} e pode ser inserido em mensagens, no JSON do webhook ou usado para filtrar caminhos.

O tipo de dado é definido previamente no construtor de variáveis do workspace, determinando exatamente como o sistema armazena e valida cada informação:

• Texto: armazena frases, nomes e códigos. Pode validar respostas contra listas de termos permitidos ou expressões regulares (regex), além de suportar operadores como contém, começa com ou igual a.
• Número: armazena dados numéricos com conversão automática de vírgula brasileira (ex: "19,90" vira 19.9). Pode exigir faixas de valores mínimos e máximos e usar operadores como maior que ou menor que.
• Booleano: representa valores lógicos binários (Verdadeiro ou Falso). Não depende de inferência de texto: seu tipo é estrito e definido no construtor. É manipulado escolhendo diretamente Verdadeiro / Falso no bloco de Ação de Sistema ou consultado em variáveis nativas da plataforma (como janela_24h_aberta). No bloco de Condição, variáveis booleanas abrem automaticamente dois caminhos visuais prontos: Se for SIM e Se for NÃO, dispensando a configuração de operadores manuais.

Se o lead digitar uma resposta incompatível com o tipo ou regras configuradas no passo de resposta, o fluxo repete a pergunta com a mensagem de erro que você personalizou, protegendo seus dados antes de seguir adiante.

5. Integrando com Webhooks e APIs Externas (Bloco HTTP)

O bloco HTTP / Webhook permite que o seu robô se comunique com qualquer sistema externo em tempo real — como seu CRM, ERP, planilhas, ferramentas de automação (n8n, Make, Zapier) ou um servidor próprio.

Configurações do Bloco

• Método HTTP: Suporta POST, GET, PUT, PATCH e DELETE.
• URL (Endpoint): O link de destino da requisição. Aceita variáveis dinâmicas diretamente na URL, por exemplo: https://api.seusistema.com/clientes/{{social_id}}.
• Cabeçalhos (Headers): Parâmetros de requisição e autenticação (ex: Authorization: Bearer {{token}}) e o tipo de conteúdo (Content-Type: application/json).
• Corpo da Requisição (Body JSON): Editor com validação estruturada para montar o payload que a sua API espera receber.

Como enviar Mensagens, Textos e Arquivos de Mídia

Para transmitir dados da conversa via webhook, você utiliza a notação de chaves duplas {{nome_da_variavel}} ou o botão { } Inserir Variável logo acima do editor de JSON:

• Conteúdo de Texto: Salve o que o cliente respondeu em uma variável e posicione-a no JSON. A variável nativa {{nome}} sempre estará disponível.
• Mídias (Imagens, Vídeos, Áudios e Documentos): Em chamadas HTTP, arquivos trafegam como URLs públicas. Se o lead enviou um arquivo, utilize a variável onde a URL do arquivo foi armazenada.

{
  "lead": {
    "nome": "{{nome}}",
    "social_id": "{{social_id}}",
    "canal": "WHATSAPP"
  },
  "mensagem": {
    "resposta": "{{resposta_cliente}}"
  }
}

Salvando o Retorno da API no Fluxo

Ao término da chamada HTTP, é possível capturar a resposta do servidor para tomar decisões automáticas no fluxo:

• Status HTTP: Salva o código de resposta (ex: 200, 201, 400, 404) em uma variável numérica. Permite ligar um bloco de Condição em seguida para checar se o status foi 200 antes de prosseguir.
• Corpo da Resposta (Body): Salva a resposta textual ou JSON retornado pela sua API (até 4.000 caracteres) em uma variável de texto para usar nas mensagens seguintes para o cliente.

6. A Barra Superior: rascunho, publicação e status do fluxo

Tudo o que você edita no canvas fica salvo automaticamente como rascunho — mas isso ainda não afeta o robô em produção. Apenas o que estiver publicado atende os clientes reais, permitindo que você altere a lógica com total segurança.

Outros atalhos úteis da barra superior:

• Desfazer / Refazer: Ctrl + Z desfaz a última alteração no canvas, e Ctrl + Shift + Z refaz.
• Modo Desempenho: alterna o canvas para exibição de métricas reais de execução por nó e taxa de conversão de caminhos (últimos 7 a 30 dias).
• Editar Gatilho: clique no chip com o ícone de raio para alternar entre palavras-chave ou gatilhos de sistema sem sair da tela.