For the complete documentation index, see llms.txt. This page is also available as Markdown.

Atividades

O módulo Atividades permite que o fluxo crie, atualize, transfira e finalize Atividades do Hyperflow Conversas — um sistema de tarefas/casos internos, organizado por Assunto (um quadro com campos próprios, responsável e prazo). É útil para automatizar a abertura e o acompanhamento de tarefas internas a partir de uma conversa, sem que ninguém precise criá-las manualmente.

Uma Atividade é diferente de um atendimento: o atendimento é a conversa em tempo real com o cliente (já coberta pelos módulos Transferir Atendimento e Encerrar Atendimento); a Atividade é uma tarefa/caso interno, organizado em um quadro por Assunto, com responsável, prazo, prioridade e status.


🧭 Como acessar

1

No menu lateral, clique em Gerenciamento de aplicativos.

2

Em seguida, clique em Fluxos.

3

Abra ou crie um fluxo e acesse a área de trabalho do fluxo.

4

No painel de módulos, localize a categoria Atendimento (identificada pela cor laranja).

5

Arraste o módulo Atividades para a área de trabalho do fluxo.


🔍 Conhecendo o módulo

Ao clicar duas vezes no módulo na área de trabalho do fluxo, um painel de configuração é aberto na lateral da tela. O primeiro passo é escolher a Ação desejada:

Ação
O que faz

Criar atividade

Cria uma nova Atividade em um Assunto

Atualizar atividade

Edita os dados de uma Atividade já existente

Transferir atividade

Move uma Atividade existente para outro Assunto

Finalizar atividade

Marca uma Atividade como concluída


1️⃣ Criar atividade

🎯 Propósito

Criar automaticamente uma nova Atividade durante a conversa — por exemplo, para abrir uma tarefa interna quando o cliente relata um problema.

✅ Como fazer na tela

1

Selecione a ação Criar atividade.

2

Selecione o Assunto desejado.

3

Preencha o Título da atividade (obrigatório).

4

Defina o Owner (o campo já vem preenchido com o usuário responsável pelo aplicativo, e não pode ser alterado).

5

Preencha a Descrição, se desejar.

6

Preencha os campos próprios do Assunto escolhido (eles aparecem automaticamente após selecionar o Assunto).

7

Se quiser informar o responsável por e-mail ou variável em vez de escolher da lista, ative Usar variável ou e-mail do responsável.

📌 Resultado esperado

Uma nova Atividade é criada no Assunto escolhido. O fluxo segue pela saída Próximo.


2️⃣ Atualizar atividade

🎯 Propósito

Editar os dados de uma Atividade já existente — por exemplo, atualizar o título ou um campo customizado com base em uma nova informação do cliente.

✅ Como fazer na tela

1

Selecione a ação Atualizar atividade.

2

Informe o Código da Atividade a ser atualizada.

3

Preencha o novo Título, se necessário.

4

Em Campos, escolha quais campos do Assunto devem ser atualizados.

5

Preencha os novos valores dos campos selecionados.

📌 Resultado esperado

Os campos selecionados da Atividade são atualizados. O fluxo segue pela saída Próximo.


3️⃣ Transferir atividade

🎯 Propósito

Mover uma Atividade de um Assunto para outro — por exemplo, encaminhar uma tarefa para um setor diferente do que a originou.

✅ Como fazer na tela

1

Selecione a ação Transferir atividade.

2

Informe o Código da Atividade a ser transferida.

3

Selecione o Assunto de destino.

4

Preencha os campos do Assunto de destino, se necessário.

📌 Resultado esperado

A Atividade é movida para o novo Assunto. O fluxo segue pela saída Próximo.


4️⃣ Finalizar atividade

🎯 Propósito

Marcar uma Atividade como concluída ao final do processo que a originou.

✅ Como fazer na tela

1

Selecione a ação Finalizar atividade.

2

Informe o Código da Atividade a ser finalizada.

📌 Resultado esperado

A Atividade é marcada como concluída. O fluxo segue pela saída Próximo.


🔀 Saída do módulo

Em todas as quatro ações, o módulo tem as mesmas duas saídas:

Saída
Quando acontece

Próximo

A operação foi realizada com sucesso

Erro

Ocorreu um problema ao executar a operação (por exemplo, código não encontrado, campo obrigatório do Assunto não preenchido, ou conexão com o Hyperflow Conversas indisponível)


💡 Caso de uso

Cenário: uma empresa quer abrir automaticamente uma tarefa interna sempre que um cliente relatar um problema técnico durante o atendimento.

Configuração:

  1. Quando o fluxo identificar o relato de um problema, adicione o módulo Atividades.

  2. Selecione a ação Criar atividade, com o Assunto "Suporte Técnico".

  3. Preencha o Título com uma variável, como Problema relatado por {{input.nome}}.

  4. Preencha a Descrição com os detalhes coletados na conversa.

  5. Conecte a saída Próximo para confirmar ao cliente que o time foi avisado.

Resultado: a equipe responsável recebe automaticamente uma nova Atividade com os dados do problema, sem que ninguém precise abri-la manualmente.


📌 Dicas úteis

  • Os campos disponíveis dependem do Assunto escolhido — cadastre o Assunto e seus campos personalizados no Hyperflow Conversas antes de configurar o módulo.

  • Use variáveis do fluxo para preencher automaticamente título, descrição e campos personalizados.

  • Na ação Atualizar atividade, você escolhe quais campos deseja alterar — os demais permanecem inalterados.

  • Como o erro de campos obrigatórios do Assunto só aparece durante a execução do fluxo, teste bem antes de publicar em produção.


📝 Resumo

  • O módulo Atividades cria, atualiza, transfere e finaliza tarefas internas (Atividades) do Hyperflow Conversas.

  • É diferente do atendimento em tempo real — Atividade é uma tarefa/caso organizado por Assunto.

  • Possui quatro ações: Criar, Atualizar, Transferir e Finalizar.

  • Todas as ações compartilham as saídas Próximo (sucesso) e Erro (falha).