Nós do Fluxo de Chatbot
Os nós são os blocos responsáveis por construir a automação do seu chatbot. Cada nó possui uma função específica dentro do fluxo.

🚀 1. Start (Início do Fluxo)
Tipo: start
Função: Ponto inicial do fluxo.
🔹 O que faz:
- Define onde o chatbot começa.
- Sempre haverá apenas um nó inicial por fluxo.
- Direciona para o próximo nó configurado.
💬 2. Mensagem
Tipo: message
🔹 O que faz:
Envia uma mensagem de texto simples para o usuário.
🔹 Configurações:
- message: Texto enviado ao usuário.
- nextNodeId: Próximo nó do fluxo.
✅ Quando usar:
- Boas-vindas
- Informações diretas
- Avisos simples
🖼️ 3. Multimídia
Tipo: multimedia
🔹 O que faz:
Envia mídia para o usuário.
🔹 Configurações:
- mediaType: Tipo da mídia (image, video, document, etc.)
- mediaUrl: URL do arquivo
- caption: Legenda opcional
- mediaFilename: Nome do arquivo
- nextNodeId: Próximo nó
✅ Quando usar:
- Enviar imagens
- PDFs
- Vídeos explicativos
- Catálogos
❓ 4. Mensagem com Resposta
Tipo: messageWithReply
🔹 O que faz:
Envia uma pergunta e aguarda resposta do usuário.
🔹 Configurações:
- message: Pergunta enviada
- variableName: Nome da variável que armazenará a resposta
- nextNodeId: Próximo nó
✅ Quando usar:
- Coletar nome
- Solicitar e-mail
- Perguntar CPF
- Qualificar atendimento
📋 5. Menu de Opções
Tipo: optionMenu
🔹 O que faz:
Apresenta múltiplas opções numeradas ao usuário.
🔹 Configurações:
- message: Texto do menu
- options:
option: Número da opçãolabel: Texto exibidonextNodeId: Próximo nó de cada opção
✅ Quando usar:
- Menu principal
- Escolha de setor
- Escolha de plano
- Direcionamentos
🤖 6. Gemini AI
Tipo: gemini
🔹 O que faz:
Ativa atendimento com Inteligência Artificial via Google Gemini.
🔹 Configurações:
- customMessage: Mensagem inicial da IA
- preprompt: Instruções base da IA (personalidade e regras)
- temperature: Criatividade da resposta (0 a 1)
- exitKeyword: Palavra-chave para sair da IA
- nextNodeId: Próximo nó após saída
✅ Quando usar:
- Atendimento automatizado inteligente
- FAQ dinâmico
- Respostas abertas
- Assistente virtual
🔗 7. Integração (Webhook)
Tipo: webhook
🔹 O que faz:
Conecta o chatbot a sistemas externos via API.
🔹 Configurações:
- method: GET, POST, etc.
- url: Endpoint da API
- headers: Cabeçalhos da requisição
- body: Corpo da requisição
- variableName: Variável que armazenará a resposta
- timeout: Tempo limite (segundos)
- nextNodeId: Próximo nó
✅ Quando usar:
- Consultar pedidos
- Validar CPF
- Buscar dados no CRM
- Criar registros externos
📊 8. Captura de Dados
Tipo: dataCapture
🔹 O que faz:
Captura e salva informações no perfil do contato.
🔹 Configurações:
- message: Texto solicitando dado
- fieldProfileId: ID do campo do perfil
- fieldName: Nome do campo
- maxRetries: Tentativas máximas
- existingDataAction: Ação se já existir dado (
skip, etc.) - nextNodeId: Próximo nó
✅ Quando usar:
- Cadastro automático
- Atualização de dados
- Enriquecimento de perfil
🔄 9. Atribuir Variável
Tipo: assignVariable
🔹 O que faz:
Cria ou atualiza uma variável interna do fluxo.
🔹 Configurações:
- variableName: Nome da variável
- value: Valor atribuído
- nextNodeId: Próximo nó
✅ Quando usar:
- Criar controle lógico
- Guardar informações temporárias
- Preparar dados para webhook
🏷️ 10. Atribuir Tag
Tipo: tagAssignment
🔹 O que faz:
Adiciona uma tag ao contato.
🔹 Configurações:
- tagId: ID da tag
- nextNodeId: Próximo nó
✅ Quando usar:
- Classificar leads
- Marcar interesse
- Segmentação automática
❌ 11. Remover Tag
Tipo: tagRemoval
🔹 O que faz:
Remove uma tag do contato.
🔹 Configurações:
- tagId: ID da tag
- nextNodeId: Próximo nó
🕒 12. Horário Condicional
Tipo: conditionalSchedule
🔹 O que faz:
Verifica se o atendimento está dentro do horário configurado.
🔹 Configurações:
- schedules: Lista de horários válidos
- nextNodeIdWithin: Fluxo dentro do horário
- nextNodeIdOutside: Fluxo fora do horário
✅ Quando usar:
- Atendimento comercial
- Mensagem automática fora do expediente
- Direcionamento inteligente por horário
📝 13. Nota Interna
Tipo: whisper
🔹 O que faz:
Adiciona uma nota interna visível apenas para a equipe.
🔹 Configurações:
- message: Texto da nota
- nextNodeId: Próximo nó
✅ Quando usar:
- Registrar contexto
- Informações para atendente
- Histórico interno
⏳ 14. Espera (Delay)
Tipo: delay
🔹 O que faz:
Cria uma pausa antes de executar o próximo nó.
🔹 Configurações:
- delaySeconds: Tempo de espera
- nextNodeId: Próximo nó
✅ Quando usar:
- Simular digitação
- Criar tempo entre mensagens
- Melhorar experiência do usuário
🔀 15. Transferir
Tipo: transfer
🔹 O que faz:
Transfere o atendimento para uma fila ou setor.
🔹 Configurações:
- targetQueueId: ID da fila
- startChatbotOnTransfer: Se inicia outro chatbot após transferência
✅ Quando usar:
- Escalar para humano
- Direcionar setor específico
- Atendimento especializado
🛑 16. Fim do Fluxo
Tipo: endOfFlow
🔹 O que faz:
Finaliza a execução do fluxo atual.
✅ Quando usar:
- Encerrar automação
- Finalizar jornada específica
✅ 17. Encerrar Atendimento
Tipo: closeTicket
🔹 O que faz:
Fecha o ticket/conversa do atendimento.
✅ Quando usar:
- Finalização definitiva
- Encerramento automático
- Pós-atendimento
🎯 Conclusão
O fluxo do chatbot é construído conectando esses nós estrategicamente para criar:
- 📈 Funis de vendas
- 🛎️ Atendimento automático
- 🤖 Assistentes com IA
- 🔗 Integrações com sistemas externos
- 🏷️ Segmentações inteligentes