> For the complete documentation index, see [llms.txt](https://guia-de-uso.tiflux.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://guia-de-uso.tiflux.com/sistema/agenda.md).

# Agenda

Na Agenda do Tiflux, você poderá criar compromissos e informar ausências dos técnicos.

## 📘 Módulo de Agenda no Tiflux

```
📍 Localização:
📂 Menu > Agenda
```

***

### 🎯 Introdução

O módulo de Agenda do Tiflux permite gerenciar compromissos de atendimento, visualizar apontamentos e registrar ausências da equipe técnica. Ele centraliza o planejamento de horários e integra os agendamentos diretamente aos tickets de suporte.<br>

***

### 📚 Sumário

1. 🛠️ Visão Geral da Interface
2. 🗓️ Gerenciamento de Agendas e Filtros
3. 📝 Como Criar e Gerenciar Compromissos
4. 🚫 Como Registrar Ausências
5. 🛠️ Troubleshooting (Erros Comuns)
6. ⚠️ Avisos Importantes
7. 🧾 Resumo
8. ❓ Perguntas Frequentes (FAQ)

***

### 🛠️ Visão Geral da Interface

A interface da Agenda é dividida em dois blocos principais:

* Painel Esquerdo (Filtros e Atendentes): Gerencia listas de agendas personalizadas, filtros de visualização e atendentes vinculados aos grupos com agenda ativa.

<figure><img src="https://2304813967-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-LCU_zijA4r4IkDIJyZG%2Fuploads%2FzwGIyfb0nxvl8heLxJsC%2Fimage.png?alt=media&amp;token=4a6db49c-95af-43e9-8ad1-c9aa0264f1ec" alt=""><figcaption></figcaption></figure>

* Área Central (Calendário): Exibe a grade de horários com botões de navegação (*Anterior*, *Próximo*, *Hoje*) e alternância de exibição (*Mês*, *Semana*, *Dia* ou *Lista*).

<figure><img src="https://2304813967-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-LCU_zijA4r4IkDIJyZG%2Fuploads%2FDrQLedoWjxPg5hXLAf68%2Fimage.png?alt=media&amp;token=aae9cf3f-c018-4ea0-ac42-9d6ecece4a4e" alt=""><figcaption></figcaption></figure>

* Menu Ações (Canto Superior Direito): Atalho para criar novas agendas, agendar compromissos ou lançar ausências.

<figure><img src="https://2304813967-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-LCU_zijA4r4IkDIJyZG%2Fuploads%2Fl6wDoseBt2yO42ZywfSF%2Fimage.png?alt=media&amp;token=901fceac-1dc1-479e-8095-d73681e6d1ad" alt=""><figcaption></figcaption></figure>

***

### 🗓️ Gerenciamento de Agendas e Filtros

* Nova Agenda: Clique no botão `+` no bloco de Agendas ou acesse `Ações > Nova agenda`. Defina um nome e uma cor para identificação.

<figure><img src="https://2304813967-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-LCU_zijA4r4IkDIJyZG%2Fuploads%2F0l5iEheLba6svhZ4PkUz%2Fimage.png?alt=media&amp;token=6d693555-384f-4999-8e5a-399362ece931" alt=""><figcaption></figcaption></figure>

* Tipos de Eventos (Filtro):
  * Compromissos: Agendamentos futuros vinculados a um ticket.
  * Apontamentos: Registros de horas/atendimentos já efetuados.
  * Ausências: Períodos de indisponibilidade do técnico (férias, folgas, compromissos pessoais).

<figure><img src="https://2304813967-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-LCU_zijA4r4IkDIJyZG%2Fuploads%2Fk60TwvqdS3oHe6DUEul2%2Fimage.png?alt=media&amp;token=f099348f-4d59-41d1-9422-5c93faa8e31d" alt=""><figcaption></figcaption></figure>

* Filtro de Atendentes: Selecione ou desmarque os nomes na lista para visualizar a grade individual ou de toda a equipe.<br>

***

### 📝 Como Criar e Gerenciar Compromissos

Existem duas formas de criar um compromisso no Tiflux:

| **Origem**  | **Caminho de Acesso**                                | **Campos Diferenciadores**                              |
| ----------- | ---------------------------------------------------- | ------------------------------------------------------- |
| Pela Agenda | `Ações > Novo compromisso`                           | Requer seleção manual do Cliente e do Ticket.           |
| Pelo Ticket | Abrir o Ticket > Aba `Compromissos` > `+Compromisso` | O Cliente e o Ticket já vêm vinculados automaticamente. |

#### Parâmetros de Preenchimento do Compromisso:

* Agendar para: Define se o evento é para um atendente específico ou para um grupo de atendentes.
* Data e Hora: Período de início e término do compromisso.
* Repetição (*Opcional*): Configuração de frequência (ex: diário, semanal) no campo *Repetir a cada* e data limite em *Repetir até*.
* Lembrete: Alerta enviado por notificação X minutos antes do evento.
* Descrição: Detalhamento do objetivo da tarefa.

<figure><img src="https://2304813967-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-LCU_zijA4r4IkDIJyZG%2Fuploads%2FP64g9BBCKegkKl0hb5tO%2Fimage.png?alt=media&amp;token=1eb210e9-06e3-4ccc-a6c5-5e7248673b46" alt=""><figcaption></figcaption></figure>

***

### 🚫 Como Registrar Ausências

Para bloquear a grade de horários de um técnico:

1. Acesse `Ações > Nova ausência`.
2. Preencha o Título (motivo/identificador).
3. Selecione a pessoa no campo Agendar para.
4. Defina as datas/horas de Início e Fim.
5. *(Opcional)* Marque Ausência dia integral para bloquear o dia todo e desabilitar os campos de hora.
6. Clique em Salvar.

<figure><img src="https://2304813967-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-LCU_zijA4r4IkDIJyZG%2Fuploads%2FuiqrxjQPumg2oalt03Gi%2Fimage.png?alt=media&amp;token=bb8229cb-cdeb-4908-9145-96915df22aba" alt=""><figcaption></figcaption></figure>

***

### 🛠️ Troubleshooting (Erros Comuns)

🔹 Problema: Um atendente da equipe não aparece no painel lateral esquerdo da Agenda

* ✅ Solução: Verifique se o técnico está inserido em um *Grupo de Atendentes* que possui a opção de agenda ativada nas configurações da mesa.<br>

🔹 Problema: O compromisso criado pelo ticket não é exibido no calendário

* ✅ Solução: Acesse a barra lateral esquerda em *Filtrar* e certifique-se de que a opção Compromissos está marcada, além de verificar se o atendente correto está selecionado na lista.<br>

***

### ⚠️ Avisos Importantes

> Conflito de Horários: O registro de ausências e compromissos bloqueia a grade de horários, auxiliando gestores na distribuição e atribuição de chamados sem sobrecarregar os técnicos.\
> Sincronização: Qualquer compromisso criado na aba interna do ticket refletirá instantaneamente no módulo geral de Agenda e vice-versa.

***

### 🧾 Resumo

O módulo de Agenda do Tiflux unifica o controle de compromissos, ausências e históricos de apontamentos da equipe técnica. Permite visualizações personalizadas por dia, semana, mês ou lista, oferecendo suporte ao planejamento das operações diretamente associado aos tickets de atendimento.<br>

***

### ❓ Perguntas Frequentes (FAQ)

🔹 1. Onde vejo os compromissos agendados para a minha equipe?\
Acesse a Agenda no menu lateral e selecione o filtro de atendentes ou grupos desejados na barra lateral esquerda.\
\
🔹 2. Qual a diferença entre "Compromisso" e "Apontamento"?\
*Compromisso* é um agendamento futuro de atendimento. *Apontamento* é o registro de horas já trabalhadas e finalizadas no ticket.\
\
🔹 3. Posso agendar um compromisso para um grupo inteiro de atendentes?\
Sim. No campo Agendar para, selecione a opção de Grupo e escolha a equipe correspondente.\
\
🔹 4. Como marcar que um técnico estará de férias o dia todo?\
Crie uma Nova ausência, selecione o técnico, marque a caixa Ausência dia integral e defina o período de início e fim.\
\
🔹 5. É possível criar compromissos recorrentes?\
Sim. Ao cadastrar um compromisso, utilize os campos Repetir a cada e Repetir até para definir a frequência.\
\
🔹 6. Onde altero a cor de identificação de uma agenda?\
No painel esquerdo, clique no ícone de lápis (editar) ao lado do nome da agenda cadastrada para alterar sua cor.

***

### 🔍 Palavras-chave para IA, indexação e busca

```
agenda tiflux
novo compromisso tiflux
lancar ausencia tiflux
agendamento de tickets
calendario de atendentes tiflux
filtro de compromissos tiflux
```
