Commit e189d1

2026-10-02 20:31:48 Felipe Madril: -/-
alocação automática.md ..
@@ 2,7 2,7 @@
A **alocação automática** procura sozinha um especialista para o chamado. Ao registrar um chamado **sem especialista vinculado**, o sistema começa a busca na hora: oferece o chamado a um especialista de cada vez, respeita o prazo de resposta de cada um e, quando alguém aceita, vincula o especialista e gera a OS.
- > Disponível com a **Central de Chamados** ativa. Veja [[Central de Chamados]].
+ > Disponível com a **Central de Chamados** ativa. Veja [[04 - Central de Chamados|Central de Chamados]].
---
@@ 36,13 36,13 @@
| 3 | **Disponível** | Está com a **disponibilidade ligada** no cadastro. O horário não é consultado aqui: são os períodos de disponibilidade que ligam e desligam essa chave (veja abaixo) |
| 3b | **Sem agenda conflitante** | Não pode ter outra OS ou chamado agendado no mesmo período (veja abaixo) |
| 4 | **Qualificado na categoria** | Atende alguma das **categorias de serviço solicitadas**. Chamado sem categoria não restringe ninguém; especialista sem categoria vinculada também não fica restrito |
- | 5 | **Cobre a região** | O endereço de atendimento está em uma **região atendida** por ele. Sem nenhuma região cadastrada, ele atende qualquer lugar. A cidade é comparada sem diferenciar acento ou maiúsculas — "Sao Leopoldo" e "São Leopoldo" são a mesma cidade |
+ | 5 | **Cobre a região** | O endereço de atendimento está em uma **região atendida** por ele. Sem nenhuma região cadastrada, ele atende qualquer lugar. A cidade é comparada sem diferenciar acento ou maiúsculas — "Sao Leopoldo" e "São Leopoldo" são a mesma cidade *(Novo)* |
- > **Rua e cidade são obrigatórias na abertura do chamado.** É a regra 5 que exige: endereço sem cidade não casa com região nenhuma, e o chamado ficaria buscando especialista até o prazo vencer, sem oferta para ninguém. Tanto a tela quanto a API recusam a abertura sem esses dois campos.
+ > **Rua e cidade são obrigatórias na abertura do chamado** *(Novo)*. É a regra 5 que exige: endereço sem cidade não casa com região nenhuma, e o chamado ficaria buscando especialista até o prazo vencer, sem oferta para ninguém. Tanto a tela quanto os canais externos (site e WhatsApp) recusam a abertura sem esses dois campos.
Entre os elegíveis, **vem primeiro quem está há mais tempo sem receber uma alocação** — quem nunca recebeu fica no topo da fila, o que distribui os chamados pela equipe.
- O cadastro de disponibilidade, períodos, regiões atendidas e categorias do especialista fica na tela de [[Usuários]].
+ O cadastro de disponibilidade, períodos, regiões atendidas e categorias do especialista fica na aba **Especialista/Técnico** da tela de [[12.1 - Usuários|Usuários]]. **Cidade atendida e período de disponibilidade são obrigatórios** para o especialista *(Novo)* — sem eles a regra 5 deixaria o técnico receber chamado de qualquer lugar, e a disponibilidade nunca ligaria nem desligaria sozinha.
---
@@ 74,7 74,7 @@
Um especialista é considerado **ocupado** quando já tem uma OS ou um chamado agendado próximo ao horário do chamado que está sendo alocado.
- O tamanho dessa janela vem do **tempo médio de atendimento** cadastrado na **categoria de serviço** solicitada (veja [[Cadastros/Categorias de Serviço]]):
+ O tamanho dessa janela vem do **tempo médio de atendimento** cadastrado na **categoria de serviço** solicitada (veja [[07.3 - Categorias de Serviço|Categorias de Serviço]]):
- o chamado ocupa a agenda pelo tempo médio da categoria, antes e depois do horário agendado;
- havendo **mais de uma categoria** solicitada, vale o **maior** tempo médio — a agenda precisa comportar o atendimento mais demorado;
@@ 104,12 104,29 @@
|---|---|---|
| **Oferta de chamado** | O especialista da vez | Aparece com destaque na tela e **sai da lista sozinho** quando o prazo vence |
| **Chamado alocado** | O especialista vinculado manualmente | Permanece até ser visualizado |
- | **Alocação manual necessária** | Usuários com a permissão *"Editar chamados"* | Avisa que a busca automática se esgotou — ou que a categoria solicitada não tem especialista vinculado |
- | **Espera do cliente** | Usuários com a permissão *"Editar chamados"* | Sinaliza, uma única vez, que o tempo de espera do cliente estourou |
+ | **Alocação manual necessária** | Usuários com a permissão *"Central de Chamados — editar"* | Avisa que a busca automática se esgotou — ou que a categoria solicitada não tem especialista vinculado |
+ | **Espera do cliente** | Usuários com a permissão *"Central de Chamados — editar"* | Sinaliza, uma única vez, que o tempo de espera do cliente estourou |
- Quando a busca **não encontra ninguém**, o chamado registra o motivo no próprio histórico — por exemplo *"Nenhum técnico elegível agora: 2 fora da área de atendimento, 1 com a disponibilidade desligada"*. A linha só se repete quando o motivo muda, e é ela que diferencia "ninguém cadastrado na área" de "todos ocupados neste minuto".
+ ### O que o especialista lê no aviso *(Novo)*
- As ofertas e os avisos de chamado tocam um **alerta sonoro**, que pode ser silenciado no próprio painel de notificações. Veja [[Notificações]].
+ O **título** do aviso é o que aparece inteiro na notificação do celular, por isso ele traz o que o especialista precisa para decidir antes mesmo de abrir o chamado:
+
+ - **Origem** — o chamado que não foi aberto internamente leva o selo no título, como *"Novo chamado #123 · pelo site"*. No chamado do **site**, em que ninguém falou com o cliente ainda, a mensagem acrescenta: *"O cliente não falou com ninguém ainda: ligue antes de deslocar."* Veja [[04 - Central de Chamados|Central de Chamados]].
+ - **Agendamento** — o chamado agendado informa o dia e a hora no título, como *"Novo chamado #123 · agendado sex, 02/10 às 14:30"*, e a mensagem repete: *"Atendimento agendado para sex, 02/10 às 14:30."* O mesmo vale para o aviso **Chamado atribuído a você**, do vínculo manual. Chamado sem agendamento chega como antes.
+
+ ### Motivo de não achar especialista *(Novo)*
+
+ Quando a busca **não encontra ninguém**, o chamado registra o motivo no próprio histórico, contando quantos especialistas ficaram de fora por cada regra — por exemplo *"Nenhum técnico elegível agora: 2 fora da área de atendimento, 1 com a disponibilidade desligada"*. Os motivos possíveis são:
+
+ - já receberam este chamado;
+ - com a disponibilidade desligada;
+ - com a agenda ocupada no horário;
+ - sem a categoria solicitada;
+ - fora da área de atendimento.
+
+ Sem nenhum especialista ativo cadastrado, a linha diz *"Nenhum técnico elegível: não há especialista ativo cadastrado."* A linha só se repete quando o motivo muda, e é ela que diferencia "ninguém cadastrado na área" de "todos ocupados neste minuto" — e, com isso, quem precisa agir.
+
+ As ofertas e os avisos de chamado tocam um **alerta sonoro**, que pode ser silenciado no próprio painel de notificações. Veja [[13 - Notificações|Notificações]].
---
@@ 121,8 138,8 @@
- avisa o especialista escolhido;
- **gera a OS** vinculada ao chamado, como no aceite da oferta.
- Se o especialista for retirado do chamado, ou se a OS gerada for cancelada, o chamado **volta para a alocação** — a não ser que o cancelamento da OS tenha sido feito com a chave de **cancelar o chamado junto**, que encerra os dois. Veja [[Ordens de Serviço]].
+ Se o especialista for retirado do chamado, ou se a OS gerada for cancelada, o chamado **volta para a alocação** — a não ser que o cancelamento da OS tenha sido feito com a chave de **cancelar o chamado junto**, que encerra os dois. Veja [[05 - Ordens de Serviço|Ordens de Serviço]].
---
- > Veja também: [[Central de Chamados]], [[Usuários]], [[Cadastros/Categorias de Serviço]] e [[Configurações]].
+ > Veja também: [[04 - Central de Chamados|Central de Chamados]], [[12.1 - Usuários|Usuários]], [[07.3 - Categorias de Serviço|Categorias de Serviço]] e [[12.4 - Parâmetros|Configurações]].
0 1 2 3 4 5 6 7 8 9 0 1 2 3 4 5 6 7 8 9 0 1 2 3 4 5 6 7 8 9 0 1 2 3 4 5 6 7 8 9