> For the complete documentation index, see [llms.txt](https://docs.hablla.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.hablla.com/fluxos-de-automacoes/todos-os-componentes/hablla/transferencia.md).

# Transferência

### Visão Geral

O **Componente de Transferência de Atendimento** é um nó de ação focado no gerenciamento de filas e roteamento de contatos para interação humana. Sua função principal é transferir o cliente ou o ticket de atendimento do autoatendimento automatizado para a fila de espera de um departamento ou para a carteira de um atendente específico.

**Comportamento de Execução Síncrona:** Quando o fluxo chega a este componente, o atendimento automatizado entra em estado de **retenção**. Se houver nós conectados à saída dele, o fluxo continuará travado nesta etapa e qualquer bloco subsequente só será executado no momento em que o operador humano encerrar/finalizar formalmente o atendimento.

### Parâmetros de Configuração

A parametrização do componente determina o destino exato para onde o histórico de interação e o contato serão enviados. Ele é composto por dois critérios essenciais:

* \_*Setor (* Campo Obrigatório):*\* Define a fila ou departamento geral de destino (ex: \_Suporte Técnico*, *Financeiro*, *Vendas*). Ao selecionar uma opção, o ticket entra na lógica de distribuição configurada para aquela fila (como filas rotativas ou round-robin).<br>
* **Usuário (Opcional):** Permite direcionar o atendimento de forma direta e nominal para um operador específico do sistema. Se preenchido, o sistema ignora a fila geral do setor e entrega o ticket diretamente na caixa de entrada do atendente selecionado.<br>

### Construtor Visual

O construtor possui uma interface enxuta e focada em experiência rápida para evitar gargalos na automação:

* **Menus Suspensos Dinâmicos:** Os seletores de *Setor* e *Usuário* realizam buscas em tempo real no banco de dados da plataforma, exibindo apenas opções que estejam ativas e disponíveis no momento da configuração.<br>
* **Validação de Campos:** O indicador visual de asterisco (`*`) ao lado do campo *Setor* sinaliza ao administrador do fluxo que o componente não pode ser salvo ou executado sem que uma fila de destino macro esteja definida.<br>

### Operadores Especiais

Em sistemas de roteamento e transferência de chamados, os "operadores especiais" controlam o comportamento de contingência e as regras de transição de dados:

* **Gatilho de Pós-Atendimento (Callback por Fechamento):** A saída deste componente atua como um escutador de eventos do sistema. Ela intercepta a ação de encerramento do atendente humano e usa esse gatilho para destravar o fluxo, permitindo o envio automático de blocos de mensagens programados para o pós-venda ou suporte.<br>
* **Injeção de Metadados:** Ao realizar a transferência, o componente anexa automaticamente todo o log e as variáveis coletadas nos nós anteriores do fluxo (como o nome capturado ou o problema relatado) e os entrega no painel do atendente humano.<br>
* **Lógica de Transbordo (Fallback Nativo):** Caso o *Usuário* selecionado explicitamente esteja offline ou deslogado do sistema, o componente aciona regras internas de contingência, devolvendo o ticket para a fila geral do *Setor* estipulado para evitar que o cliente fique sem resposta.<br>

### Exemplos Práticos

A tabela abaixo demonstra cenários clássicos de aplicação deste componente na distribuição de demandas de atendimento:

| **Setor Selecionado** | **Usuário Selecionado** | **Próximo Nó Conectado à Saída**                            | **Caso de Uso Prático**                                                                                                                                 |
| --------------------- | ----------------------- | ----------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------- |
| **Financeiro**        | *Nenhum (Fila Geral)*   | **Componente de Pergunta do WhatsApp com pesquisa de CSAT** | O cliente é atendido pelo Financeiro. Assim que o atendente finaliza o chamado, o fluxo destrava e envia a pesquisa de satisfação automaticamente.      |
| **Suporte Avançado**  | **Atendente João**      | *Nenhum (Fim do fluxo)*                                     | Roteamento direcionado para o João. O fluxo se encerra permanentemente na transferência, deixando o ciclo aberto apenas na tela do atendente.           |
| **Comercial**         | *Nenhum (Fila Geral)*   | **Componente Hablla** *(Atualizar Pessoa para "Cliente")*   | O lead é transferido para os vendedores. Após o vendedor finalizar o atendimento com sucesso, o sistema atualiza o status do contato no banco de dados. |


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:

```
GET https://docs.hablla.com/fluxos-de-automacoes/todos-os-componentes/hablla/transferencia.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.