Pular para o conteúdo
For the complete documentation index, see llms.txt. This page is also available as Markdown.

Distribuição Automática de Atendimentos

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.

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.


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.


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.

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

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


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.

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.


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.

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.


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

Como extrair Logs do Sistema

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:

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.

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.


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.


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.

Atualizado

Isto foi útil?