Módulo: Retorno de Função Painel do Construtor > Fluxo de Função

🧠 O que é esse bloco? É um bloco finalizador, exclusivo para ser usado dentro de um "Fluxo de Função". Sua principal responsabilidade é concluir a execução da função e determinar o que acontece em seguida. Toda função que é acionada precisa de uma resposta, e é o módulo "Retorno de função" que formaliza essa conclusão. Clique e arraste o módulo Retorno de função até o painel construtor do chatbot 🧩 Estrutura da interface: • Nome menu: Campo para identificar o bloco no fluxo. • Tipo de retorno: Devolver fluxo pro agente ou Encerrar fluxo do agente • Mensagem de retorno: Campo para inserir a mensagem ou o dado que será retornado. Pode ser um texto fixo ou uma variável dinâmica (ex: @http.body). • Enviar mensagem de retorno pós processamento: Chave seletora que, quando ativa, envia o conteúdo da "Mensagem de retorno" diretamente para o usuário. • Enviar a mensagem como sussurro?: Chave seletora se ativa envia a mensagem como uma nota interna, visível apenas para atendentes humanos (se aplicável), e não para o cliente. 💡 Para que serve? A função principal deste bloco é gerenciar o encerramento de uma rotina de função e devolver uma resposta ou controle para o fluxo principal. Ele serve para: • Finalizar um processo: Concluir a interação após uma tarefa ser executada (ex: consulta finalizada). • Devolver dados ao agente: Enviar informações coletadas em uma API de volta para o agente inteligente, que poderá usar esses dados para continuar a conversa. • Controlar o fluxo da conversa: Decidir se o atendimento deve ser encerrado ou continuar nas mãos do agente. 🖱️ Como configurar: 6. Dentro de um "Fluxo de Função", após os blocos de lógica (como um bloco de Requisição HTTP), adicione o bloco "Retorno de função". 7. Conecte o bloco anterior (ex: Requisição HTTP) à entrada do bloco "Retorno de função". 8. No campo "Tipo de retorno", escolha a ação desejada: o Encerrar fluxo do agente: Para finalizar o processo. o Devolver fluxo pro agente: Para enviar dados de volta ao agente que chamou a função. 9. No campo "Mensagem de retorno", insira o texto ou a variável (ex: @http.body) que deve ser retornada. 10. Ative ou desative as chaves seletoras conforme sua necessidade de notificar o usuário. ✍️ Exemplos de uso: • Para finalizar o atendimento; o Cenário: A função foi chamada para realizar uma tarefa que encerra a necessidade do cliente. o Configuração:  Tipo de retorno: Encerrar fluxo do agente  Mensagem de retorno: "atendimento finalizado com sucesso!"  Enviar mensagem de retorno pós processamento: Ativado. o Resultado: O fluxo da função termina, o cliente recebe a mensagem de sucesso e o chat é finalizado em seguida. • Para retornar dados de uma API: o Cenário: O agente precisa consultar o CPF do cliente em um sistema externo para verificar pendências financeiras. o Configuração:  Tipo de retorno: Devolver fluxo pro agente  Mensagem de retorno: @http.body (variável que contém a resposta da API).  Enviar mensagem...: Desativado (o agente usará o dado, não o exibirá para o cliente). o Resultado: O controle volta para o agente. O agente agora tem acesso ao conteúdo de @http.body e pode usá-lo para dar uma resposta inteligente, como: "Consultei aqui e encontrei as seguintes pendências: ...". ✅ Boas práticas: • Use sempre um bloco de "Retorno de função" para finalizar seus fluxos de função. • Ao retornar dados de APIs, use variáveis. Isso torna seu agente dinâmico e capaz de lidar com informações em tempo real. • Se a "Mensagem de retorno" for para o usuário, capriche no texto para ser claro e cordial. Se for um dado para o agente, garanta que o formato seja o correto (ex: JSON). ⚠️ Atenção: • A ausência de um "Retorno de função" fará com que o fluxo quebre. A função ficará em um loop infinito esperando uma conclusão que nunca chegará, resultando em erro. • Este bloco é de uso exclusivo em "Fluxos de Função". Ele não aparecerá ou funcionará em fluxos de agente comuns. 🔁 A plataforma está em constante evolução! Essa funcionalidade pode ganhar novos tipos de retorno e integrações no futuro. 📩 Em caso de dúvidas, entre em contato com o suporte.