> 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/iniciar-atualizar-atendimento.md).

# Iniciar/Atualizar Atendimento

O módulo **Iniciar ou Atualizar Atendimento** cria (ou atualiza, se já existir) o registro de atendimento do contato no Hyperflow Conversas, vinculando-o a um departamento — sem transferir a conversa para um atendente humano. O bot continua no controle da conversa normalmente.

{% hint style="info" %}
Se o objetivo é transferir a conversa para um atendente humano, use o módulo **Transferir Atendimento** no lugar. Este módulo aqui só registra/organiza o atendimento no Hyperflow Conversas, mantendo o atendimento com o bot.
{% endhint %}

<figure><img src="/files/eHnsoJUucGTRnhaXVF00" alt=""><figcaption><p>Imagem 1 - Visão geral do módulo Iniciar ou Atualizar Atendimento na área de trabalho do fluxo.</p></figcaption></figure>

## 🧭 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 **Iniciar ou Atualizar Atendimento** para a área de trabalho do fluxo.

<figure><img src="/files/Sq7anZeE48NUND68Ouma" alt=""><figcaption><p>Imagem 2 - Painel de módulos com a categoria Atendimento expandida e o módulo Iniciar ou Atualizar Atendimento visível.</p></figcaption></figure>

{% hint style="warning" %}
**Antes de usar este módulo:** é necessário ter uma conta do Hyperflow Conversas conectada a este aplicativo.
{% 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.

<figure><img src="/files/svwff14q7ocaRaJha7en" alt=""><figcaption><p>Imagem 3 - Painel de configuração do módulo Iniciar ou Atualizar Atendimento aberto.</p></figcaption></figure>

### 🏢 Departamento

No campo **Departamento**, selecione o departamento do Hyperflow Conversas ao qual esse atendimento deve ser vinculado.

* Se o contato **ainda não tiver** um atendimento ativo, um novo é criado com o departamento selecionado.
* Se o contato **já tiver** um atendimento ativo (em fila, em espera ou já sendo atendido), o departamento desse atendimento é atualizado para o selecionado, sem criar um novo protocolo.

{% hint style="info" %}
**Como atualizar um atendimento:** não existe uma opção separada de "criar" ou "atualizar" — use o mesmo módulo novamente, em outro ponto do fluxo, selecionando o departamento desejado. O Hyperflow Conversas identifica automaticamente que já existe um atendimento ativo para aquela conversa e atualiza o departamento, em vez de criar um novo.
{% endhint %}

{% hint style="warning" %}
Se o atendimento já estiver com um **agente atribuído** e você usar este módulo para trocar o departamento, o agente **continua o mesmo** — o atendimento não volta para a fila nem é desatribuído automaticamente, mesmo que esse agente não pertença ao novo departamento.
{% endhint %}

{% hint style="warning" %}
Ao usar este módulo para trocar o departamento de um atendimento que já está em andamento, algumas telas de visibilidade por departamento usadas por supervisores podem não refletir a mudança imediatamente.
{% endhint %}

<figure><img src="/files/RBmvmtbvsz5QyDtK5YBZ" alt=""><figcaption><p>Imagem 4 - Campo Departamento preenchido.</p></figcaption></figure>

### 🔀 Saídas do módulo

O módulo tem duas saídas:

* **Sucesso** — o atendimento foi criado ou atualizado, e o fluxo continua normalmente com o bot.
* **Erro** — não foi possível criar ou atualizar o atendimento.

<figure><img src="/files/LsAPRfkVMVLnL9Nj1F4i" alt=""><figcaption><p>Imagem 5 - Módulo na área de trabalho do fluxo mostrando as saídas Sucesso e Erro.</p></figcaption></figure>

## 💡 Caso de uso

**Cenário:** uma empresa quer classificar, desde o início da conversa, em qual departamento o atendimento se encaixa, para fins de relatórios — mas sem tirar o atendimento do bot enquanto ele resolve dúvidas simples.

**Configuração:**

1. Logo no início do fluxo, depois de identificar o assunto do cliente, adicione o módulo **Iniciar ou Atualizar Atendimento**.
2. No campo **Departamento**, selecione o departamento correspondente ao assunto identificado (ex.: "Financeiro").
3. Conecte a saída **Sucesso** para o bot continuar o atendimento normalmente.
4. Caso o assunto exija um humano, use o módulo **Transferir Atendimento** mais adiante no fluxo.

**Resultado:** o atendimento já fica registrado e classificado no departamento correto desde o início, mesmo que continue sendo conduzido pelo bot.

## 📌 Dicas úteis

* Use este módulo para organizar métricas e relatórios por departamento, mesmo em atendimentos totalmente automatizados.
* Combine com o módulo **Transferir Atendimento** quando, mais adiante no fluxo, for necessário passar a conversa para um atendente humano.
* Executar este módulo mais de uma vez para o mesmo contato não cria atendimentos duplicados — ele reaproveita o atendimento já ativo.
* Se precisar que um atendimento volte para a fila (sem agente) ao trocar de departamento, use o módulo **Transferir Atendimento** em vez deste, já que a troca de departamento por aqui não remove o agente já atribuído.

## 📝 Resumo

* O módulo **Iniciar ou Atualizar Atendimento** cria ou atualiza o registro de atendimento no Hyperflow Conversas, vinculando-o a um departamento.
* Diferente do módulo **Transferir Atendimento**, este não passa o controle da conversa para um humano — o bot continua atendendo.
* O único campo de configuração é o **Departamento**.
* O módulo tem uma saída de **Sucesso** e uma de **Erro**.
