Distribuição de Leads: roleta de atribuição automática aos vendedores

A funcionalidade de Distribuição de Leads (roleta de atendimento) automatiza a atribuição dos novos leads que entram no CRM entre os consultores e vendedores da equipe.

Como acessar

No menu do CRM, acesse Leads → Cadastros → Distribuição (rota /app/distribuicao-leads).

Permissão necessária: Acesso à tela exige a permissão marketing.roletas e a funcionalidade habilitada (crm_roleta).

Métodos de distribuição (DistribuicaoLeadsPage)

A roleta pode operar em um dos três métodos selecionáveis:

1. Round Robin (Rodízio Simples): Distribui os leads sequencialmente entre os membros ativos (ex: Lead 1 → Vendedor A, Lead 2 → Vendedor B, Lead 3 → Vendedor C).
2. Percentual (Pesos de Distribuição): Distribui os leads proporcionalmente aos percentuais atribuídos a cada membro (ex: Vendedor A com 50%, Vendedor B com 30%, Vendedor C com 20%).
3. Menor Carga: Atribui o novo lead ao vendedor que possui a menor quantidade de leads ativos em atendimento no momento.

Configuração dos membros da equipe

Na tabela de membros da roleta, configure individualmente cada colaborador:

• Ativo na Roleta (Switch): Chave para incluir ou remover o vendedor da distribuição.
• Percentual / Peso: Definição da fatia de recebimento de leads no método percentual.
• Limite Máximo de Leads Simultâneos (max_leads_simultaneos): Teto de leads ativos que o colaborador pode receber ao mesmo tempo. Ao atingir o limite, o vendedor para de receber novos leads até concluir ou mover os atendimentos.
• Status Online (Visto por último): Exibe quando o usuário esteve logado pela última vez no CRM (last_seen_at).

Também é possível manter várias regras, definir nome e status, filtrar por funil e canal e considerar horário de trabalho, bloqueios e presença online. A configuração inclui limite global e cooldown.

Ao trocar ou excluir um canal

Se uma regra estiver filtrada por canal, ela só distribui os leads que chegam por esse canal específico. Ao substituir ou excluir uma conexão do WhatsApp, abra Leads → Cadastros → Distribuição, edite cada regra afetada e selecione o canal novo.

Importante: a migração das mensagens automáticas ao excluir uma conexão não altera o canal das regras de distribuição de leads. Uma regra ainda vinculada ao canal antigo deixa os novos leads fora da distribuição automática, mesmo que continue ativa e com membros configurados.

Depois da troca, use o Diagnóstico da regra e valide com um novo lead recebido pelo canal atual. O histórico permite confirmar se houve distribuição automática ou se o responsável foi definido manualmente.

Regras de Fallback e Diagnóstico

• Fallback: Quando ninguém está disponível, escolha entre enviar para a fila de espera ou atribuir ao administrador configurado.
• Disponibilidade: O painel mostra a situação da equipe em tempo real.
• Backlog: A tela permite distribuir leads anteriores à ativação da regra, sem responsável e com conversa nova ou aberta. O contador considera o funil e o canal configurados e não inclui leads atendidos por outra regra mais específica.
• Resultado da distribuição: a tela informa quantos leads foram distribuídos e quantos não puderam ser atribuídos. Falhas não impedem a tentativa dos próximos leads. Se houver membros indisponíveis, confira o Diagnóstico, os limites de atendimento e o responsável de fallback antes de tentar novamente. Conversas fechadas não entram nessa distribuição.
• Processamento parcial: se houver interrupção, os lotes já concluídos permanecem distribuídos. Confira o contador atualizado antes de executar novamente. A mensagem “Ainda há leads a processar” indica que é necessário continuar em outra execução.
• Histórico: Consulte os registros e motivos do processamento.

Guias relacionados

• Lista de leads
• Funis de vendas
• Permissões de usuário