Central de ajuda

Configuração do administrador

Distribuição Automática de Atendimentos

Disponível para o perfil: Administrador e supervisor

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 sistema tem três pontos para ligar a distribuição:

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

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


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:

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.

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

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.

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 sistema para atribuir o atendente.