> For the complete documentation index, see [llms.txt](https://docs.patagon.ai/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.patagon.ai/otimizacao-do-agente/lead-routing-and-groups.md).

# Grupos e Round Robin de Leads

Consulte as definições no [sistema de classificação de leads da ILA](/otimizacao-do-agente/ila-rating-system.md).

**O que são Grupos no Patagon AI**

Grupos são conjuntos de membros da equipe que recebem leads de forma organizada. Um grupo pode funcionar de dois modos distintos: como **organizacional** (apenas agrupa pessoas, sem distribuir leads) ou como **canal de roteamento ativo** (distribui leads automaticamente via Round Robin).

A diferença entre os dois modos é controlada por um único toggle: **Atribuição de Leads**.

{% hint style="info" %}
**Onde acessar:** Organização → Roteamento de Leads → aba **Grupos**.
{% endhint %}

**Como criar um grupo**

O formulário de criação tem quatro campos:

<table><thead><tr><th width="205.39453125">Campo</th><th width="159.546875">Obrigatório</th><th>O que fazer</th></tr></thead><tbody><tr><td>Nome do Grupo</td><td>Sim</td><td>Use nomes descritivos: "Vendas SP", "SDR Brasil", "Produto Premium".</td></tr><tr><td>Descrição</td><td>Não</td><td>Contexto sobre o propósito do grupo.</td></tr><tr><td>Atribuição de Leads</td><td>Não</td><td>Toggle que <strong>liga o Round Robin</strong>. Deixe desativado se o grupo for só organizacional.</td></tr><tr><td>Membros</td><td>Sim (para rotear)</td><td>Pesquise e adicione os membros que devem receber leads.</td></tr></tbody></table>

**Passo a passo:**

1. Acesse **Organização → Roteamento de Leads**.
2. Clique em **+ Novo Grupo**.
3. Preencha o Nome (ex.: "Consultores RJ").
4. Adicione uma Descrição opcional.
5. Ative **Atribuição de Leads** se quiser Round Robin ativo.
6. Pesquise e adicione os membros.
7. Clique em **Criar Grupo**.

{% hint style="warning" %}
Um grupo sem Atribuição de Leads ativa existe na plataforma, mas **não distribui leads automaticamente**. Ele funciona apenas como agrupamento visual da equipe.
{% endhint %}

#### **Como funciona a distribuição Round Robin**

Round Robin é o sistema de rotação que distribui leads de forma sequencial e igualitária entre os membros do grupo. Quando a **Atribuição de Leads** está ativada, este é o fluxo completo:

```
Lead entra em contato via WhatsApp
         ↓
Agente de IA processa e qualifica o lead (0★ a 5★)
         ↓
Sistema verifica: existe grupo com Atribuição de Leads ativa?
         ↓
SIM → Lead é atribuído automaticamente ao próximo
      membro na fila Round Robin
         ↓
Esse membro passa a VER o lead na sua visualização de Leads
         ↓
Próximo lead que chegar → vai para o próximo membro da lista
         ↓
Quando chega no último membro → volta para o primeiro
(rotação contínua e cíclica)
```

**Como o Round Robin distribui na prática**

A distribuição é **um por um, em ordem**. Se o grupo tem 3 consultores (Ana, Bruno, Carlos):

* Lead 1 → Ana
* Lead 2 → Bruno
* Lead 3 → Carlos
* Lead 4 → Ana (recomeça)
* Lead 5 → Bruno

E assim por diante. Isso garante que nenhum consultor fique sobrecarregado em relação aos outros.

**Impacto na visibilidade de leads**

Este é um ponto muito importante que afeta o dia a dia da equipe:

<table><thead><tr><th width="295.29296875">Situação do membro</th><th>O que ele vê em Leads → Leads</th></tr></thead><tbody><tr><td>Em grupo com Round Robin ativo</td><td><strong>Apenas os leads atribuídos a ele</strong></td></tr><tr><td>Sem grupo Round Robin ativo</td><td><strong>Todos os leads</strong> da organização</td></tr><tr><td>Admin</td><td><strong>Todos os leads</strong>, sempre</td></tr></tbody></table>

{% hint style="info" %}
Um vendedor em grupo ativo fica focado no próprio pipeline, sem ver leads de colegas. Isso é intencional: evita que múltiplos consultores trabalhem o mesmo lead.
{% endhint %}

**O que acontece quando um lead retorna**

Esta é uma das perguntas mais frequentes. O comportamento documentado é:

> **Um lead já atribuído mantém o mesmo consultor indefinidamente. O Round Robin só atua na chegada de leads novos.**

Ou seja: quando um lead que já foi atribuído à consultora Ana envia uma nova mensagem (depois de dias ou semanas em silêncio), **ele continua aparecendo para Ana**, não volta para a fila do Round Robin. A atribuição é persistente.

```
Lead chega pela 1ª vez → Round Robin atribui para Bruno
Lead fica em silêncio por 3 dias
Lead responde novamente → ainda está com Bruno
Lead responde de novo 2 semanas depois → ainda com Bruno

[Só muda se alguém reatribuir manualmente]
```

**Quando a atribuição muda**

A atribuição só é alterada em dois cenários:

* **Reatribuição manual:** qualquer membro com permissão pode ir em Leads → Leads (ou Leads → Conversas) → aba Informações nos Detalhes do Lead → campo "Atribuído a" → selecionar outro membro. A mudança é salva imediatamente.
* **Remoção do membro do grupo:** remover um membro do grupo **não** reatribui automaticamente os leads que estavam com ele. Os leads ficam com a atribuição antiga e precisam ser reatribuídos manualmente.

{% hint style="warning" %}
**Limitação documentada:** não existe no Patagon AI um mecanismo automático de "memória de consultor", isto é, não há como configurar que um lead que retorna sempre vá para o último consultor que o atendeu. Se isso for importante para o seu processo, a solução é a reatribuição manual via aba Informações do lead.
{% endhint %}

### **Como configurar grupos por região ou produto**

O Patagon AI **não possui roteamento condicional automático**. Não é possível configurar regras do tipo "se o lead veio de São Paulo, vai para o grupo SP" ou "se a campanha é do Produto X, vai para o grupo Produto X" de forma automática por UTM ou fonte de tráfego.

O que é possível é criar **grupos segmentados manualmente**, onde a separação é feita pela forma como o tráfego entra no sistema (agentes diferentes ou atribuição manual). As três abordagens:

{% tabs %}
{% tab title="Região · agentes separados" %}
A maneira mais robusta de separar leads por região é usar **agentes diferentes** para cada região, cada um com seu próprio grupo de roteamento.

**Exemplo: empresa com consultores em SP e RJ**

```
Agente "SP" → número de WhatsApp dedicado SP
  └── Grupo "Consultores SP" (Round Robin ativo)
       ├── Consultor A
       ├── Consultor B
       └── Consultor C

Agente "RJ" → número de WhatsApp dedicado RJ
  └── Grupo "Consultores RJ" (Round Robin ativo)
       ├── Consultor D
       └── Consultor E
```

Leads que entram pelo número SP são roteados apenas para consultores de SP. Leads do número RJ, apenas para consultores de RJ.

{% hint style="success" %}
Esta é a abordagem mais confiável porque a separação acontece na origem (número de WhatsApp), antes mesmo da qualificação.
{% endhint %}
{% endtab %}

{% tab title="Produto · reatribuição manual" %}
Quando todos os leads entram pelo mesmo número, a separação por produto precisa ser feita manualmente após a qualificação.

**Fluxo recomendado:**

1. O lead entra e é qualificado pelo agente (o prompt pode identificar o produto de interesse na conversa).
2. O lead é atribuído pelo Round Robin ao próximo consultor disponível (do grupo geral).
3. O consultor que recebe o lead verifica o interesse e, se necessário, **reatribui manualmente** para o especialista do produto correto (Leads → Detalhes → aba Informações → campo "Atribuído a").
4. Use a **aba Notas** para deixar contexto sobre o produto de interesse antes de reatribuir.

**Alternativa com múltiplos grupos:**

* Crie grupos separados por produto: "Grupo Produto A", "Grupo Produto B".
* O agente qualifica e identifica o produto no resumo da conversa.
* Um gestor ou SDR lê o resumo e faz a reatribuição manual para o grupo correto.

{% hint style="warning" %}
**Limitação importante:** não existe roteamento automático baseado em UTM, fonte de tráfego, palavra-chave da conversa ou produto. Se você precisa desse nível de automação, fale com <support@patagon.ai> para entender se há roadmap para essa funcionalidade.
{% endhint %}
{% endtab %}

{% tab title="Região · número único" %}
Para equipes que usam um único número mas têm consultores regionais:

1. Crie os grupos por região ("SP", "RJ", "Sul", etc.), **todos com Atribuição de Leads desativada** (para não conflitar).
2. O grupo principal (geral) fica com Round Robin ativo.
3. Um coordenador monitora os leads recém-chegados e, ao identificar a região (pelo telefone do lead, pelo DDD ou pela conversa), reatribui manualmente para o consultor da região correta.
   {% endtab %}
   {% endtabs %}

**Gerenciando membros de grupos**

**Adicionar um membro a um grupo**

1. Acesse **Organização → Roteamento de Leads → aba Grupos**.
2. Clique no grupo desejado.
3. Use o campo de pesquisa de Membros para encontrar o membro.
4. Adicione e salve.

**Remover um membro do grupo**

1. Abra o grupo.
2. Clique no botão remover ao lado do membro.
3. Salve as alterações.

{% hint style="success" %}
Remover um membro do grupo **não exclui a conta dele**, apenas o retira da rotação. Os leads já atribuídos a ele permanecem com ele até serem reatribuídos manualmente.
{% endhint %}

#### **Desativar o Round Robin sem excluir o grupo**

Para parar a distribuição automática temporariamente (ex.: durante um feriado ou as férias de um consultor):

* Desative o toggle **Atribuição de Leads** no grupo. Os membros voltam a ver todos os leads.
* Os leads já atribuídos não são perdidos: as atribuições existentes permanecem.

**Visão geral: dois modos de grupo**

| Modo                 | Atribuição de Leads | O que faz                                    | Quando usar                                    |
| -------------------- | ------------------- | -------------------------------------------- | ---------------------------------------------- |
| **Organizacional**   | ❌ Desativado        | Agrupa membros sem rotear leads              | Estruturar a equipe visualmente, sem automação |
| **Roteamento ativo** | ✅ Ativado           | Round Robin: distribui leads automaticamente | Equipes de vendas com múltiplos consultores    |

**Perguntas frequentes**

<details>

<summary><strong>Posso ter múltiplos grupos com Round Robin ativos ao mesmo tempo?</strong></summary>

A plataforma permite criar múltiplos grupos com Atribuição de Leads ativa, mas a documentação não especifica como o sistema decide qual grupo recebe o lead quando há mais de um ativo simultaneamente. Para evitar comportamento imprevisível, a prática recomendada é ter **um único grupo com Round Robin ativo por agente**.

</details>

<details>

<summary><strong>Um membro pode estar em mais de um grupo?</strong></summary>

A plataforma permite adicionar o mesmo membro a múltiplos grupos. O comportamento de visibilidade quando o membro está em mais de um grupo ativo não está documentado explicitamente. Se precisar dessa configuração, teste e valide com o suporte.

</details>

<details>

<summary><strong>O que acontece se todos os membros do grupo forem removidos?</strong></summary>

O grupo continua existindo, mas com Atribuição de Leads ativa e sem membros nenhum lead será atribuído. Mantenha sempre ao menos um membro ativo no grupo de roteamento.

</details>

<details>

<summary><strong>Posso ver quantos leads cada consultor recebeu?</strong></summary>

Sim. Use Leads → Leads → Filtros → campo "Responsável" para filtrar por consultor e visualizar quantos leads estão atribuídos a cada um.

</details>

**Checklist de configuração de grupo por região/produto**

* [ ] Definir a estratégia: agentes separados (mais robusto) ou grupo único com reatribuição manual
* [ ] Criar grupos com nomes descritivos (ex.: "Consultores SP", "Especialistas Produto A")
* [ ] Ativar **Atribuição de Leads** no grupo principal de cada região/produto
* [ ] Adicionar os membros corretos a cada grupo
* [ ] Documentar o processo de reatribuição manual para a equipe (quem faz, quando e como)
* [ ] Comunicar à equipe como a visibilidade de leads funciona (membro em Round Robin ativo vê apenas os próprios leads)


---

# 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.patagon.ai/otimizacao-do-agente/lead-routing-and-groups.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.