> For the complete documentation index, see [llms.txt](https://ajuda.zdg.com.br/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://ajuda.zdg.com.br/configuracao-administrador/administracao-painel-admin/canais-de-comunicacao/como-conectar-um-canal-sessao-numero/distribuicao-automatica-de-atendimentos.md).

# Distribuição Automática de Atendimentos

{% hint style="warning" %}
**Disponível para o perfil: Administrador e supervisor**
{% endhint %}

A distribuição automática entrega cada nova conversa direto para um atendente, sem que ninguém precise puxar o atendimento da aba **Pendentes**. O primeiro contato fica mais rápido e a carga de trabalho é dividida entre a equipe.

O Z-PRO tem três pontos para ligar a distribuição:

* **Na fila:** cada departamento tem sua própria regra, com limite de conversas por atendente. É a opção mais completa.
* **No canal:** distribui as conversas novas que chegam por aquele número.
* **No Chat Flow (chatbot):** distribui depois que o robô termina a triagem e encaminha o cliente para uma fila.

{% hint style="info" %}
**Pré-requisitos:**

* Filas criadas em **Gestão Comercial > Filas** (ver Filas).
* Atendentes vinculados às filas e aos canais em que atendem (**Administração > Usuários**).
* Atendentes com status **online**.
  {% endhint %}

***

### Quem pode receber atendimentos distribuídos

* Atendentes e supervisores online.
* Usuários com **perfil personalizado** também entram na distribuição, como um atendente comum. Se você criou um perfil só para gestão, essas pessoas passam a receber conversas (ver Perfis de acesso).
* Usuários com perfil **Admin** e **Superadmin** ficam fora da distribuição.

{% hint style="warning" %}
**Oriente a equipe a ficar offline ao sair.** Quem fecha o sistema sem ficar offline continua recebendo conversas. Para evitar isso, ative **Ficar offline ao fechar a aba** em **Configurações > Gerais** (ver Configurações Gerais).
{% endhint %}

***

### Método 1: Distribuição pela fila

Cada fila pode ter a sua própria distribuição. Quando ligada, os novos clientes daquela fila vão direto para um atendente disponível, respeitando um limite de conversas abertas por pessoa. Quando todos estão no limite, o cliente espera na fila e é entregue assim que alguém termina uma conversa.

**Quando usar:** quando cada departamento tem uma equipe e um volume diferentes, ou quando você quer evitar que um atendente fique sobrecarregado.

**Como configurar:**

1. Acesse **Gestão Comercial > Filas**.
2. Clique em **Nova Fila** ou edite uma fila existente.
3. Ative **Distribuição Automática**.

<figure><img src="https://3541975055-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FM5B652UsmGn3Q7h9Du1t%2Fuploads%2F0Jzn8RzGpMyKCYvTdsjt%2Fimage.png?alt=media&amp;token=577e903a-efec-4383-8aeb-8d6d6aea1b20" alt=""><figcaption></figcaption></figure>

1. Preencha as opções:

| Campo                                 | O que define                                                                                                                                                                    |
| ------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| **Limite de conversas por atendente** | Quantas conversas o atendente pode ter abertas ao mesmo tempo, somando todas as filas em que atende. Mudar o número não afeta conversas já abertas, só as próximas atribuições. |
| **Prioridade de envio**               | Quem é atendido primeiro quando há clientes esperando: quem chegou há mais tempo (**Mais antigos primeiro**) ou quem chegou agora.                                              |
| **Estratégia de distribuição**        | Como escolher entre os atendentes disponíveis quando houver mais de um candidato (ex.: **Balanceada**).                                                                         |

5. Clique em **Salvar**.

**Regras da distribuição pela fila:**

* **Não depende do canal.** Não é preciso ativar **Habilitar auto distribuir** no canal: a fila assume o controle das conversas dela.
* **A aba Pendentes continua funcionando.** O atendente ainda pode puxar uma conversa manualmente.
* **Só age dentro do horário de atendimento da fila.**
* **Carteira tem prioridade.** Cliente com atendente fixo (carteira) vai sempre para o seu atendente, mesmo que ele esteja no limite.
* **Conversas em grupo não entram** nesta regra.

{% hint style="warning" %}
**Uma conversa só entra no rodízio da fila quando:**

* está **sem atendente**: não defina um atendente padrão na conexão;
* não tem **automação em andamento** (chatbot ou integração ainda conversando);
* está **dentro do horário** da fila;
* há um atendente **online abaixo do limite**.
  {% endhint %}

***

### Método 2: Distribuição pelo canal

Distribui as conversas novas que chegam por um canal, de forma balanceada entre os atendentes.

**Quando usar:** atendimento direto em um número, sem triagem de robô e sem regra por departamento.

**Como funciona:** o sistema procura primeiro os atendentes vinculados àquele canal. Se não encontrar ninguém, a conversa vai para outro atendente da empresa. Entre os candidatos, recebe quem tem menos atendimentos no dia.

**Como configurar:**

1. Acesse **Administração > Canais**.
2. Edite o canal desejado.
3. Em **Recursos do Canal**, ative **Habilitar auto distribuir**.
4. Clique em **Salvar alterações**.

<figure><img src="https://3541975055-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FM5B652UsmGn3Q7h9Du1t%2Fuploads%2FsWgG5NscYTlqIuyNLO97%2Fimage.png?alt=media&amp;token=f021820d-ab64-4556-976d-d1bf1f53ae62" alt="" width="375"><figcaption></figcaption></figure>

{% hint style="info" %}
**A fila tem prioridade sobre o canal.** Quando a fila do cliente tem **Distribuição Automática** própria, a opção do canal é ignorada para as conversas daquela fila.
{% endhint %}

***

### Método 3: Distribuição pelo Chat Flow

Distribui a conversa no momento em que o robô encaminha o cliente para uma fila.

**Quando usar:** quando o chatbot primeiro qualifica o cliente (pergunta o nome, o assunto, o departamento) e só **depois** passa para um atendente.

**Como funciona:** ao encaminhar para a fila, o sistema escolhe um atendente online **daquela fila** usando o método definido no fluxo. O robô ou assistente de IA é encerrado no momento em que a conversa é atribuída, então ele não continua respondendo junto com o atendente.

| Método         | Como escolhe o atendente                                                 |
| -------------- | ------------------------------------------------------------------------ |
| **Não**        | Não distribui. A conversa fica em Pendentes até alguém puxar.            |
| **Aleatória**  | Sorteia um atendente online da fila.                                     |
| **Balanceada** | Entrega para o atendente online da fila com menos atendimentos.          |
| **Sequencial** | Entrega em rodízio, um atendente por vez, na mesma ordem (ver detalhes). |

**Como configurar:**

1. Acesse **Automação > Chat Flow** e edite o fluxo desejado.
2. Clique no nó **Configurações**.
3. Em **Auto distribuir atendimento**, escolha o método.
4. Clique em **Salvar**.

<figure><img src="https://3541975055-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FM5B652UsmGn3Q7h9Du1t%2Fuploads%2Fy2gSCHFLeT97neXjusVp%2Fimage.png?alt=media&amp;token=78425cfb-7468-4ce9-8c06-c9222204866a" alt=""><figcaption></figcaption></figure>

{% hint style="info" %}
Se o robô encaminhar para uma fila que tem **Distribuição Automática** ligada, quem distribui é a fila, com o limite de conversas por atendente.
{% endhint %}

***

### Qual método usar

| Situação                                                               | Método indicado                                         |
| ---------------------------------------------------------------------- | ------------------------------------------------------- |
| Departamentos com equipes diferentes e controle de carga por atendente | **Fila**                                                |
| Um número só, atendimento direto, sem departamentos                    | **Canal**                                               |
| Robô faz a triagem antes do atendente                                  | **Chat Flow**, ou **Fila** nas filas de destino do robô |

***

### Como a distribuição convive com outras configurações

| Configuração                                                   | O que acontece                                                                                                                                   |
| -------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------ |
| **Forçar atendimento via Carteira** (Configurações > Gerais)   | Cliente com atendente fixo vai sempre para o dono da carteira, mesmo que ele esteja no limite da fila.                                           |
| **Forçar admin no atendimento** (Configurações > Gerais)       | Ignorado nas filas com distribuição automática: a fila escolhe o atendente.                                                                      |
| **Reabrir toma posse do atendimento** (Configurações > Gerais) | Nas filas com distribuição automática, a conversa reaberta volta para a fila de espera e é redistribuída respeitando o limite.                   |
| **Transbordo de Mensagens** (Configurações > Gerais)           | Se o dono de um atendimento carteirizado estiver offline quando o cliente escrever, a conversa vai para outro atendente online (ver Transbordo). |
| **Redistribuição Automática de Tickets** (Recursos do Canal)   | Redistribui as conversas de atendentes que ficarem offline por mais tempo que o configurado.                                                     |
| **Posição na fila** (Recursos do Canal)                        | Se a conversa for atribuída automaticamente, a mensagem de posição na fila não é enviada.                                                        |

***

### Como saber se a distribuição está funcionando

#### Pelo painel

1. Com pelo menos um atendente online, mande uma mensagem para o canal a partir de um número que **não tenha atendimento aberto**.
2. A conversa deve aparecer direto na aba **Abertos** de um atendente, sem ficar parada em **Pendentes**.
3. Mande de outros números e confira se as conversas estão sendo divididas entre a equipe.

Se a conversa ficar em **Pendentes**, a distribuição não encontrou ninguém para receber. Veja Possíveis erros e soluções.

#### Pelo log do servidor

{% content-ref url="/pages/SVa8dIgq80sQTJ6kJYrG" %}
[Como extrair Logs do Sistema](https://ajuda.zdg.com.br/avancado-recursos-tecnicos/infraestrutura/como-extrair-logs-do-sistema.md)
{% endcontent-ref %}

O log do backend registra cada distribuição: quais atendentes foram considerados, quantos atendimentos cada um tinha e quem foi escolhido.

1. Abra o log do backend seguindo Como extrair Logs do Sistema.
2. Com o log aberto, mande a mensagem de teste.
3. Procure as linhas da distribuição. Na distribuição pelo canal, elas aparecem como `selfDistribute`:

```
selfDistribute iniciado para ticket 7717, whatsappId: 308, queueId: null
Busca por WhatsApp (whatsappId: 308): 0 usuários encontrados
Busca Geral: 9 usuários encontrados
...
SELECIONADO: usuário 3 (Usuario, profile: user) com 0 tickets
Usuário 3 atribuído ao ticket 7717 pelo selfDistribute
```

No exemplo, nenhum atendente estava vinculado ao canal (`0 usuários encontrados`), então a busca se abriu para a empresa toda (`Busca Geral`), e a conversa foi para o candidato com menos atendimentos no dia.

{% hint style="info" %}
Se a conversa está indo para atendentes de outro setor, confira no log se a busca terminou na etapa **Geral**. Isso indica que ninguém vinculado ao canal ou à fila estava disponível.
{% endhint %}

***

### Possíveis erros e soluções

#### A conversa não foi distribuída e ficou em Pendentes

**Causa:** nenhum atendente disponível. Na distribuição pela fila, também acontece quando todos estão no limite de conversas, quando está fora do horário da fila ou quando o robô ainda está conversando com o cliente. **Solução:** confira se há atendentes online e abaixo do limite, o horário da fila e se o fluxo do chatbot já encerrou.

#### A distribuição da fila não funciona em um canal

**Causa:** o canal tem um atendente padrão definido. Conversas que já nascem com atendente não entram no rodízio da fila. **Solução:** remova o atendente padrão na edição do canal.

#### A conversa foi para um atendente de outro setor

**Causa:** na distribuição pelo canal, ninguém vinculado ao canal foi encontrado, e o sistema entregou para outro atendente da empresa. **Solução:** em **Administração > Usuários**, vincule ao canal e às filas os atendentes que devem receber essas conversas. Para controle por departamento, use a distribuição pela fila.

#### Um atendente recebe conversas depois de ir embora

**Causa:** ele fechou o sistema sem ficar offline. **Solução:** oriente a equipe a ficar offline ao sair ou ative **Ficar offline ao fechar a aba** em **Configurações > Gerais**.

#### Um usuário de gestão está recebendo atendimentos

**Causa:** ele usa um perfil personalizado, e perfis personalizados entram na distribuição. **Solução:** troque o perfil dele ou remova-o das filas e canais em que não deve atender.

#### O admin não recebe conversas distribuídas

**Causa:** perfis Admin e Superadmin ficam fora da distribuição automática. **Solução:** é o comportamento esperado. O admin pode puxar a conversa manualmente em Pendentes.

***

{% hint style="info" %}
**Regras mais complexas:** para distribuir com critérios próprios (região, valor do cliente etc.), use uma ferramenta externa como o n8n. Ela recebe os dados do atendimento por Webhook e usa a API do Z-PRO para atribuir o atendente.
{% endhint %}


---

# 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 by asking a question.

Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters:

```
GET https://ajuda.zdg.com.br/configuracao-administrador/administracao-painel-admin/canais-de-comunicacao/como-conectar-um-canal-sessao-numero/distribuicao-automatica-de-atendimentos.md?ask=<question>&goal=<user_goal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case.

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.
