Guia técnico
Criar, editar, testar e publicar chatbots
Fluxo completo do chatbot visual: cadastro, construtor, portas, simulação, publicação e acompanhamento.
Cadastro
Criar um chatbot
- Acesse Chatbots.
- Clique em novo chatbot.
- Informe nome e descrição operacional.
- O identificador interno do chatbot é criado automaticamente a partir do nome.
- Defina se o fluxo ficará ativo depois da publicação.
- Salve o cadastro e abra o construtor visual.
Print reservado
Lista de chatbots
Imagem real sugerida: tabela com status, versão publicada e botões de editar fluxo.
Construtor visual
Montar o fluxo
O fluxo é composto por nós e conexões. Cada conexão sai de uma porta do nó de origem e aponta para o próximo nó.
Passo a passo
- Abra o construtor do chatbot.
- Adicione o nó inicial e defina como início do fluxo.
- Configure texto, pergunta, opções ou ação técnica de cada nó.
- Conecte as portas de saída aos próximos nós.
- Inclua fallback em perguntas, menus, IA, API e webhook quando houver risco de erro ou resposta inesperada.
- Salve o rascunho.
- Simule o fluxo antes de publicar.
- Publique uma versão quando a validação não retornar erro bloqueante.
Print reservado
Builder do chatbot
Imagem real sugerida: canvas com nós, portas, fios e painel de configuração.
Desenho do fluxo
Padrões recomendados antes de publicar
Um chatbot bom tem objetivo claro, fallback, handoff e logs fáceis de ler. Evite fluxos grandes sem divisão lógica.
| Padrão | Como montar | Por que importa |
|---|---|---|
| Triagem inicial | Mensagem curta seguida de menu com opções principais. | Reduz resposta livre e melhora roteamento. |
| Coleta de dados | Nós de pergunta salvando variáveis como nome, documento ou assunto. | Entrega contexto ao humano e evita repetir perguntas. |
| Validação simples | Condição verificando variável vazia, contém ou igual a valor esperado. | Previne avanço com dado incompleto. |
| Consulta externa | Nó de API ou webhook com timeout, resposta salva e saída de erro conectada. | Evita fluxo preso quando sistema externo falha. |
| Handoff humano | Nó de departamento ou humano com nota operacional. | Explica por que o atendimento saiu da automação. |
| Encerramento | Nó final com motivo e ação clara. | Facilita relatório e evita conversa em aberto sem necessidade. |
Publicação
Salvar, validar e publicar
Publicar cria uma versão executável. Alterações em rascunho não afetam atendimentos em andamento até nova publicação.
| Etapa | O que acontece | Erro comum |
|---|---|---|
| Salvar rascunho | Guarda o desenho atual do fluxo. | Salvar nó sem texto ou sem configuração obrigatória. |
| Validar | Confere início, nós, portas, conexões e campos técnicos. | Porta inexistente, destino ausente ou nó inalcançável. |
| Simular | Executa o fluxo de forma controlada para revisar saídas. | Menu sem opção compatível ou pergunta sem fallback. |
| Publicar | Cria versão ativa para execução real. | Publicar sem departamento de handoff configurado. |
| Acompanhar | Mostra execuções, logs, status e erros. | Ignorar execução pausada por humano ou erro externo. |
Versões
Rascunho, versão publicada e rollback operacional
O rascunho pode evoluir sem afetar conversas reais. A versão publicada é a que o runtime executa.
Antes de publicar
- Simule caminho feliz, fallback, timeout, erro de API e handoff.
- Confira se todos os nós alcançáveis têm próximo passo esperado.
- Valide nomes de variáveis usadas em prompts, payloads e condições.
- Garanta que departamento de destino existe e está ativo.
- Registre mudança relevante em nota interna de implantação.
Depois de publicar
- Acompanhe execuções reais nas primeiras conversas.
- Procure erros por nó, não apenas erro geral.
- Pause o fluxo se ele transferir para fila errada ou enviar mensagem incorreta.
- Crie novo rascunho para correção; não edite sem simular novamente.
Execuções
Acompanhar atendimentos automatizados
Execuções registram o caminho do contato pelo fluxo, nó atual, status, contexto e logs técnicos.
Status relevantes
- Em execução: fluxo ainda está processando nós automáticos.
- Aguardando entrada: pergunta ou menu espera resposta do contato.
- Pausado para humano: fluxo fez handoff para atendimento manual.
- Finalizado: fluxo chegou ao nó fim ou concluiu a lógica.
- Erro: houve falha de configuração, IA, API, webhook ou agendamento.