Gerenciar fluxos

Encontrar e abrir

Em Fluxos, pesquise pelo nome. A lista informa o nome e o estado devolvido pela API para cada item. Selecione um fluxo para abrir os detalhes e a prévia; use Editar para alterar o roteiro.

Criar

1. Selecione Criar fluxo.
2. Informe os dados básicos.
3. Adicione as etapas necessárias pela biblioteca de nós.
4. Conecte os caminhos e configure cada etapa.
5. Revise o painel de validação.
6. Use Salvar para enviar um rascunho ou Ativar para criar o fluxo já publicado.

Editar com segurança

O editor mantém uma cópia local por fluxo enquanto houver alterações diferentes da versão carregada. Ao reabrir o fluxo, essa cópia válida preenche os campos. Use Descartar alterações para voltar aos dados recebidos da API. Sem conexão, o salvamento é bloqueado e a cópia permanece no navegador.

O diálogo JSON permite importar ou exportar o schema. A importação verifica a estrutura básica aceita pelo frontend; o painel do editor continua responsável por apontar referências e integrações incompatíveis com o estado carregado.

Fluxos de conversa e privados

O seletor ao lado do nome diferencia o modo de execução do roteiro:

• Conversa: participa do atendimento e suas mensagens compõem o histórico;
• Privado: usa a mesma engine, mas entradas e respostas não entram no histórico do atendimento.

Fluxos protegidos mostram o modo sem permitir alterá-lo. Um fluxo privado não pode ser definido como padrão, encaminhar para atendimento humano nem chamar um subfluxo de conversa. O editor omite essas opções e a API repete a validação ao publicar.

Na avaliação pós-atendimento, use uma etapa Confirmação com Salvar resposta em para registrar Sim/Não, seguida de uma Pergunta numérica com os limites da nota. Ao adicionar Registrar avaliação, os campos de contrato visíveis devem ser ligados a essas respostas. Campos técnicos ocultos, como o identificador da avaliação, são ligados automaticamente ao estado privado e não aparecem no formulário.

Depois que o atendimento é encerrado, toda interação com esse roteiro privado fica fora do histórico. A integração registra a avaliação anonimamente; uma falha técnica é tratada em segundo plano e não exibe erro ao cidadão.

Ativar uma versão

1. Corrija os erros indicados pela validação local.
2. Confirme que as integrações e os destinos existem.
3. Selecione Ativar.
4. Ao publicar uma versão existente, revise o diálogo e confirme. Na criação, Ativar envia a criação com publicação na mesma operação.
5. Só considere a ativação concluída depois da resposta de sucesso e do estado Ativo retornado pela API.

Cuidado

Ativar uma versão afeta novas execuções do atendimento. Não use produção para experimentar mudanças sem revisão.

O frontend envia a publicação para /v1/flows/:flowId/versions/:version/publication ou cria o fluxo com publish: true. A API é a autoridade sobre qual versão passa a executar e como versões anteriores são preservadas.

Estados

• Rascunho: draft na resposta da API;
• Ativo: active na resposta da API;
• Inativo: inactive na resposta da API.

O campo separado has_active_version informa ao frontend se existe alguma versão ativa e controla a disponibilidade de ações como desativar e excluir. Não deduza apenas pelo rótulo da lista se outra versão está ativa.

Desativar

Nos detalhes, Desativar aparece somente com flow.publish, quando has_active_version é verdadeiro e o fluxo não é protegido nem principal. O diálogo informa que novos atendimentos deixarão de usar o fluxo e que os atuais continuarão; a ação envia DELETE /v1/flows/:flowId/publication. Aguarde a resposta da API antes de considerar a operação concluída.

Definir como padrão

Com flow.publish, Definir como padrão aparece para fluxos de conversa que não sejam o principal nem os fluxos reservados de confirmação de encerramento e satisfação. A ação só é habilitada quando has_active_version é verdadeiro e envia PUT /v1/flows/:flowId/initial. Fluxos com execution_mode: "private" nunca oferecem essa ação. O diálogo informa que a mudança vale para novos atendimentos.

Excluir

A exclusão fica disponível com flow.delete apenas para fluxos sem versão ativa e que não sejam protegidos. A confirmação informa que o fluxo e suas versões serão removidos permanentemente; aguarde o sucesso da API.

As ações aparecem conforme as permissões da conta. Ativar, desativar e definir o fluxo padrão exigem flow.publish.