# 21. Agenda de Visita



# 21.1 Configuração da Agenda de Visitas

**⚠️ Importante:** a disponibilidade desta configuração depende de habilitação interna pelo time de suporte da Dommus.

#### Visão Geral

A funcionalidade permite que o usuário defina os dias, horários e duração das visitas realizadas. Após a configuração, somente os horários compatíveis com a agenda serão disponibilizados durante o agendamento de atividades do tipo **Visita**.

A configuração é indicada para usuários que realizam atendimentos externos ou presenciais.

Pode ser utilizada durante o planejamento da agenda da equipe, permitindo:

- Definir a jornada semanal de atendimento.
- Estabelecer a duração padrão das visitas.
- Informar o período de validade da disponibilidade.
- Evitar agendamentos fora dos horários configurados.

#### Como Acessar

1. Na tela inicial do Prospecta, clique no ícone de **Calendário** [![image.png](https://duvida.dommus.com.br/uploads/images/gallery/2026-08/scaled-1680-/AToimage.png)](https://duvida.dommus.com.br/uploads/images/gallery/2026-08/AToimage.png)
2. Selecione **Agenda do Usuário**.  
    [![image.png](https://duvida.dommus.com.br/uploads/images/gallery/2026-08/scaled-1680-/Uifimage.png)](https://duvida.dommus.com.br/uploads/images/gallery/2026-08/Uifimage.png)
3. Na tela apresentada, clique no ícone de engrenagem ao lado do título.
4. A janela **Configuração da agenda de visitas** será exibida.

[![image.png](https://duvida.dommus.com.br/uploads/images/gallery/2026-08/scaled-1680-/lnuimage.png)](https://duvida.dommus.com.br/uploads/images/gallery/2026-08/lnuimage.png)

#### Entendendo a Tela

##### Agenda de visitas ativa

Ativa ou desativa a aplicação das regras configuradas para a agenda do usuário.

Quando habilitada, a disponibilidade cadastrada será considerada no agendamento de visitas.

##### Duração da visita (minutos)

Define o tempo padrão de cada atendimento.

O valor informado é utilizado para calcular os horários disponíveis no momento do agendamento.

A tela apresenta o aviso:

> Remova todas as faixas antes de alterar a duração.

##### Início da vigência

Define a data inicial de validade da configuração.

O preenchimento deve seguir o formato **dd/mm/aaaa**.

##### Fim da vigência

Define a data final de validade da configuração.

O preenchimento deve seguir o formato **dd/mm/aaaa**.

##### Faixas semanais

Permite cadastrar os dias e horários em que o usuário estará disponível para atendimento.

Cada faixa possui:

- Dia da semana.
- Horário de início.
- Horário de fim.

As opções demonstradas são de segunda-feira a sexta-feira.

##### Adicionar faixa

Inclui um novo intervalo de disponibilidade semanal.

##### Remover

Exclui o intervalo correspondente.

Esse botão também deve ser utilizado antes da alteração da duração da visita.

##### Salvar agenda

Grava todas as configurações preenchidas.

#### Como Preencher as Informações

<div class="widget-container remove-before-copy" id="bkmrk-campo-descri%C3%A7%C3%A3o-agen"><div class="table-container"><table id="bkmrk-campo-descri%C3%A7%C3%A3o-agen-1" style="width: 67.7381%; height: 236.8px;"><thead><tr style="height: 29.6px;"><th style="width: 32.5351%; height: 29.6px;">Campo</th><th style="width: 67.2694%; height: 29.6px;">Descrição</th></tr></thead><tbody><tr style="height: 29.6px;"><td style="width: 32.5351%; height: 29.6px;">Agenda de visitas ativa</td><td style="width: 67.2694%; height: 29.6px;">Ativa ou desativa a aplicação das regras de disponibilidade.</td></tr><tr style="height: 29.6px;"><td style="width: 32.5351%; height: 29.6px;">Duração da visita (minutos)</td><td style="width: 67.2694%; height: 29.6px;">Informa o tempo padrão de cada visita.</td></tr><tr style="height: 29.6px;"><td style="width: 32.5351%; height: 29.6px;">Início da vigência</td><td style="width: 67.2694%; height: 29.6px;">Define a data inicial da configuração.</td></tr><tr style="height: 29.6px;"><td style="width: 32.5351%; height: 29.6px;">Fim da vigência</td><td style="width: 67.2694%; height: 29.6px;">Define a data final da configuração.</td></tr><tr style="height: 29.6px;"><td style="width: 32.5351%; height: 29.6px;">Dia da semana</td><td style="width: 67.2694%; height: 29.6px;">Indica o dia de atendimento.</td></tr><tr style="height: 29.6px;"><td style="width: 32.5351%; height: 29.6px;">Início</td><td style="width: 67.2694%; height: 29.6px;">Define o começo do intervalo de disponibilidade.</td></tr><tr style="height: 29.6px;"><td style="width: 32.5351%; height: 29.6px;">Fim</td><td style="width: 67.2694%; height: 29.6px;">Define o encerramento do intervalo de disponibilidade.</td></tr></tbody></table>

</div><div class="widget-list-container"><div class="widget-list-item export" onclick="document.dispatchEvent(new CustomEvent('exportTable', { detail: event }));">  
</div></div></div>[![image.png](https://duvida.dommus.com.br/uploads/images/gallery/2026-08/scaled-1680-/MGtimage.png)](https://duvida.dommus.com.br/uploads/images/gallery/2026-08/MGtimage.png)

#### Agendar uma visita utilizando a configuração

1. Acesse uma **Oportunidade**.
2. Selecione a aba **Atividade**.
3. Inclua uma nova atividade.
4. No campo **Tipo**, selecione **Visita**.
5. No campo **Escolha a pessoa que irá executar este atendimento**, selecione o usuário configurado.
6. Informe a **Data**.
7. Abra o campo **Hora**.
8. Selecione um dos horários disponíveis.
9. Clique em **Salvar**.

Os horários apresentados consideram a duração da visita e a faixa semanal cadastrada para o usuário selecionado.  
[![image.png](https://duvida.dommus.com.br/uploads/images/gallery/2026-08/scaled-1680-/RFOimage.png)](https://duvida.dommus.com.br/uploads/images/gallery/2026-08/RFOimage.png)

#### Regras de Negócio

- As restrições somente serão aplicadas quando **Agenda de visitas ativa** estiver habilitada.
- Os horários disponíveis dependem do dia informado no agendamento.
- A duração da visita influencia a lista de horários apresentada.
- É necessário remover todas as faixas antes de alterar a duração configurada.
- A disponibilidade considera o usuário selecionado como responsável pelo atendimento.
- As datas de vigência determinam o período em que a configuração será válida.
- Os intervalos devem ser preenchidos corretamente para evitar indisponibilidade indevida.

#### O Que Acontece Depois

Após salvar a configuração:

- As regras passam a ser consideradas no agendamento de atividades.
- O campo **Hora** apresenta somente os horários compatíveis com a agenda do usuário.
- O usuário consegue agendar visitas dentro dos períodos definidos.

Não foram identificadas informações sobre notificações ou alterações automáticas de status.

#### Observações

- A funcionalidade depende de habilitação interna pelo time de suporte.
- A configuração gerencia a disponibilidade do próprio usuário.
- As mensagens de sucesso, erro ou alerta não foram especificadas na documentação de origem.
- Caminhos alternativos de acesso não foram identificados.