> For the complete documentation index, see [llms.txt](https://help.hyperflow.global/docs/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://help.hyperflow.global/docs/builder-hyperflow/gerenciamento-de-aplicativos/fluxos/atendimento/atividades.md).

# 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.

{% hint style="info" %}
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.
{% endhint %}

***

## 🧭 Como acessar

{% stepper %}
{% step %}
No menu lateral, clique em **Gerenciamento de aplicativos**.
{% endstep %}

{% step %}
Em seguida, clique em **Fluxos**.
{% endstep %}

{% step %}
Abra ou crie um fluxo e acesse a área de trabalho do fluxo.
{% endstep %}

{% step %}
No painel de módulos, localize a categoria **Atendimento** (identificada pela cor laranja).
{% endstep %}

{% step %}
Arraste o módulo **Atividades** para a área de trabalho do fluxo.
{% endstep %}
{% endstepper %}

{% hint style="warning" %}
**Antes de usar este módulo:** é necessário ter uma conta do Hyperflow Conversas conectada, com pelo menos um **Assunto** de Atividades já cadastrado por lá.
{% endhint %}

***

## 🔍 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

{% stepper %}
{% step %}
Selecione a ação **Criar atividade**.
{% endstep %}

{% step %}
Selecione o **Assunto** desejado.
{% endstep %}

{% step %}
Preencha o **Título da atividade** (obrigatório).
{% endstep %}

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

{% step %}
Preencha a **Descrição**, se desejar.
{% endstep %}

{% step %}
Preencha os campos próprios do Assunto escolhido (eles aparecem automaticamente após selecionar o Assunto).
{% endstep %}

{% step %}
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**.
{% endstep %}
{% endstepper %}

#### 📌 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

{% stepper %}
{% step %}
Selecione a ação **Atualizar atividade**.
{% endstep %}

{% step %}
Informe o **Código** da Atividade a ser atualizada.
{% endstep %}

{% step %}
Preencha o novo **Título**, se necessário.
{% endstep %}

{% step %}
Em **Campos**, escolha quais campos do Assunto devem ser atualizados.
{% endstep %}

{% step %}
Preencha os novos valores dos campos selecionados.
{% endstep %}
{% endstepper %}

#### 📌 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

{% stepper %}
{% step %}
Selecione a ação **Transferir atividade**.
{% endstep %}

{% step %}
Informe o **Código** da Atividade a ser transferida.
{% endstep %}

{% step %}
Selecione o **Assunto de destino**.
{% endstep %}

{% step %}
Preencha os campos do Assunto de destino, se necessário.
{% endstep %}
{% endstepper %}

#### 📌 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

{% stepper %}
{% step %}
Selecione a ação **Finalizar atividade**.
{% endstep %}

{% step %}
Informe o **Código** da Atividade a ser finalizada.
{% endstep %}
{% endstepper %}

#### 📌 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) |

{% hint style="warning" %}
Se o Assunto exigir campos como Responsável, Prazo, Prioridade ou Status, e esses campos não forem preenchidos, o erro só aparece quando o fluxo é executado — não ao salvar ou publicar o módulo. Preencha esses campos sempre que o Assunto exigir, para evitar falhas em produção.
{% endhint %}

***

## 💡 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).