> 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/transferir-para-o-atendente.md).

# Transferir para o atendente

O módulo **Transferir para o atendente** encaminha a conversa do bot para um agente humano no Hyperflow Conversas, para um departamento específico, um agente específico, ou ambos. É o módulo usado sempre que o fluxo identifica que o atendimento precisa continuar com uma pessoa em vez do bot.

<figure><img src="https://3829578295-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FRWteFkm020DS5IbXoSgj%2Fuploads%2FCq5KuDyBI0tC5KTFTMjO%2Fimage.png?alt=media&amp;token=6659dafa-5f3a-40ec-a36a-b289a2d9b61e" alt=""><figcaption><p>Imagem 1 - Visão geral do módulo Transferir 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 **Transferir para o atendente** para a área de trabalho do fluxo.

<figure><img src="https://3829578295-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FRWteFkm020DS5IbXoSgj%2Fuploads%2FQLQ8IkSjPYQcwBwMu0zk%2F02-painel-modulos-atendimento.png?alt=media&amp;token=46df44b6-cd2c-4408-a1c3-bbc86f0be1ac" alt=""><figcaption><p>Imagem 2 - Painel de módulos com a categoria Atendimento expandida e o módulo Transferir Atendimento visível.</p></figcaption></figure>

***

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

{% hint style="warning" %}
**Antes de usar este módulo:** é necessário ter uma conta do Hyperflow Conversas conectada a este aplicativo, com pelo menos um departamento já cadastrado (e, se for indicar um agente específico, com esse agente já cadastrado no departamento). Sem essa conexão, o painel de configuração não exibe os departamentos disponíveis.

Departamentos e agentes são cadastrados diretamente no Hyperflow Conversas, em **Organização > Departamentos** e **Organização > Agentes**. Depois de cadastrar o que for necessário, volte para a área de trabalho do fluxo e reabra o módulo **Transferir para o atendente** para selecioná-los.
{% endhint %}

<figure><img src="https://3829578295-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FRWteFkm020DS5IbXoSgj%2Fuploads%2FM4i6yfrjnxNZFWgNpOoQ%2F03-painel-config-aberto.png?alt=media&amp;token=0717d7c6-40f1-4b14-aec3-4247dd92f254" alt=""><figcaption><p>Imagem 3 - Painel de configuração do módulo Transferir Atendimento aberto.</p></figcaption></figure>

***

#### 🏢 Departamento

Escolha como o departamento será definido:

* **Selecionar departamento** — escolha um departamento já cadastrado, em uma lista.
* **Usar variável ou nome** — informe o nome do departamento diretamente ou através de uma variável do fluxo (ex.: `{{departamento_escolhido}}`).

<figure><img src="https://3829578295-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FRWteFkm020DS5IbXoSgj%2Fuploads%2FCSFMdjDEW3Dy5G5kHJoi%2F04-campo-departamento-opcoes.png?alt=media&amp;token=9ee7a5f3-982f-4d4b-8fc7-dc876cc8d3bb" alt=""><figcaption><p>Imagem 4 - Campo Departamento com as duas opções de preenchimento.</p></figcaption></figure>

***

#### 🙋 Agente (opcional)

Depois de definir o departamento, você pode opcionalmente indicar um agente específico para receber o atendimento:

* **Selecionar agente** — escolha um agente cadastrado naquele departamento, em uma lista.
* **Usar variável ou e-mail** — informe o e-mail do agente diretamente ou através de uma variável do fluxo.

{% hint style="info" %}
Se o departamento for definido por variável ou nome, a seleção de agente por lista não fica disponível — nesse caso, o agente só pode ser indicado por e-mail ou variável.
{% endhint %}

Se nenhum agente for informado, o atendimento entra na fila geral do departamento escolhido.

<figure><img src="https://3829578295-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FRWteFkm020DS5IbXoSgj%2Fuploads%2FEJR8jRTRszHbH4ZDkBuM%2F05-campo-agente-lista.png?alt=media&amp;token=32ad256b-13aa-470d-9273-cd5206e51f1a" alt=""><figcaption><p>Imagem 5 - Campo Agente preenchido com a opção de seleção por lista.</p></figcaption></figure>

***

#### 📝 Observação (opcional)

No campo **Observação**, escreva uma anotação que será exibida apenas para o agente humano no momento em que ele assumir o atendimento — o cliente não vê essa informação. Útil para dar contexto rápido sobre o que já foi conversado com o bot.

<figure><img src="https://3829578295-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FRWteFkm020DS5IbXoSgj%2Fuploads%2F7naMFC2OSNzxImjGemR6%2F06-campo-observacao.png?alt=media&amp;token=fc076c04-5884-4adc-9d61-edb01ced79c0" alt=""><figcaption><p>Imagem 6 - Campo Observação preenchido com uma anotação de contexto.</p></figcaption></figure>

***

#### 🌐 Opções avançadas: transferir outro atendimento

Por padrão, este módulo transfere o atendimento da conversa em andamento (a sessão em execução). Na seção **Opções avançadas** do painel de configuração, é possível transferir um atendimento específico de qualquer contato, informando o protocolo dele.

Ative a chave **Operar atendimento de outro usuário** para revelar o campo:

| Campo                              | O que preencher                                                                                                                                         |
| ---------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------- |
| **ID ou protocolo do atendimento** | O identificador do atendimento que deve ser transferido: o número de protocolo exibido no Hyperflow Conversas, ou uma variável do fluxo que o contenha. |

<figure><img src="https://3829578295-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FRWteFkm020DS5IbXoSgj%2Fuploads%2F19KSPQAPskWkWaQ2wKGs%2Fimage.png?alt=media&amp;token=77662335-3c2b-4589-9341-f822ce887d30" alt=""><figcaption><p>Imagem 7 - Seção Opções avançadas expandida, com a chave Operar atendimento de outro usuário ativada e o campo ID ou protocolo do atendimento preenchido</p></figcaption></figure>

{% hint style="warning" %}
Só é possível transferir um atendimento que ainda esteja aberto (em fila, em espera ou em atendimento). Se o atendimento informado já estiver encerrado, ou se o protocolo não existir, a execução segue pela saída **Erro**.
{% endhint %}

***

#### 🔀 Saída do módulo

Este módulo tem uma saída opcional chamada **Próximo**.

{% hint style="warning" %}
A saída **Próximo** não é ativada assim que o módulo é executado. Ela só é ativada **quando o atendimento humano é finalizado** no Hyperflow Conversas — nesse momento, o fluxo retoma exatamente nesse ponto, permitindo continuar automaticamente após o fim do atendimento humano (por exemplo, para enviar uma pesquisa de satisfação).
{% endhint %}

Se você não conectar nada a essa saída, o fluxo simplesmente não retoma depois do atendimento humano ser finalizado.

***

### 💡 Caso de uso

**Cenário:** o cliente pede para falar com um atendente durante a conversa com o bot, e a empresa quer enviar uma pesquisa de satisfação automaticamente assim que o atendimento humano terminar.

**Configuração:**

1. Adicione o módulo **Transferir para o atendente** ao fluxo, no ponto onde o cliente pede atendimento humano.
2. No campo **Departamento**, selecione o departamento de "Suporte".
3. Deixe o campo **Agente** em branco, para que o atendimento entre na fila geral do departamento.
4. No campo **Observação**, escreva um resumo do que o cliente já informou ao bot.
5. Conecte a saída **Próximo** ao módulo **Pesquisa de Satisfação**.

**Resultado:** o cliente é atendido por um agente humano do Suporte; assim que o agente finalizar o atendimento no Hyperflow Conversas, o fluxo retoma automaticamente e envia a pesquisa de satisfação.

***

### 📌 Dicas úteis

* Use a **Observação** para evitar que o cliente precise repetir informações já passadas ao bot.
* Deixe o campo **Agente** em branco quando quiser que o atendimento siga a fila normal de distribuição do departamento.
* Conecte a saída **Próximo** sempre que precisar de alguma ação automática após o fim do atendimento humano (pesquisa de satisfação, mensagem de encerramento, etc.).
* Enquanto o atendimento estiver com um agente humano, o bot não processa mais as mensagens do cliente naquele fluxo.
* Use a seção **Opções avançadas** para transferir um atendimento de outro contato (por ID ou protocolo), em vez do atendimento da conversa em andamento.

***

### 📝 Resumo

* O módulo **Transferir Atendimento** encaminha a conversa para um agente humano, por departamento e/ou agente específico.
* O agente pode ser selecionado em lista ou informado por e-mail/variável; o mesmo vale para o departamento.
* O campo **Observação** é visível apenas para o agente humano.
* A saída **Próximo** só é ativada quando o atendimento humano é finalizado, não no momento da transferência.
* Nas **Opções avançadas**, é possível transferir um atendimento específico de outro contato, informando seu ID ou protocolo; se ele não existir ou já estiver encerrado, a execução segue pela saída **Erro**.