Componentes do workflow
O que cada bloco do workflow faz e como configurá-lo — gatilhos, mensagens, mídias, perguntas, condições, variáveis, etiquetas, contato, transferência e ChatGPT.
Dê duplo clique em um bloco para abrir a configuração. Os campos com * são obrigatórios. Em mensagens você pode usar variáveis como {{nome}} e {{telefone}} e as que você mesmo capturar (ex.: {{email}}).
🎯 Trigger Inicial (gatilho)
"Ponto de entrada do workflow" — define quando o fluxo começa.
Tipo de Gatilho *
| Tipo | Quando ativa |
|---|---|
| 🔑 Palavra-chave | Quando palavras específicas são enviadas. |
| 💬 Todas as Conversas | Para qualquer mensagem recebida. ⚠️ "Use com cuidado para evitar loops infinitos." |
| Agendamento | Automaticamente em horários programados (Expressão Cron, ex.: 0 9 * * 1-5 = seg a sex às 9h). |
| Webhook | Quando uma URL recebe uma requisição HTTP. |
| Manual | Só por comando ou API. |
Com Palavra-chave:
- Operador do Gatilho * — 📝 Contém, 🎯 Igual a, ▶️ Começa com, ⏹️ Termina com, 🔧 Expressão Regular;
- Palavras-chave * — digite e + Adicionar (Enter). "⚠️ Adicione pelo menos uma palavra-chave para ativar o gatilho".
Configurações Avançadas
| Campo | Detalhe |
|---|---|
| ⏰ Tempo de Expiração (minutos) | Tempo limite para o gatilho ficar ativo (0 = sempre ativo). |
| ⏱️ Delay entre Mensagens (ms) | Pausa entre o gatilho e a próxima ação. |
| 🏁 Palavra-chave para Finalizar | Ex.: sair, cancelar, parar — interrompe o fluxo. |
| ❓ Mensagem para Resposta Desconhecida | Ex.: "Não entendi sua mensagem..." |
Opções de Comportamento
- 🔄 Manter Gatilho Aberto — permite múltiplas ativações;
- 👁️ Escutar Minhas Mensagens — o fluxo também reage às mensagens que você envia;
- 🛑 Parar Bot com Minhas Mensagens — se você responder manualmente, o bot para;
- ✂️ Dividir Mensagens Longas.
👤 Salvamento Automático de Contatos — "Salvar contato automaticamente quando o trigger for ativado", com Nome padrão para contatos sem nome, Etiquetas para aplicar ao salvar e Listas para adicionar o contato.
O rodapé valida: "✅ Configuração válida" ou "⚠️ Adicione palavras-chave para ativar". 💾 Salvar Configurações.
💬 Enviar Mensagem
Mensagem (com variáveis, ex.: "Olá {{nome}}!"), Anexos (Opcional) e Delay (ms) — tempo antes de enviar.
🖼️ Imagem · 🎵 Áudio · 🎥 Vídeo · 📄 Documento
Cada um tem Escolher arquivo ("Imagem/Áudio/Vídeo/Documento carregado!", Remover) e Legenda (opcional). O áudio tem Formato (MP3, WAV, OGG, AAC). Documentos aceitam PDF, DOC, DOCX ou TXT.
💭 Resposta Avançada
"Sistema inteligente de captura de respostas".
- Modo de Resposta: 📋 Modo Lista (opções numeradas ou com letras) ou 🔍 Modo Dinâmico (validação personalizada);
- Mensagem de Preview — o que o cliente vê (ex.: "Digite sua resposta:");
- Timeout (minutos) e Sem resposta (min);
- Salvar em Variável (opcional) — use como
{{variavel}}nas próximas mensagens; - Opções da Lista — cada uma com Número/Letra, Texto da opção e Valor retornado;
- Tipo de Validação (Modo Dinâmico) — Igual a, Contém, Começa com, Termina com, Expressão Regular; Resposta Esperada; Diferencia maiúsculas/minúsculas.
A janela mostra um Preview WhatsApp de como fica.
📝 Capturar Input
"Captura dados do usuário."
| Campo | Detalhe |
|---|---|
| Tipo de Input | Texto, Número, E-mail, Telefone, Data, Seleção única, Seleção múltipla. |
| Nome da Variável * | Onde guardar (use {{nome_da_variavel}} depois). |
| Mensagem/Pergunta * | Ex.: "Qual é o seu nome completo?" |
| Placeholder (opcional) | |
| Opções de Seleção | Para seleção: Texto exibido e Valor salvo (+ Add). |
| Valor Padrão (opcional) | Usado se o usuário não responder. |
| Campo obrigatório |
Os dados capturados aparecem em Dados dos Workflows.
🔀 Condição
"Configure as condições do fluxo." Nome do Node e Condições (+ Adicionar Condição, combinadas com OU): variável + operador (é igual a, é diferente de, contém, não contém, começa com, termina com, maior que, menor que, está vazio, não está vazio) + valor. Cada condição tem uma saída. Caminho padrão (fallback) — "Se nenhuma condição for atendida, seguir este caminho".
📦 Variável
"Gerencie variáveis do workflow."
- Operação: Definir valor, Obter valor (capturar do usuário), Deletar variável, Incrementar (+1), Decrementar (-1);
- Escopo: Execução (temporária) ou Global (persistente) — a global fica guardada para aquele contato entre execuções;
- Nome da Variável *;
- Para Obter valor: Mensagem para o usuário *, Tipo de dados (Texto, Número, E-mail, Telefone, Data, URL), Validação (Nenhuma, Obrigatório, Formato de e-mail, Formato de telefone, Apenas números, Comprimento mínimo/máximo, Expressão regular), Mensagem de erro ("Valor inválido. Tente novamente."), Valor padrão;
- Para Definir valor: Tipo do valor (Texto, Número, Verdadeiro/Falso, Objeto JSON, Lista/Array) e Valor *.
🏷️ Etiquetas
"Adiciona, remove ou define etiquetas para o contato." Ação: Adicionar etiquetas (às existentes), Remover etiquetas (só as selecionadas) ou Definir etiquetas (substitui todas). Escolha as Etiquetas.
📋 Lista
Gerenciar Lista — "Adicionar/remover contato de lista". Ação (Adicionar à lista / Remover da lista), Lista e Tags Adicionais (opcional).
👤 Salvar Contato
"Define como o contato será salvo automaticamente": Salvamento automático, Atualizar contato existente, Nome padrão para contatos sem nome, Etiquetas para aplicar ao salvar e Listas para adicionar o contato.
🤝 Transferir Atendimento
"Encaminha o contato para um atendente humano."
| Campo | Detalhe |
|---|---|
| Mensagem de despedida ao contato (opcional) | Ex.: "Aguarde, estou te transferindo para um atendente. 🤝" |
| Número para notificar (opcional) | Atendente ou grupo que recebe o aviso. |
| Mensagem para o atendente | Ex.: "📥 Novo contato aguardando: {{contact}}". |
| Tag adicionada ao contato (opcional) | Ex.: aguardando-atendimento. |
| Modo de encaminhamento | Somente pendente (sem atribuição), Enviar para fila específica (ID da fila) ou Enviar para usuário específico (ID do usuário). |
ℹ️ Este nó é final — o workflow encerra após a transferência, e a conversa aparece no Atendimento.
🤖 ChatGPT
"Integração avançada com OpenAI via Evolution API ou Direto."
Modo de Integração:
- 🚀 Evolution API — integração completa via WhatsApp: Instância WhatsApp * (auto-vinculada à do workflow), Credencial OpenAI *, Tipo do Bot (Assistant ou Chat Completion), Modelo (GPT-3.5 Turbo, GPT-4, GPT-4 Turbo, GPT-4o, GPT-4o Mini), Mensagens do Sistema, Tipo de Trigger (Todas as mensagens, Palavra-chave, Nenhum), Operador e Valor do Trigger, Max Tokens, Expiração (min), Palavra de Saída, Delay Mensagem (ms), Mensagem para Resposta Desconhecida, Escutar mensagens enviadas por mim, Parar bot quando eu enviar mensagem, Manter conversa aberta e JIDs para Ignorar.
- 🔗 API Direta — chamada direta para a OpenAI: OpenAI API Key *, Modelo, Temperature (0-2), Prompt * (com variáveis), Max Tokens, Salvar resposta em (variável) e Incluir histórico da conversa.
Componentes em desenvolvimento
Os blocos Aguardar (delay), Webhook, API Request e Fim podem ser colocados no fluxo, mas a janela de configuração deles ainda mostra "🚧 Em Desenvolvimento". Acompanhe e vote no Roadmap.