Como usar o editor de fluxos?

Abrir o editor e a barra superior

Clique no nome de um agente na página “Agentes” para abrir o editor de fluxos. A barra superior contém, da esquerda para a direita:

• A seta de voltar (“Voltar aos agentes”): retorna à lista de agentes.
• O nome do agente: digite por cima para renomear. Os visitantes veem o nome na aba do navegador, e ele pode ser traduzido.
• O link de ajuda: abre este artigo em uma nova aba.
• O selo de status: “Rascunho” em um rascunho, e “Ativa · v3” com o número da versão no ar em um agente publicado. Se você tiver alterações salvas ainda não publicadas, um selo “Alterações não publicadas” aparece ao lado.
• “Prévia”: salva o agente primeiro e depois abre o rascunho em uma nova aba, para você testar as alterações na página que os visitantes verão antes que eles as vejam. A prévia não muda o agente no ar.
• “Publicar”: fica ativo quando há algo a publicar: o agente é um rascunho ou tem alterações não publicadas. A seta ao lado abre “Copiar link público” (indisponível em rascunho), “Adicionar ao site” e, em um agente publicado, “Despublicar”.
• “Salvar”.
• O menu de três pontos (“Ações do agente”), na extrema direita: “Versões” mostra as versões publicadas, o que mudou em cada uma e as opções para voltar a uma anterior; “Histórico de atividades” mostra, a partir do registro de auditoria, quem fez o que e quando neste agente (salvar, publicar, mudanças de versão, renomear); “Excluir” pede confirmação, exclui o agente e leva de volta à lista. Usuários de Suporte e Observador encontram “Copiar link público” aqui.

“Salvar” salva suas alterações no rascunho; os visitantes continuam vendo a versão no ar. “Publicar” abre primeiro a janela “Publicar”, onde você pode adicionar uma “Nota da versão” opcional e confirmar. Depois o agente é salvo e o rascunho entra no ar como uma nova versão numerada (v1, v2, …). “Despublicar” pede confirmação e volta o agente a rascunho. Veja Publicar um agente.

Se você tentar sair do editor com alterações não salvas, será preciso confirmar.

Usuários com a função Suporte ou Observador veem o selo “Somente leitura” no lugar desses botões; a tela e os painéis ficam bloqueados. Eles ainda podem usar “Prévia”, “Versões” e “Copiar link público”; “Histórico de atividades”, “Adicionar ao site” e “Excluir” não aparecem para eles.

As cinco abas

• “Design”: o design da página (logo, cores, layout) e o avatar. Veja Design e avatar.
• “Editor”: a tela onde você monta as etapas. A faixa acima dela traz o botão “Idiomas”, o idioma que você está editando e o botão “Traduzir”. Veja Idiomas e tradução.
• “Avaliação”: pontuação por IA das conversas concluídas e análise de sentimento. Veja Avaliação por IA.
• “Configurações de medição”: envio de eventos da conversa para Google Analytics, Meta Pixel, TikTok e Google Ads.
• “Análise”: inícios, conclusões, o funil e as conversas.

O botão Salvar salva as alterações de todas as abas juntas. Etapas, idioma principal do agente, design, avatar, traduções (inclusive as do nome do agente) e avaliação chegam aos visitantes com “Publicar”; nome, descrição e ícone do agente e as “Configurações de medição” não fazem parte de uma versão e valem assim que você salva.

Adicionar e conectar etapas

1. Na aba “Editor”, clique em “Adicionar etapa”, no canto superior esquerdo. A paleta “Tipos de etapa” abre; busque uma etapa ou filtre por categoria: “IA”, “Conversa”, “Lógica”, “Coleta de dados”, “Suporte”, “Integrações”.
2. Clique em um tipo de etapa; a etapa é adicionada no meio da tela. Clicar em uma integração abre as ações dela, e escolher uma ação adiciona a etapa. Na busca, Enter adiciona o primeiro resultado. Em “Integrações” aparecem suas integrações conectadas com o número de ações; as não conectadas têm a marca “Não conectada”.
3. Conecte etapas arrastando da alça direita de uma etapa até a próxima. Etapas com várias saídas têm uma alça por saída (veja abaixo).
4. Clique em uma etapa para abrir o painel dela à direita e editar o conteúdo.

Etapas com várias saídas:

• Seleção: cada opção.
• Envio de arquivo: as saídas de sucesso e falha, quando a leitura está ativada.
• Assistente de IA: cada transferência.
• Condição: cada caminho e “Caso contrário”.
• Loop: “Para cada item” e “Ao concluir”.
• Resumo e confirmação: “Confirmado” e “Cancelado”.
• Ação de integração e Chamada de ferramenta: “Ao concluir” e “Se falhar”.

A primeira etapa adicionada a um agente vazio vira a etapa inicial. A conversa começa na etapa marcada como “Início”. Para começar em outra etapa, clique em “Definir como etapa inicial” no painel dela. A etapa inicial não pode ser excluída; defina outra como início primeiro. Exclua a etapa selecionada com “Excluir etapa” ou a tecla Backspace.

Os botões de desfazer e refazer ficam na barra de ferramentas; Ctrl+Z / Cmd+Z desfaz, e Ctrl+Shift+Z / Cmd+Shift+Z ou Ctrl+Y refaz.

Em vez de adicionar as etapas você mesmo, pode descrevê-las para a IA: quando o agente não tem etapas, escreva na caixa “O que este agente deve fazer?” no meio da tela; quando tem, use o botão “Perguntar à IA” na barra de ferramentas. A alteração é aplicada à tela, pode ser revertida com um único desfazer e só é salva quando você pressiona “Salvar”. A tela fica bloqueada enquanto a IA trabalha. Veja Criar um agente com IA.

O painel da etapa e as variáveis

As abas do painel dependem do tipo de etapa; elas aparecem nesta ordem:

• “Conteúdo”: em todas as etapas. O “Texto na tela” é mostrado ao visitante e lido em voz alta pelo avatar. Dê um nome à etapa com “Renomear etapa”.
• “Campos”: nas etapas Formulário e nas etapas Envio de arquivo quando a leitura está ativada.
• “Ferramentas”, “Integrações”, “Conhecimento”: só na etapa Assistente de IA.
• “Rastreamento”: em todas as etapas, para enviar um evento de medição quando um visitante chega a ela.

As etapas Pergunta e Seleção gravam a resposta em uma variável (“Nome da variável”). Use-a nos textos das etapas seguintes como {variable}, por exemplo “Obrigado, {name}”. O botão “Inserir variável” nas caixas de texto lista as variáveis salvas pelas etapas anteriores e as “Variáveis do sistema”; digitar { em uma caixa também o abre. Você também pode arrastar o selo de variável de uma etapa da tela para uma caixa de texto do painel aberto.

Etapas com problemas e salvamento

Uma etapa incompleta é marcada na tela, e a barra de ferramentas mostra o botão “Problemas em {n} etapas”, que leva à próxima (“Ir para a próxima etapa com problemas”). Avisos comuns:

• “A saída não está conectada; o fluxo termina aqui.”
• “Nenhuma etapa leva até aqui.”
• “Em um loop que nunca espera o visitante; o fluxo fica preso aqui.”
• “O texto na tela está vazio.” ou “Sem opções.”

Avisos não impedem de salvar. Se algumas etapas tiverem erros, o fluxo é salvo com “Salvo, mas {n} etapas têm erros” e não funcionará nessas etapas; só com avisos, você vê “Salvo”.

Duas coisas impedem o salvamento: um nome de variável vazio ou repetido em um campo de uma etapa Formulário, uma etapa Envio de arquivo ou uma transferência do Assistente de IA; e, com a avaliação ativada, um critério de avaliação sem nome ou sem instruções. Corrija os campos destacados e salve de novo.

Se outra pessoa (ou outra aba do navegador) salvou o agente depois que você o abriu, “Salvar” avisa: a janela “O agente mudou depois que você o abriu” diz quem salvou e quando. “Salvar mesmo assim” substitui as alterações dessa pessoa; “Cancelar” não salva, e suas alterações continuam na tela.