# E-mail marketing Source: https://agile-docs.3code.com.br/crm/email-marketing Crie modelos de e-mail e dispare campanhas com acompanhamento de resultados. ## Visão geral O **E-mail marketing** é composto por duas partes: os **modelos** (templates reutilizáveis) e as **campanhas** (envios em massa que usam um modelo). Campanhas de e-mail - tema claro

A lista de campanhas mostra **nome**, **tipo**, **status**, total de **destinatários** e as **taxas de abertura e clique**. *** ## Modelos Um modelo guarda o conteúdo reutilizável de um e-mail: **nome**, **assunto** e **corpo**. O editor oferece três modos — **HTML** (visual), **Código HTML** (avançado) e **Texto plano**. É possível usar **variáveis** que são substituídas automaticamente no envio: * `{{nome}}` — nome do contato * `{{email}}` — e-mail do contato * `{{telefone}}` — telefone do contato * `{{empresa}}` — nome da empresa * `{{linkedin}}` — LinkedIn do contato *** ## Campanhas Informe **nome**, **tipo** (Informativa, Marketing, Transacional ou Outra), escolha um **modelo** e selecione os **destinatários**. Assunto e corpo vêm do modelo e podem ser ajustados. Salve como rascunho, **envie agora** ou **agende** o disparo. Na tela de detalhes, acompanhe o status em tempo real e as métricas por destinatário (enviado, aberto, clicado, bounce). # Follow-ups Source: https://agile-docs.3code.com.br/crm/follow-up Agende e acompanhe tarefas de relacionamento, com categorias e tags. ## Visão geral Os **follow-ups** são tarefas de acompanhamento — lembretes do que precisa ser feito com um cliente ou lead. Cada follow-up tem **cliente**, **responsável**, **categoria**, **tag**, data de **agendamento** e data de **conclusão**. Lista de follow-ups - tema claro

A coluna **Farol** funciona como um semáforo (verde, amarelo ou vermelho) que indica visualmente a proximidade ou o atraso em relação à data agendada. Use **[Filtrar](/general/filter)** para refinar por cliente, categoria, status, tag, responsável e períodos. *** ## Categorias e tags * **Categorias** — organizam os follow-ups de forma **hierárquica** (categoria e subcategoria, por exemplo "Venda › Proposta"). Gerencie-as em **Categorias de follow-up**. * **Tags** — classificadores coloridos (por exemplo "Urgente", "Positivo") para marcar follow-ups. Gerencie-as em **Tags de follow-up**. *** ## Criar e concluir Clique em **[Criar Novo](/general/create)** para agendar um follow-up (cliente, categoria, tag, data, responsável e descrição). Quando a tarefa for realizada, marque-a como **concluída** — a data de conclusão é registrada automaticamente. # CRM Source: https://agile-docs.3code.com.br/crm/i Gerencie leads, funis de vendas, follow-ups, campanhas e pesquisas de experiência. ## Visão geral O módulo **CRM** organiza todo o relacionamento comercial: da captação de **leads**, passando pela evolução em **funis de vendas**, até o acompanhamento com **follow-ups**, **campanhas de e-mail** e **pesquisas de experiência**. A tela **Overview** consolida os principais indicadores — leads sem responsável, leads parados, leads ganhos e follow-ups atrasados — além de gráficos de **funil por etapas**, **leads por canal** e **leads por responsável**. Visão geral do CRM - tema claro

*** ## Conceitos principais | Conceito | O que é | | --------------------- | --------------------------------------------------------------------------------------------------------------- | | **Lead** | Potencial cliente em qualificação, posicionado em uma etapa de um funil. | | **Funil / Etapa** | Estrutura de vendas com etapas (ex.: Qualificação → Proposta → Fechamento). Os leads avançam de etapa em etapa. | | **Contato / Cliente** | Pessoa de contato e a empresa associada ao lead. | | **Canal** | Origem do lead (WhatsApp, E-mail, Chat, Site, etc.). | | **Responsável** | Usuário responsável pelo lead, funil ou follow-up. | | **Qualificação** | Valores do negócio: MRR, Valor do Projeto e Duração do Contrato, que compõem o Total do Contrato. | | **Follow-up** | Tarefa de acompanhamento com data, categoria e responsável. | | **Campanha** | Envio de e-mail em massa, com métricas de abertura e clique. | | **Pesquisa** | Questionário de experiência enviado para coletar feedback. | *** ## Áreas do módulo * **[Leads](/crm/leads)** — captação e gestão de leads em Kanban ou lista. * **[Funis de vendas](/crm/pipes)** — etapas e automações do processo comercial. * **[Follow-ups](/crm/follow-up)** — tarefas de acompanhamento, categorias e tags. * **[E-mail marketing](/crm/email-marketing)** — modelos e campanhas de e-mail. * **[Pesquisas de experiência](/crm/surveys)** — questionários de satisfação. # Atendimentos Source: https://agile-docs.3code.com.br/crm/interactions Centralize as conversas com clientes por e-mail, WhatsApp e chat em um só painel. ## Visão geral O **painel de atendimentos** reúne, em um único lugar, as conversas com clientes pelos canais habilitados (**E-mail**, **WhatsApp** e **Chat**). No desktop, a tela é dividida em três colunas: * **Conversas** — a lista de atendimentos, com busca, indicador de não lidas e filtros por canal, status e responsável. * **Chat** — o histórico de mensagens da conversa selecionada e o editor para responder. * **Detalhes do contato** — informações do contato e o histórico relacionado. Se nenhum canal estiver configurado, o painel exibe um aviso de que não há canais ativos. A configuração dos canais é feita nas configurações do módulo. *** ## Templates de WhatsApp Modelos de mensagem reutilizáveis para agilizar o atendimento por WhatsApp. Cada template tem um **nome** e um **corpo**, podendo conter variáveis. Gerencie-os (criar, editar, excluir) na tela de **Templates de WhatsApp**. *** ## Mensagens automáticas Respostas automáticas disparadas a partir de **condições/gatilhos** (por exemplo, fora do horário de atendimento). Configure o conteúdo e as condições e ative ou desative cada regra conforme a necessidade. # Leads Source: https://agile-docs.3code.com.br/crm/leads Capte, qualifique e acompanhe leads em visão Kanban ou lista. ## Visão geral A tela de **Leads** permite acompanhar os potenciais clientes em dois formatos: * **Kanban** — colunas por **etapa** de um funil selecionado, com cards arrastáveis entre etapas (mover um card altera a etapa do lead). Cada coluna mostra o total e o valor acumulado dos leads. * **Grid** — uma tabela com visão de **vários funis**, ideal para filtrar e exportar. Alterne entre **Meus leads** e **Todos**, e abra o painel de **Métricas** para ver os números agregados. Lista de leads (Grid) - tema claro

*** ## Como criar um lead Clique em **[Criar Novo](/general/create)**. * **Obrigatórios**: Nome, E-mail, Telefone, **Canal** (origem) e **Mensagem**. * **Opcionais**: Cliente, Contato, Funil, Produtos, dados da Empresa (nome, CNPJ, razão social, LinkedIn) e a **Qualificação** (MRR, Valor do Projeto, Duração do Contrato e Data de Fechamento Esperada). *** ## Detalhes do lead A tela de detalhes organiza as informações em abas: Contato, Empresa, **Qualificação** (com o Total do Contrato calculado), o **funil** com a etapa atual e a mensagem original. Os valores de qualificação podem ser editados diretamente, sem abrir outra tela. Lista e criação de follow-ups vinculados ao lead. Tarefas agendadas relacionadas ao lead, com data, status e responsável. Histórico de alterações: quem mudou o quê e quando. No menu **Mais opções** é possível editar, fechar o lead, adicionar funis e definir/alterar o responsável. A visão **Kanban** exige a seleção de um **funil**, que define as etapas exibidas. A visão **Grid** está disponível para usuários internos e externos. # Funis de vendas Source: https://agile-docs.3code.com.br/crm/pipes Defina etapas, responsáveis e automações dos seus processos comerciais. ## Visão geral Um **funil** representa um processo de vendas dividido em **etapas** (por exemplo: Qualificação → Proposta → Fechamento). Os leads avançam de etapa em etapa até a conversão ou o descarte. Lista de funis - tema claro

A lista mostra o **nome** do funil, o **responsável**, a quantidade de **automações** e quem o criou. *** ## Como criar um funil Clique em **[Criar Novo](/general/create)**. * **Nome** e **Responsável** (obrigatórios). * **Membros** do funil (opcional). * **Descrição** (opcional). *** ## Detalhes do funil Nome, responsável, descrição e membros do funil. Crie, edite, **reordene** (arrastar e soltar) e remova as etapas. Cada etapa tem nome, cor e o total de leads associados. Regras que executam ações automaticamente (por exemplo, mover o lead ou disparar um e-mail) quando determinadas condições são atendidas. É possível ativar, desativar, editar e remover automações. # Configurações do CRM Source: https://agile-docs.3code.com.br/crm/settings Catálogos que padronizam contatos e anexos usados no módulo. ## Visão geral As configurações administrativas do CRM definem **catálogos** reutilizados nas demais telas — padronizando como os contatos e anexos são classificados. Cada um é uma lista simples de **criar / editar / excluir**. *** ## Catálogos disponíveis Categorias para os arquivos anexados (por exemplo, Contrato, Proposta, Nota fiscal). Classificação do contato pela área de atuação (por exemplo, Financeiro, Técnico, Decisor). Cargo ou função do contato na empresa (por exemplo, CEO, CFO, Gerente). Nível de influência do contato na decisão (por exemplo, Alto, Médio, Baixo). Manter esses catálogos consistentes ajuda na qualificação dos leads e na geração de relatórios mais precisos. # Pesquisas de experiência Source: https://agile-docs.3code.com.br/crm/surveys Envie questionários de satisfação e acompanhe as respostas dos clientes. ## Visão geral As **pesquisas de experiência** permitem coletar feedback dos clientes a partir de um **questionário**, enviado por **e-mail**, **WhatsApp** ou **chat**. Pesquisas de experiência - tema claro

A lista mostra o **status**, o **método de envio**, o **nome** da pesquisa, o **questionário** utilizado, o **destinatário** e a **data de resposta**. *** ## Como criar uma pesquisa Clique em **[Criar Novo](/general/create)**. * **Nome** da pesquisa. * **Questionário** a ser aplicado. * **Método de envio** (E-mail, WhatsApp ou Chat). * **Destinatários**. *** ## Respostas e link público Cada pesquisa gera um **link público** que pode ser compartilhado — o destinatário responde **sem precisar de login**. As respostas ficam disponíveis na tela de detalhes, junto a um relatório agregado de satisfação. # Criar novo Source: https://agile-docs.3code.com.br/general/create A funcionalidade de criação do Agile é uma ferramenta prática que permite adicionar novos dados de forma rápida, segura e eficiente. O botão de Criar novo é uma funcionalidade essencial do Agile, projetada para facilitar a adição de novos dados ao sistema. Ele está disponível em diversas seções, como usuários, clientes, departamentos, entre muitos.

*** ## Estilo do botão Botões como o "Criar novo" seguem o padrão visual da organização, utilizando sua cor primária para manter a identidade visual consistente em toda a plataforma. Esse estilo ajuda o usuário a identificar rapidamente ações principais dentro do sistema. Se quiser saber mais sobre estilos e aparências, clique **[aqui](/organization/visual-identity#cores-e-fonte)**. *** ## Formulário de criação Ao clicar no botão “Criar novo”, uma aba lateral se abre na tela em dispositivos desktop, permitindo que o usuário preencha um formulário ou insira novas informações. Essa aba desliza a partir da lateral da interface e não carrega uma nova página, oferecendo uma experiência mais fluida e intuitiva.\ Em dispositivos móveis, o formulário é exibido em um modal que sobe a partir da parte inferior da tela, adaptando a interface para uma navegação mais confortável e eficiente em telas menores. Desktop

Mobile

Os campos que possuem um asterisco (\*) ao lado do título são obrigatórios. Isso significa que eles precisam ser preenchidos para que o formulário possa ser enviado com sucesso. # Deletar Source: https://agile-docs.3code.com.br/general/delete O sistema de deletar do Agile é uma ferramenta poderosa que permite remover dados de forma segura e eficiente. ## Tipos de Deleção O Agile adota dois formatos distintos de deleção para garantir segurança e evitar exclusões acidentais, de acordo com o grau de sensibilidade dos dados envolvidos: *** ### Deleção Segura (com confirmação por texto) Este tipo de deleção é utilizado em casos onde a informação a ser removida é sensível ou crítica para o funcionamento do sistema. Para concluir a exclusão, o usuário precisa digitar um termo específico — geralmente o nome do item — como forma adicional de confirmação. * Ideal para dados que envolvem segurança, controle de acesso, ou estrutura central do sistema. * Evita exclusões acidentais por exigir uma ação consciente. * O sistema informa claramente que a ação é irreversível. **Exemplo:**\ Ao excluir um perfil de acesso, o sistema exige que o usuário digite o nome do perfil (ex: `Cliente`) antes de permitir a exclusão.

> Essa abordagem segue boas práticas como as utilizadas em plataformas como GitHub ao excluir repositórios. *** ### Deleção Simples (com confirmação padrão) Este tipo é usado para registros menos sensíveis, em que a exclusão não afeta o funcionamento do sistema ou pode ser facilmente revertida (ex: recriação manual do dado). * A confirmação é feita apenas por meio de um botão de "Confirmar". * O sistema ainda alerta sobre a irreversibilidade da ação. * Oferece uma experiência mais rápida e prática. **Exemplo:**\ Ao excluir um feriado cadastrado, o sistema exibe um modal com a mensagem de confirmação e os botões “Cancelar” e “Confirmar”.

> O uso de "perfil de acesso" e do "feriado" é apenas um exemplo. A definição do tipo de deleção deve sempre considerar o impacto real do dado na plataforma. # Exportar Source: https://agile-docs.3code.com.br/general/export O sistema de exportação do Agile permite exportar todos os dados listados no grid, independentemente dos filtros aplicados ou da paginação. ## Visão geral A funcionalidade de **Exportar** permite obter uma cópia dos dados apresentados na listagem, em diferentes formatos (**Excel, CSV, PDF ou Word**). Mesmo que os dados estejam paginados ou ocultos por rolagem, a exportação inclui **todos os registros retornados pela filtragem atual**. A ação de exportar está disponível nas listagens que oferecem esse recurso — nem todas as telas possuem exportação. *** ## Como funciona 1. Aplique os filtros desejados na listagem (opcional). 2. Clique no botão **Exportar** (ícone de seta para baixo). 3. No painel lateral, escolha **o que exportar** — todos os registros ou apenas os selecionados — e o **formato** (Excel, CSV, PDF ou Word). 4. Clique em **Exportar**: o sistema processa os dados filtrados e gera o arquivo. 5. O download é iniciado automaticamente. Caso nenhum filtro esteja aplicado, **todos os dados da entidade** serão exportados.

Clique em **Exportar** para baixar os dados em formato `.xlsx`. *** ## Considerações * A exportação sempre reflete o estado atual do filtro, mas **ignora a paginação**. * Apenas os dados do grid são incluídos (ações, colunas ocultas ou dados adicionais fora do grid não são exportados). * A exportação pode levar alguns segundos dependendo da quantidade de dados. *** # Filtrar Source: https://agile-docs.3code.com.br/general/filter O sistema de filtragem do Agile é uma ferramenta poderosa que permite localizar dados de forma rápida e eficiente. O Agile oferece um sistema de filtragem avançado que permite aos usuários localizar dados de forma rápida e eficiente. O botão de filtro está sempre visível ao lado do botão "**[Criar Novo](/general/create)**", facilitando o acesso imediato à ferramenta de busca personalizada, sem a necessidade de navegar para outra página.

*** ## Formulário de filtro Ao clicar no botão de filtro, o sistema exibe um conjunto de campos específicos para refinar os resultados apresentados na tela. Em dispositivos desktop, esses campos são exibidos em uma aba lateral que se abre na interface. Já em dispositivos móveis, um modal sobe a partir da parte inferior da tela, garantindo uma experiência otimizada para cada tipo de dispositivo. Essa abordagem torna a navegação mais intuitiva e produtiva, independentemente do tamanho da tela. Desktop

Mobile

Os campos de filtro são opcionais, permitindo que o usuário escolha quais critérios deseja aplicar para refinar os resultados. Isso proporciona flexibilidade e personalização na busca por informações específicas. *** ## Filtro inicial Em muitas telas que possuem o campo **Status**, o filtro já vem aplicado por padrão (por exemplo, **Ativo** ou **Todos**), para oferecer uma visão útil logo no primeiro acesso. Os campos disponíveis variam conforme a tela — cada listagem expõe apenas os filtros que fazem sentido para o seu conteúdo. *** ## Filtros salvos O sistema permite que usuários com permissão adequada salvem suas configurações de filtro para uso futuro. Esta funcionalidade otimiza o tempo e aumenta a produtividade, evitando a necessidade de reconfigurar filtros utilizados com frequência. ### Salvando um filtro Para salvar um filtro personalizado, o usuário deve: 1. **Configurar o filtro** utilizando os campos desejados no formulário de filtragem 2. **Clicar no botão "Salvar filtros"** (visível apenas para usuários com permissão)

3. **Preencher as informações** no diálogo que será exibido: * **Nome do filtro**: Identificação única para fácil reconhecimento * **Visibilidade**: Escolher entre público ou privado * **Público**: Disponível para todos os usuários da organização * **Privado**: Acesso exclusivo do usuário que criou o filtro

A funcionalidade de salvar filtros está disponível apenas para usuários que possuem a permissão necessária no sistema. Além disso, a opção de tornar um filtro público também requer uma permissão específica. Caso não tenha acesso a essas opções, entre em contato com o administrador do sistema. ### Utilizando filtros salvos Para aplicar um filtro salvo anteriormente: 1. **Acessar o menu "Mais opções"** no grid de tickets 2. **Selecionar "Filtros salvos"** para visualizar a lista disponível 3. **Escolher o filtro desejado** para aplicação automática

Os filtros salvos aparecem de forma organizada, permitindo identificação rápida através dos nomes personalizados. O sistema aplica instantaneamente todos os critérios configurados, refrescando a visualização dos dados conforme as preferências selecionadas. # Editar Source: https://agile-docs.3code.com.br/general/update A funcionalidade de edição do Agile é uma ferramenta prática que permite atualizar dados existentes de forma rápida, segura e eficiente. ## Formas de edição O Agile oferece duas formas principais de edição de dados, adaptadas ao tipo de informação exibida em cada tela: ### Grid Presente em algumas telas, como Feriados, Cofre de Senhas, entre outras. Ao selecionar um item para editar, uma interface lateral é aberta, permitindo que o usuário atualize as informações de forma rápida, sem sair da tela principal. Essa abordagem combina agilidade com praticidade, mantendo o contexto da visualização.

### Detalhes Presente na maioria das telas do sistema. Ao acessar os detalhes de um item, o usuário encontra todas as informações organizadas e pode realizar alterações de maneira mais completa e contextualizada. #### Ícone de detalhes

Para editar um item, primeiro acesse os detalhes clicando no ícone de detalhes na lista. Isso abrirá uma visão detalhada do item, onde você poderá ver todas as informações relevantes. #### Clicar em editar

Clique no botão de editar ou diretamente nos campos habilitados para edição. Após ajustar os dados, clique em **Confirmar** para atualizar as informações no sistema de forma segura e eficiente.

Assim que você clicar no botão de editar, os campos editáveis serão destacados, permitindo que você veja claramente quais informações podem ser alteradas. Isso facilita a navegação e a atualização dos dados. Essa flexibilidade permite que o usuário escolha a forma de edição mais adequada à sua necessidade, equilibrando agilidade e profundidade. # Introdução Source: https://agile-docs.3code.com.br/index Seja bem-vindo à documentação do Agile! ## O que é o Agile? O **Agile** é uma plataforma inovadora de gestão de tarefas que permite otimizar processos, melhorar a produtividade e garantir que sua equipe esteja sempre à frente.\ Nossa solução combina inteligência artificial, simplicidade e monitoramento em tempo real para transformar a maneira como as equipes trabalham. Com o Agile, você pode: * Organizar e priorizar demandas para manter o foco no que realmente importa. * Gerenciar projetos com uma interface elegante, rápida e intuitiva. * Monitorar métricas de desempenho em tempo real, garantindo a entrega de resultados com qualidade. Está com dúvidas? Só chamar [suporte@3code.com.br](mailto:suporte@3code.com.br), estamos a sua disposição! # Perfil de acesso Source: https://agile-docs.3code.com.br/organization/access-profile Crie e gerencie perfis de acesso para controlar o que cada usuário pode fazer no sistema. O perfil de acesso é uma ferramenta essencial para garantir a segurança e a eficiência no gerenciamento de informações dentro de uma organização. Ele define quais usuários têm permissão para acessar determinadas áreas e funcionalidades do sistema, assegurando que apenas pessoas autorizadas possam visualizar ou modificar dados sensíveis. ## Lista de perfis de acesso A lista exibe todos os perfis disponíveis no sistema, permitindo visualizar e gerenciar as permissões de cada um. É possível adicionar novos perfis, editar os existentes ou excluir aqueles que não são mais necessários.

*** ## Perfil de acesso interno ou externo Os perfis de acesso podem ser classificados como **internos** ou **externos**. Perfis internos são destinados a pessoas que atuam dentro da organização. Já os externos são voltados para clientes, parceiros ou outros usuários que acessam o sistema de fora. *** ## Como criar um novo perfil de acesso Para adicionar um novo perfil, clique no botão **[Criar Novo](/general/create)**. Um formulário será exibido para preenchimento do nome e da descrição do perfil.

## Configurando o perfil de acesso A tela de detalhes do perfil exibe informações básicas, como nome, descrição e status (ativo ou inativo). Ela pode ser acessada ao clicar no ícone de detalhes na lista de perfis. ### Detalhes do perfil de acesso

Ao clicar no ícone de detalhes, você será redirecionado para a tela de detalhes do perfil. ### Dados básicos

Você pode editar o **nome** e a **descrição** do perfil, definir se ele é **interno** ou externo, escolher os **módulos permitidos** e as **empresas**, além de ativá-lo ou desativá-lo. Para isso, clique em **Editar** e, após as alterações, em **Confirmar**. Também é possível excluir o perfil clicando em [**Deletar**](/general/delete). O sistema solicitará uma confirmação antes de concluir a exclusão. ### Regras

Nesta aba você define **o que o perfil pode fazer**. As regras são **pré-definidas** pelo sistema e ficam organizadas por **módulo** e **categoria** — você apenas **marca ou desmarca** as que o perfil terá. Cada regra mostra um nome, uma descrição e um **selo de ação** (Ver, Criar, Editar, Excluir, Importar, Exportar, Aprovar, Reprovar, Encerrar, Liberar, Enviar, entre outros). Para facilitar, há **busca** por termo e **filtros** por módulo e por ação, além dos atalhos **Expandir/Colapsar tudo** e **Selecionar/Desselecionar todos**, com um indicador de quantas regras estão selecionadas. As regras **internas** só aparecem em perfis internos, e os **módulos permitidos** (definidos nos dados básicos) determinam quais regras ficam disponíveis. Clique em **Editar** para alterar e em **Confirmar** para salvar. Ao clicar em Salvar, todas as regras configuradas neste perfil de acesso serão aplicadas automaticamente a todos os usuários vinculados. # API Keys Source: https://agile-docs.3code.com.br/organization/api-keys Gerencie as chaves de API para acesso seguro aos seus serviços. ## Visão geral A seção de **API Keys** permite que você crie e gerencie chaves de acesso utilizadas para autenticação em integrações com sistemas externos de forma segura. Essas chaves são essenciais para garantir que apenas usuários autorizados possam consumir seus serviços. API Keys Light

*** ## Funcionalidades Disponíveis * **Listagem de chaves**: visualize todas as chaves criadas, seus status, data de criação, responsável e data de expiração. * **Criação de nova chave**: gere uma nova chave clicando no botão "**[Criar Novo](/general/create)**". * **Cópia rápida da chave**: utilize o ícone de cópia para transferir a chave para sua área de transferência com facilidade. * **Status da chave**: veja rapidamente se uma chave está ativa ou não. * **Validade da chave**: controle quando (ou se) uma chave irá expirar. * **Propriedade e autoria**: acompanhe quem criou cada chave e para qual propósito ela está sendo usada. *** ## Estrutura da Chave As chaves seguem um padrão que facilita sua identificação: * O **prefixo** da chave corresponde ao **alias da organização** (ex: `AGILE-`). * Esse padrão ajuda a rastrear a origem da chave em sistemas externos com múltiplas integrações. *** ## Criação de uma Nova Chave Para criar uma nova API Key, siga os passos abaixo: ### Formulário de Cadastro

Configurações de aparência - tema escuro

Após preencher os campos, clique em Confirmar. A chave será gerada automaticamente e exibida na listagem. O formulário de criação inclui os campos: * **Nome / Proprietário**: identificação da chave. * **Descrição**: finalidade da chave (opcional), para facilitar o gerenciamento. * **Escopos**: as permissões/áreas que a chave poderá acessar — selecione um ou mais. * **Usuário associado**: vincula a chave a um usuário; as requisições assumem o contexto desse usuário. * **Validade**: data de expiração (ou sem expiração). * **Ativa?**: habilita ou desabilita a chave. ## Recomendações de Uso * Utilize nomes descritivos no campo “Proprietário” para facilitar o gerenciamento. * Revogue chaves que não estejam mais em uso. * Evite expor as chaves publicamente. Caso isso ocorra, gere uma nova e desative a antiga imediatamente. * Prefira a configuração de validade sempre que possível para reduzir riscos de segurança. Apenas usuários com permissões administrativas ou acesso à seção de configurações podem visualizar e gerenciar as API Keys. # Calendário Source: https://agile-docs.3code.com.br/organization/calendar Como gerenciar suas atividades e tarefas através da tela de calendário? ## O que é o Calendário de Atividades? O Calendário de Atividades é uma ferramenta visual poderosa para **organizar e gerenciar todas as suas tarefas** em um formato de calendário. Ele integra dois tipos de atividades: * **Atividades manuais:** Criadas diretamente através do próprio calendário * **Atividades de tickets:** Vinculadas a tickets do sistema Essa integração fornece uma visão completa do seu fluxo de trabalho em um único lugar. Esta funcionalidade está disponível para **ambos os tipos de usuários** (internos e externos) que possuam permissão de visualizar calendário, permitindo um gerenciamento centralizado das atividades. ## Visão Geral do Calendário A tela do calendário exibe todas as suas atividades organizadas por data, com diferenciação visual entre os tipos de atividades:

**Legenda de Cores:** * **Verde:** Atividades criadas a partir de tickets * **Roxo:** Atividades criadas manualmente através do próprio calendário *** ### Gerenciamento de Atividades O calendário permite o gerenciamento completo das atividades diretamente pela interface: Para marcar uma atividade como concluída, clique no checkbox da tarefa. Uma vez marcada, a atividade exibirá o indicador de conclusão (✓) visualmente.

Se uma atividade tiver uma URL de reunião configurada, você poderá acessá-la diretamente através do calendário com um único clique.

O calendário permite criar novas atividades manualmente diretamente pela interface, sem necessidade de vincular a um ticket. Essas atividades aparecerão com a cor roxa.

*** ## Integração com Tickets Quando uma atividade é criada através de um ticket, ela automaticamente aparece no calendário com a **cor verde**, permitindo fácil identificação visual das tarefas que possuem vínculo com tickets. Essa integração garante que você tenha uma visão completa tanto das atividades manuais quanto das demandas provenientes dos tickets, facilitando o planejamento e organização do trabalho. Atividades criadas através de tickets mantêm o vínculo com o chamado original, permitindo navegação fácil entre o calendário e os detalhes do ticket quando necessário. *** ## Benefícios do Calendário * **Visão Completa:** Visualize todas as suas atividades em um único lugar * **Organização Visual:** Diferenciação por cores facilita a identificação rápida * **Filtros Inteligentes:** Foque no que é importante com filtros por responsável e tipo * **Gestão Centralizada:** Crie, edite, conclua e exclua atividades diretamente do calendário * **Integração Total:** Sincronização automática com atividades de tickets O calendário de atividades é uma ferramenta essencial para usuários que precisam gerenciar múltiplas tarefas e manter-se organizado, proporcionando uma visão clara e controlada do fluxo de trabalho. # Painel de Controle Source: https://agile-docs.3code.com.br/organization/control-panel Gerencie as configurações globais da sua organização, como autenticação e conta de e-mail padrão para envios automáticos. ## Visão geral O **Painel de Controle** permite definir configurações globais da organização, como a forma de autenticação dos usuários e a **[conta de e-mail padrão](/organization/email-account)**, que será utilizada para o envio de notificações, alertas e e-mails transacionais.

*** ## Formas de autenticação A autenticação é o processo de verificação da identidade do usuário. No painel de controle, você pode escolher entre duas opções: ### Email e Senha Permite que os usuários se autentiquem utilizando um e-mail e uma senha. Email Senha *** ### Link por e-mail Permite que os usuários se autentiquem através de um link enviado para o e-mail cadastrado. Essa opção é ideal para evitar o uso de senhas, aumentando a segurança.

É importante que o usuário verifique a caixa de spam ou lixo eletrônico caso não receba o e-mail de autenticação na caixa de entrada. *** ### SSO O SSO (Single Sign-On) permite que os usuários acessem o sistema utilizando suas credenciais de outro provedor de identidade, como Google, Microsoft ou qualquer serviço compatível com SAML/OAuth. Essa opção elimina a necessidade de senha específica para o sistema, aumentando a segurança e facilitando o gerenciamento de usuários em grandes organizações. Para configurar o SSO da sua organização, clique **[aqui](/organization/sso-settings)**

É importante que o usuário verifique a caixa de spam ou lixo eletrônico caso não receba o e-mail de autenticação na caixa de entrada. *** ## Conta de e-mail padrão Escolha a conta de e-mail padrão que será utilizada para o envio de notificações e alertas. Esta conta será usada para todos os envios automáticos do sistema, como notificações de eventos, alertas de segurança e outros comunicados importantes.

Para saber mais sobre como criar e gerenciar contas de e-mail, clique **[aqui](/organization/email-account)** # Clientes Source: https://agile-docs.3code.com.br/organization/customers Visualize e gerencie todos os clientes da sua organização no sistema Agile. Acompanhe status, informações cadastrais e histórico de interações. ## Visão geral A tela de Clientes é o centro de gerenciamento de relacionamento com clientes no sistema Agile. Aqui você pode: * Visualizar todos os clientes cadastrados * Filtrar por status ou características específicas * Acessar informações detalhadas de cada cliente

*** ## Como criar um novo cliente

Clique no botão **[Criar Novo](/general/create)** no canto superior direito da tela principal. * Status: Cliente ativo ou inativo. * Código: Identificador externo do cliente. * Nome: Razão social. * Tipo: Pessoa física ou jurídica. * Apelido: nome curto/fantasia para identificação rápida. * Data de nascimento: para clientes pessoa física. * Empresas: em ambientes com múltiplas empresas, define a quais o cliente pertence. *** ## Configurando um cliente A tela de detalhes do cliente exibe informações básicas, como nome, contato, endereço e etc. Ela pode ser acessada ao clicar no ícone de detalhes na lista de clientes. ### Detalhes do cliente

Ao clicar no ícone de detalhes, você será redirecionado para a tela de detalhes do cliente. ### Dados básicos

Nesta seção, você pode visualizar e editar as informações básicas do cliente, como nome, CNPJ/CPF, endereço e contato. É importante manter essas informações atualizadas para garantir uma comunicação eficaz. ### Contatos

Nesta seção, você pode adicionar, editar ou remover contatos associados ao cliente. Isso é útil para manter um registro de quem são os principais pontos de contato dentro da empresa. ### Endereços

Nesta seção, você pode adicionar, editar ou remover endereços associados ao cliente. Isso é útil para manter um registro de onde o cliente está localizado e facilitar a comunicação. ### Usuários

Nesta seção, você pode adicionar, editar ou remover usuários associados ao cliente. Para saber mais sobre os usuários, clique **[aqui](/organization/users)**. ### Chaves de API

Nesta seção, você pode adicionar, editar ou remover chaves de API associadas ao cliente. Para saber mais sobre as chaves de API, clique **[aqui](/organization/api-keys)**. ### Outras abas (conforme módulos e permissões) Dependendo dos módulos contratados e das suas permissões, a tela de detalhes do cliente pode exibir abas adicionais: * **Tickets** — histórico de tickets do cliente (quando o módulo Ticket está ativo). * **Projetos** — projetos vinculados ao cliente (conforme permissão). * **Follow Ups** — acompanhamentos de relacionamento do cliente (módulo CRM). * **Anexos** — arquivos associados ao cliente (módulo CRM). # Contas de e-mail Source: https://agile-docs.3code.com.br/organization/email-account As contas de e-mail são utilizadas para configurar os remetentes responsáveis pelo envio de e-mails automáticos da sua organização, como notificações, confirmações e alertas. ## Visão geral Você pode cadastrar uma ou mais contas de e-mail personalizadas com seu próprio domínio, como `suporte@suaempresa.com.br`. Isso garante maior confiabilidade nos envios, reduz o risco de spam e transmite mais profissionalismo.

Para escolher qual conta de e-mail padrão, acesse a seção de **[Painel de Controle](/organization/control-panel)** e selecione a conta desejada. Esta conta será utilizada para o envio de notificações e emails transacionais. *** ## Como criar uma nova conta de e-mail

Clique no botão **[Criar Novo](/general/create)** no canto superior direito da tela principal. * Status: Define se a conta está ativa ou inativa para envios. * Nome: Nome interno da conta, usado apenas para identificação. * E-mail: O e-mail real que será usado como remetente nos envios. * Nome de exibição: Nome visível para o destinatário do e-mail, no campo “De”. * Senha: Senha da conta de e-mail. *** ## Configurando uma conta de e-mail

Ao clicar no ícone de detalhes, você será redirecionado para a tela de detalhes da conta de e-mail.

Nesta seção, você pode visualizar e editar as informações básicas da conta de e-mail, como nome, e-mail, nome de exibição e senha. *** ### SMTP Para configurar o envio de e-mails, você precisará fornecer as informações do servidor SMTP. Essas informações geralmente são fornecidas pelo seu provedor de e-mail.

* **SSL?**: Habilita a conexão segura via SSL. Recomendado quando o provedor exige esse tipo de criptografia. * **TLS?**: Habilita a conexão segura via TLS. Normalmente usada como alternativa ao SSL. * **Server**: Endereço do servidor SMTP (ex: `smtp.seudominio.com`). * **Port**: Porta do servidor SMTP. Comum: `587` (TLS) ou `465` (SSL). * **Usuário**: Usuário da conta de e-mail. Geralmente é o próprio e-mail (ex: `suporte@empresa.com`). * **Senha**: Senha da conta de e-mail. Será usada para autenticar os envios. Certifique-se de que o servidor e as credenciais estão corretos. Um erro aqui impedirá o envio de e-mails. *** ### Graph API Para provedores que suportam Graph API, como o Microsoft 365, você pode configurar o envio de e-mails usando essa API.

* **Client ID**: Identificador único do aplicativo registrado no portal do Azure. É fornecido ao registrar o app em `https://portal.azure.com`. * **Tenant ID**: Identificador do diretório (tenant) da organização no Azure Active Directory. * **Client Secret**: Chave secreta gerada no registro do app no Azure. Usada em conjunto com o `Client ID` para autenticar a aplicação. * **Scope**: Permissões que a aplicação irá solicitar ao usuário (ex: `https://graph.microsoft.com/.default`). Define o nível de acesso da aplicação. Para gerar os dados acima, acesse o [Azure Portal](https://portal.azure.com), registre um novo aplicativo e siga o processo de criação de credenciais OAuth 2.0. *** ### Google API Esta aba permite configurar os dados de autenticação OAuth 2.0 para envio de e-mails via conta Google (Gmail API). As credenciais devem ser obtidas no [Google Cloud Console](https://console.cloud.google.com).

* **Client ID**: Identificador único do aplicativo criado no [Google Cloud Console](https://console.cloud.google.com). Necessário para autenticação. * **Client Secret**: Chave secreta gerada junto ao `Client ID`. Usada para autenticar a aplicação. * **Project ID**: ID do projeto Google Cloud vinculado ao app. Ele aparece na tela de credenciais ao criar ou gerenciar um projeto no console do Google. Para obter as credenciais, vá até o Google Cloud Console → APIs e serviços → Tela de consentimento OAuth → Criar credenciais → OAuth Client ID. # Log de envio de e-mails Source: https://agile-docs.3code.com.br/organization/email-send-logs Acompanhe todos os e-mails enviados pela plataforma, com status e diagnóstico de falhas. ## Visão geral O **Log de envio de e-mails** registra cada e-mail disparado pela plataforma (notificações, respostas, campanhas, etc.), permitindo acompanhar entregas e diagnosticar falhas. Log de envio de e-mails - tema claro

No topo, quatro cartões resumem o período selecionado: **Total no período**, **Sucesso**, **Erro** e **Pendente** (este último mostra a fila atual, considerando todos os períodos). *** ## Filtros * **Período** — atalhos para **Hoje**, **7 dias**, **15 dias** e **30 dias**. * **Destinatário** — busca pelo e-mail de destino. * **Assunto** — busca pelo título do e-mail. * **Status** — Todos, Sucesso, Erro ou Pendente. *** ## Colunas | Coluna | Descrição | | ------------------------ | ----------------------------------------------- | | **Criado em** | Data/hora em que o envio foi solicitado. | | **Destinatário** | E-mail de destino. | | **Assunto** | Título do e-mail. | | **Módulo** | Módulo de origem do e-mail. | | **Status** | **Sucesso**, **Erro** ou **Pendente**. | | **Tentativas** | Número de reenvios. | | **Enviado em** | Data/hora do envio efetivo (ou "—"). | | **Tempo até envio/erro** | Duração entre a criação e o envio (ou a falha). | | **Motivo do erro** | Mensagem de erro, quando houver. | Esta tela é somente de consulta — não há tela de detalhe; todas as informações de cada envio ficam na própria linha. # Sobre a organização Source: https://agile-docs.3code.com.br/organization/i Sua organização no **Agile** é criada automaticamente ao contratar um módulo da plataforma. Com isso, você terá acesso total às funcionalidades, permitindo que personalize a plataforma de acordo com as necessidades da sua empresa. ### Passos para Criar sua Organização 1. [Contratar um Módulo](/organization/module): Ao contratar um módulo do Agile, sua organização será criada automaticamente. 2. [Configuração Personalizada](/organization/visual-identity): Após a criação da organização, você poderá configurar o Agile conforme a identidade da sua empresa, ajustando cores, temas e outros detalhes visuais. 3. [Adicionar Clientes](/organization/customers) e [Usuários](/organization/users): Adicione seus clientes e usuários à sua organização. Crie diferentes níveis de acesso, garantindo que cada pessoa tenha a experiência adequada ao seu papel. 4. [Gerenciar Permissões](/organization/access-profile): Defina permissões específicas para cada usuário, controlando o que eles podem visualizar ou editar dentro da plataforma. *** ## Personalizando sua Organização Deixe o Agile com a cara da sua empresa! Acesse a seção [Identidade da Organização](/organization/visual-identity) para configurar cores, identidade visual, integrações e muito mais. Personalize o Agile com as cores e identidade visual da sua marca. Configure as credenciais de envio de e-mail da sua organização. # Módulos Source: https://agile-docs.3code.com.br/organization/module O que são os módulos do Agile? Os módulos do Agile são serviços especializados que expandem a capacidade da plataforma para atender diferentes necessidades da sua empresa.\ Cada módulo adiciona funcionalidades específicas ao Agile, permitindo que sua organização seja personalizada de acordo com seus objetivos e sua operação. Ao contratar um módulo, ele será associado à sua organização no Agile, expandindo suas funcionalidades conforme as necessidades da sua empresa. *** ## Módulos com documentação Estes módulos já contam com documentação: * **[Ticket](/ticket/i)** — gerencie chamados de atendimento de forma organizada, centralizando a comunicação entre clientes e equipes. * **[CRM](/crm/i)** — gestão de leads, funis de vendas, follow-ups, campanhas de e-mail e pesquisas de experiência. * **[Cofre de Senhas](/vault/i)** — armazenamento seguro de credenciais, com controle de acesso e auditoria. ## Em breve Outros módulos da plataforma terão documentação em breve: * **Jurídico** — gestão de processos, prazos e o fluxo de reclamações do Procon. * **Financeiro** — contas a pagar e a receber, faturas, fluxo de caixa e emissão de notas. * **Estoque** — produtos, movimentações, fornecedores e cotações. * **Clínica** — gestão de pacientes, agendamentos e atendimentos. * **Integrações** — conectores e pipelines com sistemas externos. A disponibilidade de cada módulo depende dos serviços contratados pela sua organização. Com os módulos, você personaliza a plataforma de acordo com o segmento da sua empresa, ativando apenas os serviços que realmente precisa. # Notificações Source: https://agile-docs.3code.com.br/organization/notification Um pouco sobre as notificações no Agile # Visão geral O sistema de notificações do Agile foi desenvolvido para manter os usuários informados sobre eventos importantes em tempo real ou sob demanda, garantindo uma comunicação eficaz dentro da plataforma. *** ## Categorias de Notificações As notificações são organizadas em diferentes categorias para facilitar o acesso e o entendimento: * **Geral:** Informações sobre movimentações importantes como encerramento de tickets. * **Lembretes:** Alertas configuráveis que ajudam o usuário a não perder prazos. * **Segurança:** Eventos relacionados à conta do usuário, como mudanças de senha ou novos acessos. * **Novidades:** Atualizações de funcionalidades ou melhorias na plataforma. * **Ofertas:** Promoções e oportunidades relacionadas aos serviços da plataforma. *** ## Notificações Rápidas (Sino no topo) No canto superior direito da interface, o ícone de sino exibe um resumo rápido das últimas notificações:

* Separação por abas: `Não lidas` e `Lidas` - Ação rápida de **"Marcar todas como lidas"** - Botão **"Ver todas"** redireciona para a Central completa - redireciona para a Central de notificações *** ## Central de notificações A Central de Notificações permite que o usuário visualize, filtre e gerencie todas as notificações recebidas de forma organizada. Essa visão oferece mais controle do que o menu rápido acessado pelo ícone de sino.

* Filtro por categoria (Geral, Lembretes, Segurança, etc.) * Visualização de notificações lidas e não lidas * Marcação rápida de todas como lidas * Ação individual para cada notificação (`...`) * Indicador de tempo de leitura e criação > A Central é ideal para revisar eventos passados e manter o histórico de ações importantes dentro da plataforma. *** ## Preferências de notificações Além da Central, há uma página de **Preferências de notificações**, onde você define **como** quer ser avisado de cada tipo de evento — habilitando ou desabilitando os canais por categoria: * **E-mail** * **SMS** * **Notificações push** Assim, cada usuário personaliza quais avisos recebe e por qual meio, evitando excesso de notificações. # Perfil Source: https://agile-docs.3code.com.br/organization/profile Configurações do perfil do usuário Você pode acessar o perfil de usuário entrando na área de Configurações e clicando em Perfil, ou diretamente pelo atalho disponível na área superior (header). Nesta seção, é possível visualizar e editar suas informações pessoais, como nome, CPF, telefone, foto de perfil e senha.

*** ## Configurações do perfil Na página de perfil, o card **Informações pessoais** reúne seus dados de identificação na plataforma. Por padrão eles aparecem apenas para leitura — clique em **Editar** para alterá-los e em **Salvar** para confirmar (ou **Cancelar** para descartar).

* **Foto de perfil**: no modo de edição, clique no avatar para enviar ou remover uma imagem. * **Nome**: nome de exibição do usuário. * **CPF**: opcional. * **Email**: usado para acesso e comunicações; é **somente leitura**. * **Telefone**: número de contato, opcional. *** ## Alterar senha A troca de senha está disponível apenas para usuários cuja **forma de autenticação** é **Usuário e Senha**. Para alterá-la, clique em **Editar** no card de perfil e, no campo **Senha**, clique em **Alterar senha...**. Abrirá um modal onde você informa a **senha atual**, a **nova senha** e a **confirmação**. Clique em **Salvar alteração** para aplicar.

# Configurações Source: https://agile-docs.3code.com.br/organization/settings Aqui você encontra informações sobre como configurar sua organização. ## Visão geral A área de configurações reúne, em um só lugar, tanto seus dados pessoais quanto os parâmetros da sua organização e da interface do sistema. Os atalhos ficam organizados em dois grupos: **Minha conta** e **Organização**. Tela de Configurações - tema claro

## Seções de Configuração ### Minha conta * **[Perfil](/organization/profile)** Seus dados pessoais, alteração de senha e preferências de comunicação. * **[Central de Notificações](/organization/notification)** Acompanhe e gerencie as notificações que você recebe na plataforma. * **Launcher** Atalhos de acesso rápido às áreas que você mais utiliza. *** ### Organização * **[Painel de Controle](/organization/control-panel)** Configurações principais da organização, como a forma de autenticação e a conta de e-mail padrão para envios automáticos. * **Meus Módulos** Ative e ajuste os módulos contratados (por exemplo, Ticket e Estoque) e suas configurações específicas. * **[Contas de E-mail](/organization/email-account)** Defina as credenciais (SMTP, Microsoft 365 ou Google) utilizadas para envio de e-mails e notificações. * **[API Keys](/organization/api-keys)** Gere e gerencie chaves de acesso para integrar seus serviços com segurança. * **[Aparência](/organization/visual-identity)** Personalize a identidade visual do sistema: logotipo, cores, favicon e tela de login. * **[Configurações de SSO](/organization/sso-settings)** Configure o Single Sign-On (SSO) para que seus usuários acessem o sistema por meio de provedores externos. * **Integrações** Conecte a plataforma a sistemas externos por meio de integrações e conectores. * **Inteligência Artificial** Ative e configure os recursos de inteligência artificial disponíveis na plataforma. * **Assinatura eletrônica** Configure a assinatura eletrônica de documentos. # Configurações de SSO Source: https://agile-docs.3code.com.br/organization/sso-settings Configure o Single Sign-On (SSO) para integração centralizada com provedores externos. ## Visão geral A tela de **Configurações de SSO** permite que a organização integre um provedor de identidade externo compatível com SAML/OAuth.\ Com o SSO, os usuários podem acessar o sistema sem precisar de senha específica, facilitando o gerenciamento de contas e aumentando a segurança. Nesta tela, você pode: * Ativar ou desativar o SSO * Configurar URLs de login e logout * Inserir certificados e chaves de segurança * Fazer o download da metadata do Service Provider (SP)

*** ## Campos e opções principais ### Ativo Habilite ou desabilite o SSO para a organização. Se desabilitado, os usuários continuarão usando as formas de autenticação padrão, como e-mail e senha. *** ### ServiceProviderEntityId Identificador do seu SP, usado pelo IdP para reconhecer sua aplicação. *** ### AssertionConsumerServiceUrl URL do seu ACS endpoint, para onde o IdP envia a resposta SAML. *** ### SingleLogoutUrl URL do seu SP para logout único (opcional). *** ### DisplayName Nome amigável da configuração para exibição no ERP. *** ### ValidateSignature Flag de validação da assinatura SAML (opcional, SP controla). *** ### ValidateAssertionSignature Flag de validação da assinatura da assertion SAML. *** ### RequireHttps Impõe HTTPS nos endpoints SAML. *** ### NameIdentifierAttribute Define qual atributo identifica o usuário no SP (ex: email, UPN). *** ### IdPMetadata Documento XML do Identity Provider com URLs, certificados e configurações necessárias para autenticação. *** ### IdentityProviderCertificate Certificado público do Identity Provider usado para validar a assinatura das mensagens SAML. *** ### Download SP Metadata Botão que permite baixar a metadata do Service Provider para fornecer ao provedor de identidade. *** ## Como aplicar a configuração 1. Preencha todos os campos obrigatórios do provedor de identidade. 2. Clique em **Confirmar** para aplicar a configuração. 3. O SSO estará ativo e os usuários poderão se autenticar utilizando o provedor configurado. # Usuários Source: https://agile-docs.3code.com.br/organization/users A tela de Usuários do Agile é o local onde você gerencia os usuários internos do sistema, ou seja, os atendentes que têm acesso à plataforma ## Visão geral Esse gerenciamento centralizado facilita o controle e a organização dos membros que utilizam o sistema no dia a dia. Nesta tela, você pode: * Visualizar a lista completa de usuários internos e externos cadastrados * Criar novos usuários para sua equipe * Filtrar usuários por status, perfil ou outras características * Acessar os detalhes individuais de cada usuário para visualizar e editar suas informações Usuários externos são aqueles pertencentes ao cliente. Interno Externo *** ## Como criar um novo usuário

Clique no botão **[Criar Novo](/general/create)** no canto superior direito da tela principal. * É Interno?: Quando desabilitado, é obrigatório selecionar um cliente padrão para o usuário. Por padrão, essa opção vem habilitada, dispensando a escolha de um cliente. * Nome: Nome completo ou razão social do usuário. * CPF: Não é obrigatório, mas é recomendado para pessoas físicas. * E-mail: Endereço de e-mail do usuário. * Seu telefone: Número de telefone para contato, opcional. * Empresas: Define a quais empresas o usuário interno terá acesso. Disponível para usuários internos em ambientes com múltiplas empresas. * Perfil de acesso: Selecione o perfil adequado para o usuário, como atendente, administrador, etc. Para saber mais sobre perfil de acesso, clique **[aqui](/organization/access-profile)**. * Módulo padrão: Selecione o módulo que será aberto por padrão quando o usuário acessar o sistema. * Forma de autenticação: Define como o usuário irá acessar o sistema. As opções são **Usuário e Senha**, **Link por e-mail** e **SSO**. Se quiser saber mais, clique **[aqui](/organization/control-panel#formas-de-autenticação)**. * Assinatura de e-mail: Insira a assinatura que será usada nas comunicações enviadas pelo usuário, opcional. **Obs.: Caso nenhuma forma de autenticação seja selecionada, o usuário herdará a forma de autenticação definida pela organização.** *** ## Confirmação por e-mail Após criar um novo usuário, o sistema enviará automaticamente um e-mail de confirmação para o endereço fornecido. O usuário precisará clicar no link de confirmação contido nesse e-mail para validar a conta e criar uma senha. ### Envio automático de confirmação

É importante que o usuário verifique a **caixa de spam ou lixo eletrônico** caso não receba o e-mail de confirmação na caixa de entrada. ### Reenvie a confirmação (se necessário)

Se o e-mail não for encontrado, você pode solicitar um novo envio clicando no ícone de **Reenviar convite** ao lado dos detalhes do usuário. *** ## Senha do usuário Ao clicar no link de confirmação no e-mail, o usuário será redirecionado para uma página onde poderá criar sua senha. É importante que a senha atenda aos critérios de segurança definidos pelo sistema. ### Boas-vindas

### Definir senha

Após definir a senha, o usuário será redirecionado para a tela de login, onde poderá acessar o sistema com suas credenciais recém-criadas. *** ## Configurando um usuário

Ao clicar no ícone de detalhes, você será redirecionado para a tela de detalhes do usuário. ### Dados básicos

Nesta seção, você pode visualizar e editar as informações básicas do usuário, como nome, CPF e etc. É importante manter essas informações atualizadas. ### Departamentos

Nesta seção, você pode visualizar e gerenciar os departamentos associoados ao usuário. Quando o departamento está em modo somente leitura, **o usuário apenas pode visualizar os tickets aos quais pertence**, sem possibilidade de interação com eles. Para saber mais sobre como criar e gerenciar departamentos, clique **[aqui](/ticket/department)**. ### Equipes

Nesta seção, você pode visualizar e gerenciar as equipes associadas ao usuário. ### Outros clientes

A aba **"Outros Clientes"** é exibida apenas para usuários externos. Além de selecionar um cliente padrão, é possível associar o usuário a outros clientes, permitindo que ele tenha acesso a múltiplas contas dentro da plataforma. # Identidade visual Source: https://agile-docs.3code.com.br/organization/visual-identity Personalize a aparência do sistema operacional da sua organização no **Agile**. ## Aparência Nesta área, você pode deixar o sistema com a cara da sua organização. É possível ajustar o nome visual da empresa, configurar cores, trocar o logotipo, favicon e até a imagem da tela de login. Tudo isso de forma simples e acessível.

*** ## O que você pode configurar ### Alias da organização Esse é o nome que será usado como referência nos códigos dos tickets (por exemplo: `AGILE`). Pode ser o nome da sua empresa ou alguma sigla que identifique facilmente a organização. *** ## Cores e fonte Você pode ajustar a aparência dos textos e cores principais da interface: * **Cor da fonte (tema claro e escuro):** Defina qual será a cor do texto em cada tema. Isso é importante para manter a legibilidade da interface tanto no modo claro quanto no escuro. * **Cor primária:** É a cor base da identidade visual do seu sistema. Ela aparece em botões, links, seletores e outros elementos de destaque. Você pode definir a cor primária de duas maneiras: * Informando diretamente o **código hexadecimal**, como `#7722ff`; * Ou usando a **paleta de cores**, que permite selecionar a cor.. *** ## Paleta de cores Na aba **Paleta de cores**, você encontra uma interface mais detalhada para definir a identidade visual da plataforma: * Ajuste tons mais claros e mais escuros da cor primária; * Garanta contraste e harmonia para temas claro e escuro; * Mantenha a identidade visual da sua marca com mais precisão.

Essa personalização é ideal para manter consistência visual com outros sistemas ou materiais institucionais. *** ## Tamanho da logo Aqui você informa a altura da sua logo em pixels. Por exemplo: `35`. Isso ajuda o sistema a manter a proporção correta ao exibi-la nos menus e cabeçalhos. *** ## Imagens da marca Você pode enviar três tipos de imagem: * **Logo:** usada na navegação principal. Tamanho recomendado: **80x35 pixels**.

* **Favicon:** ícone pequeno que aparece na aba do navegador. Tamanho recomendado: **16x16 pixels**.

* **Tela de login:** exibida ao fundo da tela inicial. Recomendado: **1920x1080 pixels** para alta qualidade.

Para trocar, basta clicar no botão de **escolher arquivo** e enviar uma nova imagem. Depois, clique em **Salvar** no final da tela para aplicar as mudanças. Lembre-se de manter um bom contraste entre as cores de texto e fundo para garantir acessibilidade e uma boa experiência para todos os usuários. # Categorias Source: https://agile-docs.3code.com.br/ticket/category Como funcionam as categorias do módulo de ticket? ## Visão geral Categoria é uma classificação que agrupa assuntos semelhantes dentro do sistema de tickets. Ela ajuda a organizar e priorizar os chamados, facilitando a identificação de padrões e a alocação de recursos para resolução.

*** ## Como criar uma nova categoria

Clique no botão **[Criar Novo](/general/create)** no canto superior direito da tela principal. * Se a categoria será ativa ou inativa. * Nome da categoria. * Descrição da categoria. Opcional. Você pode preencher o nome e a descrição do assunto em Português, Inglês ou Espanhol. *** ## Configurando uma Categoria A tela de detalhes da categoria permite que você visualize e edite as informações da categoria selecionada. Você pode alterar o nome, a descrição e o status (ativo/inativo) da categoria. ### Detalhes da categoria

Ao clicar no ícone de detalhes, você será redirecionado para a tela de detalhes da categoria. ### Dados básicos

Nesta seção, você pode visualizar e editar as informações básicas do assunto, como nome, descrição, status e outros detalhes relevantes. ### Assuntos vinculados à categoria

Nesta seção, é possível visualizar os assuntos vinculados à categoria selecionada e criar novos assuntos diretamente relacionados a ela. A principal diferença desta tela é que você escolhe apenas o **[departamento](/ticket/department)** ao vincular um assunto, enquanto na tela de assuntos é necessário selecionar tanto o departamento quanto a categoria. Para saber mais sobre como criar um assunto, clique **[aqui](/ticket/subject)**. # Para clientes Source: https://agile-docs.3code.com.br/ticket/customer Como abrir um ticket como cliente no Agile ## Visão geral O módulo de tickets permite que os clientes abram chamados para registrar problemas, solicitar serviços ou fazer perguntas. Esses tickets são gerenciados pela equipe de suporte, que pode responder e resolver as solicitações dos clientes. *** ## Overview do cliente O overview do cliente apresenta um painel simples e intuitivo, permitindo visualizar rapidamente o andamento de suas próprias solicitações. Ele mostra o status dos tickets e oferece acesso rápido para abrir novas demandas. A proposta é oferecer clareza sem sobrecarregar com informações técnicas ou operacionais. *** ## Grid de tickets O grid de tickets permite que os clientes visualizem todos os tickets abertos, filtrando por status, prioridade e etc. Eles podem acessar detalhes de cada ticket clicando no ícone de detalhes. Caso o usuário do cliente possua a permissão de visualizar todos os tickets, ele terá acesso a todos os registros. Caso contrário, visualizará **apenas os tickets abertos por ele.** *** ## Como abrir um ticket

Clique no botão **[Criar Novo](/general/create)** no canto superior direito da tela principal. ### Preenchimento dos dados * Escolha a categoria do ticket. Para saber mais sobre categorias, clique **[aqui](/ticket/category)**. * Ao escolher a categoria, os assuntos relacionados a ela serão exibidos. Selecione o assunto apropriado. Para saber mais sobre assuntos, clique **[aqui](/ticket/subject)**. * Preencha a descrição do ticket aberto. * Se necessário, anexe arquivos relevantes ao ticket. (O tamanho máximo é de 100mb) ### Detalhes do Ticket

Você será redirecionado para a página de detalhes do ticket recém-criado. Aqui, você pode visualizar as informações do ticket, como categoria, assunto, descrição e anexos. Além disso, você pode acompanhar o status do ticket e as respostas da equipe de suporte.

Você também pode cancelar o ticket clicando no botão **Cancelar**. ### Aba de mensagens

Na aba de mensagens, você pode visualizar todas as interações relacionadas ao ticket. Você pode enviar novas mensagens, responder às mensagens da equipe de suporte e acompanhar o progresso do ticket. ### Logs do ticket

Na aba de logs, você pode visualizar o histórico completo de ações realizadas no ticket. Isso inclui alterações de status, atualizações de prioridade e outras ações relevantes. ### Ticket fechado

Quando o ticket é fechado, você será notificado e o ticket entrará no status de **Aguardando avaliação**.

Para concluir um ticket é necessário avaliá-lo. Clique no botão **Avaliar** para abrir o formulário de avaliação. ### Avaliação do ticket

No formulário de avaliação, você pode fornecer feedback sobre o atendimento recebido. Preencha os campos de avaliação, como satisfação com o atendimento, qualidade da solução e comentários adicionais. Sua avaliação é importante para melhorar a qualidade do suporte. ### E se o problema não foi resolvido?

Caso o problema não tenha sido resolvido e o ticket já esteja encerrado, você pode reabri-lo. Durante a avaliação, selecione a opção "Problema não resolvido", adicione um comentário explicando a situação e, se necessário, anexe arquivos adicionais. O ticket será reaberto automaticamente, e a equipe de suporte será notificada para dar continuidade ao atendimento. ### Ticket concluído

Por fim, ao ser concluído, o ticket terá seu status atualizado para "Concluído no prazo" ou "Concluído fora do prazo", conforme o cumprimento do SLA. O ticket será então movido para o status Concluído e o SLA será encerrado. Você pode duplicar o ticket clicando no botão **Duplicar**. Isso é útil se você precisar abrir um ticket semelhante no futuro. *** ## Duplicar ticket

A função de duplicar ticket permite criar um novo ticket replicando todas as propriedades do ticket original. Isso agiliza o registro de tickets semelhantes, mantendo as mesmas informações preenchidas automaticamente. *** ## Solicitação Pendente de Aprovação

O ticket está atualmente com o status **Aguardando aprovação**. Isso indica que sua solicitação está em fase de análise pela equipe responsável e, em breve, você receberá um retorno. Esse status é utilizado quando o atendimento depende de uma etapa adicional, como a aprovação de um gerente, a autorização de um responsável ou a verificação de informações complementares. Assim que a solicitação for aprovada, o ticket será atualizado para o status Pendente, permitindo o seguimento normal do atendimento e acompanhamento do processo. # Departamentos Source: https://agile-docs.3code.com.br/ticket/department Como funcionam os departamentos do módulo de ticket? ## Visão geral Departamento é uma unidade organizacional dentro do sistema de tickets que agrupa usuários e define responsabilidades para o atendimento de chamados. Ele permite que os tickets sejam direcionados para a equipe ou setor adequado, melhorando a eficiência no gerenciamento de solicitações. Aqui você pode: * Visualizar todos os departamentos cadastrados * Filtrar por status ou características específicas * Acessar informações detalhadas de cada departamento

*** ## Departamento interno ou externo Departamentos internos são áreas da organização que lidam com assuntos relacionados à própria empresa, como recursos humanos, financeiro e administrativo. Já os departamentos externos são voltados para o atendimento de demandas vindas de fora da empresa, como clientes, fornecedores ou parceiros. Essa divisão ajuda a organizar melhor os tipos de solicitações e o fluxo de atendimento. *** ## Como criar um novo departamento

Clique no botão **[Criar Novo](/general/create)** no canto superior direito da tela principal. ### Preenchimento dos dados * **Status:** Define se o departamento será ativo ou inativo. * **Interno ou externo:** Se o departamento é interno (para uso da empresa) ou externo (para clientes e parceiros). - **Equipe de atendimento:** Permite vincular uma equipe ao departamento. - **Responsável do departamento:** Usuário responsável pelo departamento. - **Nome:** Nome do departamento. - **Descrição:** Breve descrição do departamento. - **Permitir controle por estágio?** Habilita o uso de estágios dentro do fluxo do departamento. - **Campos condicionais (aparecem quando Interno):** * **Privado:** Define se o departamento é privado. * **Permite selecionar atendente?** Permite que o responsável pelo ticket seja definido no momento da criação. * **Equipes permitidas (Abertura):** Define quais equipes podem abrir tickets neste departamento. ## Configurando um departamento A tela de detalhes do departamento exibe informações básicas, como nome, descrição e status (ativo ou inativo). Ela pode ser acessada ao clicar no ícone de detalhes na lista de departamentos. ### Detalhes do departamento

Ao clicar no ícone de detalhes, você será redirecionado para a tela de detalhes do departamento. ### Dados básicos

Nesta seção, você pode visualizar e editar as informações principais do departamento, como nome, descrição e status. É possível ativar ou desativar o departamento, definir se ele é **interno** e configurar opções complementares conforme o tipo selecionado. * **Permitir controle por estágio:** Habilita o uso de estágios dentro do fluxo do departamento, permitindo acompanhar o progresso dos tickets. * **Interno:** quando ativado, surgem opções adicionais: * **Privado:** Define se o departamento é privado. * **Desativar avaliação do cliente?** Quando ativado, o ticket é concluído diretamente pelo usuário interno (sem avaliação do cliente). * **Permite selecionar atendente?** Permite que o responsável pelo ticket seja definido no momento da criação. * **Equipes permitidas (Abertura):** Define quais equipes podem abrir tickets neste departamento. * **Responsável do departamento:** Usuário responsável pelo departamento. ### Assuntos

Nesta seção, é possível visualizar os assuntos vinculados ao departamento selecionado e criar novos assuntos diretamente relacionados a ele. A principal diferença desta tela é que você escolhe apenas a **[categoria](/ticket/category)** ao vincular um assunto, enquanto na tela de assuntos é necessário selecionar tanto a categoria quanto o departamento. Para saber mais sobre como criar um assunto, clique **[aqui](/ticket/subject)**. ### Membros

Nesta seção, você pode visualizar e adicionar membros a este departamento. Os membros são os usuários que farão parte do atendimento deste departamento, ou seja, usuários internos. Para saber mais sobre usuários, clique **[aqui](/organization/users)**. ### Horários

Nesta seção, você pode visualizar e configurar os horários de atendimento. Defina os dias e horários em que o serviço estará disponível, com a flexibilidade de ajustar períodos específicos para cada dia da semana. Atenção: se os horários do departamento não estiverem configurados, você verá o seguinte erro ao abrir um ticket: **"Horário de atendimento não configurado"** ### Clientes

Nesta seção, você pode visualizar e associar o clientes a este departamento. Isso permite que os tickets sejam direcionados corretamente para o atendimento adequado. Para saber mais sobre clientes, clique **[aqui](/organization/customers)**. A aba "Clientes" só estará disponível se o departamento for do tipo externo. ### Estágios

Nesta aba, você pode visualizar, criar e organizar os estágios que compõem o fluxo de atendimento do departamento. Os estágios representam as etapas que um ticket percorre desde sua criação até o encerramento. Isso permite gerenciar melhor o progresso de cada ticket e garantir que todos os processos definidos pelo departamento sejam seguidos corretamente. ### Categorização de conclusão

A Categoria de Conclusão é utilizada para classificar e registrar o motivo do fechamento de um ticket. Essa categorização auxilia na análise de métricas, relatórios e na melhoria contínua do atendimento, permitindo identificar padrões de encerramento. Ao fechar um ticket, se existir uma Categoria de Conclusão cadastrada no departamento do ticket, será exibida a opção para selecioná-la.

### Regras de distribuição

A tela de Regra de Distribuição permite configurar como os tickets serão distribuídos automaticamente entre os membros do departamento. Nela, é possível selecionar membros e clientes para definir a forma de distribuição. Na criação da regra, você pode escolher entre os seguintes modos de distribuição: 1. Distribui em ordem sequencial (fila) Os tickets são atribuídos seguindo uma ordem fixa de membros, como em uma fila. **Exemplo:** O primeiro ticket vai para o Membro A, o segundo para o Membro B, depois volta para o Membro A, e assim por diante. *** 2. Distribui para quem tem menos tickets em aberto Atribui o ticket ao membro que possui menos tickets pendentes no momento. **Exemplo:** Se o Membro A tem 2 tickets abertos e o Membro B tem 5, o próximo ticket será atribuído ao Membro A. *** 3. Distribui para manter quantidade total igualitária Garante que, ao longo do tempo, cada membro receba uma quantidade balanceada de tickets. **Exemplo:** Se um membro já recebeu muitos tickets fechados recentemente, o sistema prioriza enviar os próximos a outros membros. # Início Source: https://agile-docs.3code.com.br/ticket/i Qual o objetivo do módulo de ticket? O módulo de ticket é uma ferramenta essencial para empresas que buscam otimizar o atendimento ao cliente. Ele permite a criação e gestão de chamados, facilitando a comunicação entre clientes e equipes de suporte. Com esse módulo, sua empresa pode centralizar as solicitações de atendimento, garantindo que cada demanda seja tratada de forma organizada e eficiente. ## Visão geral A tela **Overview do módulo de Ticket** oferece uma visão consolidada das principais métricas de atendimento, permitindo o acompanhamento rápido e eficiente da operação.

*** ## Tela de Tickets A tela de tickets é o coração do módulo, onde você pode visualizar, criar e gerenciar todos os chamados abertos. Ela permite que sua equipe acompanhe o status de cada ticket, desde a abertura até a resolução, garantindo um fluxo de trabalho eficiente.

O grid de tickets exibe uma lista detalhada de todos os chamados, com informações como status, prioridade, responsável, data de criação e etc. Você pode filtrar e ordenar os tickets para encontrar rapidamente o que precisa. *** ## Status dos Tickets O status dos tickets é uma parte crucial do processo de atendimento. Ele permite que sua equipe saiba em que etapa cada chamado se encontra, facilitando o acompanhamento e a priorização das demandas.

*** ## Ticket público O ticket público é uma forma de compartilhar um chamado com outras pessoas, permitindo que elas acompanhem o conteúdo do ticket sem precisar estar logadas no sistema.

Para compartilhar um ticket, selecione o ícone de compartilhamento e copie o link gerado. Ele pode ser encaminhado por e-mail. O acesso permite apenas a visualização das informações, sem possibilidade de interação, preservando a confidencialidade e integridade dos dados.

# Migrar Source: https://agile-docs.3code.com.br/ticket/migration Como os responsáveis pelos tickets são migrados? Ela é acessada por meio do botão Mais opções, visível apenas para usuários que possuem alguma permissão de migração de tickets. Essa ação está disponível na listagem de tickets, onde é possível selecionar múltiplos itens para aplicar a migração de uma só vez.

**Observação:** ao clicar em Migrar tickets, é exibida uma tela inicial onde o usuário deve escolher o tipo de migração que deseja realizar — atualmente é possível selecionar entre Atendente ou Responsável. Após essa escolha, o sistema segue o mesmo fluxo das etapas já conhecidas descritas abaixo.

Se o usuário não possuir a permissão, o botão **Mais opções** com essa funcionalidade específica **não será exibido**. *** ## Passo a passo de como Migrar

Na primeira etapa, o usuário deve **filtrar os tickets** que deseja visualizar para a migração. Os filtros disponíveis são: **departamento**, **categoria**, **assunto** e **atendente**, sendo os campos de departamento e atendente obrigatórios para prosseguir. Mesmo com a permissão Migrar responsáveis dos tickets, o usuário **só poderá visualizar e migrar tickets de departamentos aos quais também pertence**.

Na segunda etapa, os tickets filtrados são exibidos em um grid, permitindo ao usuário **selecionar quais deseja migrar**. É necessário selecionar **ao menos um ticket** para continuar.

Por fim, na terceira etapa, o usuário deve **selecionar o novo atendente** que assumirá os tickets escolhidos. Apenas atendentes pertencentes ao mesmo departamento dos tickets selecionados estarão disponíveis para escolha. Após definir o novo responsável, basta clicar em migrar para concluir o processo.

# Configurações do módulo de ticket Source: https://agile-docs.3code.com.br/ticket/module-settings Esta tela permite configurar e personalizar funcionalidades do Módulo de Ticket. Aqui você pode ajustar o comportamento do sistema de acordo com suas necessidades específicas, definindo alertas, integrações, regras de SLA e permissões personalizadas. ## Seções de configurações A tela de configurações está organizada em seções que permitem controle total sobre o funcionamento do seu módulo: Para acessar esta tela, é necessário ter a permissão **Visualizar tela de Meus módulos - Ticket**. * **Alertas** — Configure quando e como receber notificações sobre eventos importantes * **Configurações de SLA** — Defina prazos e metas de atendimento personalizadas * **Webhook** — Configure integrações automáticas com sistemas externos * **Configurações por Cliente** — Personalize permissões e comportamentos específicos * **Organizações Vinculadas** — Gerencie conexões entre diferentes organizações

*** ### Sistema de Alertas Configure notificações automáticas e regras de automação para otimizar seu fluxo de trabalho: **Alertas de Notificação:** * **Tickets pendentes de avaliação** — Receba alertas quando tickets aguardam avaliação dos clientes * **Tickets pendentes de interação** — Seja notificado sobre tickets que precisam de resposta dos atendentes * **Tickets próximos do vencimento** — Configure avisos para tickets que estão se aproximando do prazo limite * **Pausa de SLA por solicitação** — Ative a pausa automática do SLA quando houver solicitação de interação do cliente **Automações Inteligentes:** * **Fechamento automático de tickets não avaliados** — Configure o sistema para fechar automaticamente tickets que não foram avaliados após um período determinado (configurável em dias) * **Remoção de responsáveis sem interação** — Remova automaticamente responsáveis de tickets que ficaram sem interação por um tempo específico (configurável em horas) **Alertas adicionais:** * **Resumo semanal de desempenho** — Envie um resumo de desempenho uma vez por semana, escolhendo o **dia da semana** do envio. * **Clientes da carteira sem follow-up** — Avise quando clientes da carteira ficarem sem follow-up por um número de **dias** configurável. * **Tarefas agendadas próximas** — Alerte sobre tarefas agendadas que estão se aproximando, com antecedência configurável em **horas**. * **Tickets aguardando interação do atendente** — Notifique o atendente sobre tickets parados aguardando a interação dele por um número de **dias**. * **Rating baixo** — Alerte imediatamente ao receber uma avaliação igual ou abaixo de um **limite** (de 1 a 5). * **Tickets pendentes sem follow-up** — Avise sobre tickets pendentes que estão sem follow-up por um número de **dias**.

Cada automação permite definir o tempo exato para sua aplicação, oferecendo controle preciso sobre quando as ações devem ser executadas. *** ### Configurações de SLA A seção de Configurações de SLA permite definir prazos e metas de atendimento personalizadas para diferentes níveis de prioridade. Ela inclui: * **Percentual de SLA de conclusão:** Define quando um ticket será marcado como "Vencendo em breve" com base no progresso do prazo de conclusão. * **Percentual de SLA de atendimento:** Define quando um ticket será marcado como "Vencendo em breve" com base no prazo de atendimento inicial. * **Padrões de SLA por prioridade:** Configure tempos específicos (em horas) para cada prioridade de ticket.

Essa configuração ajuda a monitorar o status dos tickets e garante que os prazos sejam cumpridos conforme a prioridade de cada demanda. *** ### Integração via Webhook Conecte seu módulo com sistemas externos: * Habilite ou desabilite o envio de webhooks * Configure a URL de destino para receber os eventos * Selecione quais eventos devem ser enviados (criação, cancelamento, finalização de tickets)

*** ### Configuração por cliente Esta seção permite personalizar o comportamento do sistema de tickets para clientes específicos, oferecendo controle granular sobre permissões de visualização e regras de conclusão automática. **Configurações disponíveis:** * **Visualização por Departamentos:** Configure se o cliente pode visualizar assuntos de todos os departamentos ou apenas do seu departamento específico * **Conclusão Automática de Tickets:** Defina em quanto tempo os tickets deste cliente serão automaticamente concluídos quando não houver interação

*** ### Organizações vinculadas Esta funcionalidade permite conectar sua organização com outras organizações do sistema, possibilitando compartilhamento de recursos e criação de tickets interorganizacionais através de chaves de API. **Como funciona:** Ao vincular uma organização usando sua chave de API, você estabelece uma conexão que permite acessar os departamentos da organização parceira e abrir tickets filhos diretamente para ela, criando um fluxo de trabalho integrado entre as organizações. **Funcionalidades disponíveis:** * **Acesso a Departamentos:** Visualize e interaja com os departamentos da organização vinculada * **Criação de Tickets Filhos:** Abra tickets diretamente para a organização parceira, mantendo a rastreabilidade do relacionamento

# Questionários Dinâmicos Source: https://agile-docs.3code.com.br/ticket/questionnaires Crie formulários personalizados para coletar informações dentro do sistema ou por link público. ## Visão geral Os **Questionários Dinâmicos** permitem montar formulários sob medida — com seções e campos de vários tipos — para coletar informações **embutidas em telas do sistema** (por exemplo, no detalhe de um ticket) ou por meio de um **link público**. Lista de questionários dinâmicos - tema claro

Lista de questionários dinâmicos - tema claro

Lista de questionários dinâmicos - tema escuro

A lista mostra **status**, **módulo**, **nome**, **ID** (copiável), **modelo de uso**, **tipo de acesso**, o **link** do formulário e quem criou. O botão **Respostas** leva ao histórico de respostas recebidas. *** ## Como criar um questionário Clique em **[Criar Novo](/general/create)** e preencha: * **Ativo?** e **Editável após respondido?** (switches). * **Nome** e **Descrição**. * **Empresas** (opcional). * **Exibição das seções**: Todas de uma vez · Em etapas (uma por vez) · Accordion. * **Modelo de uso**: **Embedado** (em telas do sistema) ou **Formulário público** (link fixo). * **Tipo de acesso** (para formulário público): **Público** (qualquer pessoa) ou **Autenticado** (precisa de conta no Agile). Na aba **Configurações do formulário**, monte as **seções** e adicione **campos** (perguntas) em cada uma. É possível **reordenar** por arrastar e soltar, marcar campos como **obrigatórios**, definir **placeholder**, número de colunas e **condições de visibilidade** (campos condicionais). Salve. Se for **público**, um link é gerado para compartilhar. Acompanhe as respostas na aba **Respostas** (filtrável por período). *** ## Tipos de campo Texto · Texto longo · Numérico · Valor monetário · Data · Upload de arquivo · E-mail · Senha · CPF · CNPJ · Telefone · CEP · Seleção única · Seleção múltipla · Caixa de seleção · Botão de opção · Escala NPS · Avaliação (estrelas) · Verdadeiro ou falso. *** ## Conceitos **Embedado** aparece dentro de telas do sistema; **Formulário público** é acessado por um link fixo. **Público**: qualquer pessoa responde pelo link. **Autenticado**: o respondente precisa estar logado no Agile. Um campo pode aparecer apenas quando outra resposta atende a uma condição, deixando o formulário mais enxuto. # Modelos de resposta Source: https://agile-docs.3code.com.br/ticket/response-template Como criar um modelo para as suas respostas? O Modelo de Respostas permite criar templates de mensagens para agilizar o atendimento e padronizar a comunicação com clientes. Esses modelos podem incluir variáveis dinâmicas, que serão automaticamente substituídas pelos dados do ticket ou do cliente no momento do envio. ## Como criar um modelo de resposta

O formulário de criação tem os campos: * **Categoria** (obrigatória) — agrupa os modelos para facilitar a busca. * **Nome** (obrigatório) — identificação do modelo. * **Módulo** (opcional) — restringe o modelo a um módulo específico. * **Empresas** (opcional) — restringe o modelo a empresas específicas. * **Conteúdo** — o texto do modelo, escrito em um **editor de texto rico (HTML)** que aceita **variáveis dinâmicas**, substituídas automaticamente pelos dados do ticket/cliente no envio. O conteúdo não pode ficar vazio. *** ## Onde posso usar? O atendente pode utilizar o modelo de resposta em dois contextos: * **Na aba de mensagens →** ao responder um ticket em andamento. * **Na hora de fechar o ticket →** ao enviar a mensagem de encerramento ao cliente.

Esse recurso funciona como um atalho de comunicação inteligente, unindo velocidade, padronização e personalização tanto durante o atendimento quanto no encerramento do ticket.

# SLA Source: https://agile-docs.3code.com.br/ticket/sla O SLA (Service Level Agreement) no sistema define prazos e metas para o atendimento e a conclusão de tickets, garantindo que cada solicitação seja tratada dentro de um tempo previamente estabelecido. Esses prazos são definidos com base na prioridade do assunto ao qual o ticket está vinculado, permitindo que chamados mais urgentes recebam tratamento mais rápido e eficiente. ## Como funciona O SLA é aplicado a todos os tickets a partir do momento em que são criados, considerando: * **SLA de Atendimento** — Tempo máximo para iniciar o atendimento após a abertura do ticket. * **SLA de Conclusão** — Tempo máximo para encerrar e resolver o ticket * **Prioridade do Assunto** — Alta, Média ou Baixa, influenciando diretamente os prazos. *** ## Formas de Configuração O SLA pode ser definido de duas maneiras: ### Na criação do assunto

* O SLA pode ser inserido manualmente no momento em que o assunto é criado. * Se já houver um SLA padrão configurado para a prioridade escolhida, ele será preenchido automaticamente, podendo ser alterado. ### Nas configurações do Módulo

* É possível configurar valores padrão de SLA para cada prioridade (**Alta, Média, Baixa**) na aba de Configurações de SLA. * Esses valores serão utilizados automaticamente na criação de novos assuntos. *** ## Vencendo em breve O sistema permite definir um percentual do SLA para identificar quando um ticket está próximo do prazo de atendimento ou conclusão. Quando esse percentual é atingido: * **A data/hora limite do SLA** exibida no ticket muda para **laranja**, chamando a atenção do atendente. * Essa mudança pode ocorrer tanto para o **SLA de Atendimento** quanto para o **SLA de Conclusão**, dependendo do status do ticket. Se o percentual estiver configurado como **80%** e o SLA de conclusão for **10 horas**, a data/hora de conclusão exibida no ticket ficará **laranja** a partir da **8ª hora** do prazo.

*** ## Regras de Pausa e Retomada O sistema pausa automaticamente a contagem do SLA em situações específicas para evitar que o tempo corra enquanto o ticket aguarda ação do solicitante ou esteja encerrado. **Pausa do SLA** ocorre quando: * O atendente envia uma solicitação de **Pedir atenção** ao usuário. * O ticket é **fechado**. **Retomada do SLA** ocorre quando: * O usuário responde à solicitação de **Pedir atenção**. * O ticket é **reaberto**. *** ## Fluxos de Pausa de SLA O sistema oferece **três fluxos** diferentes para pausa do SLA, permitindo flexibilidade no gerenciamento dos prazos: ### 1. Pausa nativa no fechamento O SLA pausa automaticamente quando o ticket é fechado e entra no status **"Aguardando avaliação do solicitante"**. Esse é o fluxo nativo do sistema e não requer configuração adicional. *** ### 2. Pausa configurável - Pedir atenção É possível configurar o sistema para pausar o SLA quando o atendente solicita a interação do cliente através da funcionalidade **"Pedir atenção"**. Para ter acesso a essa configuração, você precisa da permissão **"Visualizar tela de Meus módulos - Ticket"**. Para saber mais sobre a configuração do módulo de ticket, clique **[aqui](/ticket/module-settings)**. **Para ativar:** 1. Acesse: **Configurações** → **Meus módulos** → **aba Tickets** 2. Ative a flag para pausar o SLA quando houver uma solicitação de interação do cliente *** ### 3. Pausa por estágios do departamento Na criação dos **estágios do departamento**, você pode definir se o SLA será pausado em determinados estágios. Isso permite criar um fluxo de atendimento personalizado para sua equipe. Ao criar um estágio no departamento, você pode marcar a opção **"Pausa SLA?"**. Quando um ticket é movido para esse estágio, o SLA é automaticamente pausado até que o ticket seja movido para outro estágio. Você pode criar quantos estágios precisar e definir individualmente quais deles pausam o SLA. Para saber mais sobre como criar estágios no departamento, clique **[aqui](/ticket/department#estágios)**. # Assuntos Source: https://agile-docs.3code.com.br/ticket/subject Como funcionam os assuntos do módulo de ticket? ## Visão geral Assunto é o título ou uma descrição breve do problema registrado pelo usuário ao abrir um ticket no sistema Agile. Ele serve para identificar rapidamente o tema principal do chamado, facilitando o entendimento e a priorização pela equipe responsável.

*** ## Como criar um novo assunto

Clique no botão **[Criar Novo](/general/create)** no canto superior direito da tela principal. * Se o assunto será ativo ou inativo. * Se necessita de aprovação. * Departamento responsável. Para saber mais sobre departamentos, clique **[aqui](/ticket/department)**. * Categoria do assunto. Para saber mais sobre categorias, clique **[aqui](/ticket/category)**. * Prioridade do assunto. * SLA de conclusão e de atendimento. * Nome do assunto. * Descrição do assunto. * Outras categorias (até 3 categorias adicionais, além da principal). * Empresas (em ambientes com múltiplas empresas). * Questionário vinculado (formulário dinâmico exibido ao abrir o ticket). * Se o assunto **não permite encaminhamento**. * Se **permite informar a data de SLA na abertura** do ticket. Você pode preencher o nome e a descrição do assunto em Português, Inglês ou Espanhol. *** ## Configurando um Assunto A tela de detalhes do assunto exibe informações básicas, como nome, descrição, status e etc. Ela pode ser acessada ao clicar no ícone de detalhes na lista de assuntos. ### Detalhes do assunto

Ao clicar no ícone de detalhes, você será redirecionado para a tela de detalhes do assunto. ### Dados básicos

Nesta seção, você pode visualizar e editar as informações básicas do assunto, como nome, descrição, status e outros detalhes relevantes. ### Configurações por cliente

Nesta seção, você pode definir SLAs personalizados com base nas necessidades específicas de cada cliente, ajustando os tempos de resposta e resolução de tickets. ### Equipes permitidas Defina quais **equipes** podem atender este assunto. Apenas os membros das equipes permitidas poderão ser responsáveis pelos tickets criados com ele. # Equipes Source: https://agile-docs.3code.com.br/ticket/teams Crie e gerencie equipes para organizar usuários e controlar o acesso aos departamentos. As **equipes** funcionam como um agrupamento de usuários dentro do sistema. Em vez de vincular membros individualmente a cada departamento, você pode adicioná-los a uma equipe e depois associar essa equipe aos departamentos desejados. Esse modelo facilita o gerenciamento de permissões, comunicação e acesso aos tickets. *** ## Lista de equipes A lista exibe todas as equipes cadastradas no sistema, permitindo visualizar, criar, editar ou excluir equipes conforme a necessidade da organização.

*** ## Como criar uma nova equipe Para adicionar uma nova equipe, clique no botão **[Criar Novo](/general/create)**. Um formulário será exibido para o preenchimento das informações da equipe.

No formulário de criação, informe:

Nome da equipe (obrigatório)
E-mail da equipe (opcional)

O e-mail da equipe será utilizado como um **e-mail de grupo**, permitindo que todos os membros da equipe recebam as mensagens enviadas para esse endereço. *** ## Como funcionam as equipes Uma equipe pode ser entendida como um **pacote de pessoas**. Todos os membros adicionados a ela herdam o acesso aos tickets dos departamentos aos quais a equipe estiver vinculada. O vínculo de acesso acontece sempre entre equipe e departamento, nunca diretamente entre usuário e departamento. *** ## Detalhes da equipe A tela de detalhes da equipe exibe as informações principais e permite gerenciar seus dados e membros. Ela pode ser acessada ao clicar no ícone de detalhes na lista de equipes. ### Detalhes da equipe

Ao clicar no ícone de detalhes, você será redirecionado para a tela de detalhes da equipe. ### Dados básicos

Nesta seção, você pode editar o nome da equipe, o e-mail e as empresas às quais a equipe pertence (em ambientes com múltiplas empresas). Para realizar alterações, clique em Editar e, após concluir, em Confirmar. Também é possível excluir a equipe clicando em [Excluir](/general/delete). O sistema solicitará uma confirmação antes de concluir a exclusão. ### Membros da equipe

Nesta seção, é possível adicionar ou remover membros da equipe. Ao adicionar um usuário, ele passará automaticamente a fazer parte da equipe e terá acesso aos tickets dos departamentos vinculados a ela. *** ## Equipes e departamentos Ao vincular uma equipe a um departamento, todos os seus membros passam a ter acesso aos tickets desse departamento. No **departamento**, é possível definir se o acesso do membro será somente leitura ou não.\ Já na **equipe**, não existe esse tipo de permissão: se o usuário faz parte da equipe, ele poderá acessar os tickets do departamento ao qual a equipe estiver vinculada. As permissões são configuradas no departamento, não na equipe. *** ## Tipos de vínculo da equipe com o departamento

Ao configurar um departamento, é possível definir como as equipes se relacionam com ele. Essas opções variam de acordo com o **tipo do departamento**. ### Equipe de atendimento É a equipe responsável por **receber os e-mails** enviados para o departamento e atuar diretamente no atendimento dos tickets. Essa configuração está disponível **para todos os tipos de departamento**. ### Equipes permitidas São as equipes que possuem permissão para **abrir chamados** nesse departamento. A opção Equipes permitidas está disponível apenas para departamentos internos. Para **departamentos externos**, não é possível definir equipes permitidas. Nesse caso, apenas a **equipe de atendimento** pode ser configurada. Departamentos externos aceitam somente equipe de atendimento. # TimeSheet (Apontamentos) Source: https://agile-docs.3code.com.br/ticket/timesheet Registre o tempo gasto nos chamados e acompanhe tudo em um relatório consolidado. ## Visão geral O **TimeSheet** registra o **tempo gasto** em cada chamado. Os apontamentos são feitos **dentro do ticket** e podem ser consultados de forma consolidada no **relatório de TimeSheet**. *** ## Apontar horas no ticket Dentro do detalhe de um ticket **em andamento**, a aba **Apontamentos** mostra o **total de horas gastas** e a lista de apontamentos. Clique em **Criar Novo**, informe uma **descrição** (opcional) da atividade e clique em **Iniciar** — a contagem começa em tempo real. Quando terminar, clique em **Fechar** no apontamento. O sistema registra **início**, **fim** e calcula a **duração** automaticamente. A tabela de apontamentos mostra **título**, **início**, **fim**, **total de horas usadas**, **criado por** e o **status** (Concluído). A aba **Apontamentos** só fica disponível quando o ticket está **em andamento** e o usuário tem a permissão necessária para iniciar apontamentos. *** ## Relatório de TimeSheet A tela **TimeSheet** (relatório) consolida os apontamentos de vários chamados. **Filtros** — é obrigatório informar um **período** (máx. 92 dias) **ou** o **código do chamado**. Opcionalmente, refine por **cliente**, **usuário**, **departamento** e **assunto**. **Colunas** — Chamado, Cliente, Departamento, Assunto, Usuário, Atividade, Descrição, Início, Fim e Duração. Use o botão **Exportar** para baixar o relatório em planilha (com as colunas acima). # Para atendentes Source: https://agile-docs.3code.com.br/ticket/user-internal Como funciona o uso de um usuário interno no sistema de tickets? ## O que é um usuário interno? No sistema, **usuários internos são os atendentes** responsáveis por visualizar, responder e gerenciar os tickets enviados pelos clientes. # Overview do atendente

O overview do atendente, por outro lado, traz uma visão mais completa e estratégica dos tickets. Além dos status, ele inclui indicadores operacionais e gráficos que ajudam no acompanhamento das demandas recebidas pelos departamentos. Atendentes têm acesso a mais detalhes sobre os tickets, podendo filtrar informações, identificar prioridades e agir com mais eficiência no atendimento. *** ## Como abrir um ticket sendo usuário interno

Clique no botão **[Criar Novo](/general/create)** no canto superior direito da tela principal. Tickets internos são usados entre equipes, e os externos, para demandas com clientes. Em ambos os casos, você pode abrir o ticket em nome de um cliente — mas, se for externo, não será possível selecionar um departamento da empresa.

Atenção: se os horários do departamento não estiverem configurados, você verá o seguinte erro ao abrir um ticket: **"Horário de atendimento não configurado"** Para saber mais sobre a configuração do departamento e ajustar os horários, clique aqui. *** ## Como atender um ticket

A ação altera o status do ticket para **Em atendimento** e habilita recursos específicos para que o usuário interno conduza o atendimento, além de liberar outras funcionalidades relacionadas à gestão do ticket.

Esta aba exibe o histórico de mensagens do ticket. Use este espaço para se comunicar com o solicitante, enviar atualizações, responder dúvidas e anexar arquivos quando necessário.

Você pode enviar uma mensagem interna ou uma mensagem direcionada ao solicitante. Caso solicite a interação dele, o SLA será pausado até que haja uma resposta.

Para fechar o ticket, clique no botão **Mais opções** e selecione **Fechar ticket**. Um formulário será exibido para você confirmar as informações de encerramento. Essa ação indica que o atendimento foi concluído. O cliente será notificado, poderá avaliar o atendimento e, se necessário, reabrir o ticket caso o problema não tenha sido resolvido.

Após o fechamento do ticket, o SLA de conclusão será pausado e só voltará a contar caso o cliente reabra o chamado. Se quiser saber mais sobre SLA, clique **[aqui](/ticket/sla)** *** ## Mais opções Ao iniciar o atendimento, o botão **Mais opções** será exibido, oferecendo novas funcionalidades para o usuário interno.

*** ### Ticket filho É uma solicitação que está vinculada a outro ticket principal, chamado de **ticket pai**. Ele é utilizado para dividir ou detalhar demandas dentro de um mesmo contexto, permitindo o acompanhamento separado de atividades específicas sem perder a relação com o ticket original. Toda a movimentação e resolução do ticket filho podem impactar ou depender do ticket pai, garantindo rastreabilidade e organização no atendimento. Nesta tela, o usuário pode preencher as informações necessárias para abertura de um ticket filho, vinculando-o a um ticket pai existente. O formulário segue o mesmo padrão de usabilidade dos demais tickets, garantindo consistência na experiência.

No topo da tela de detalhes, é exibido um destaque com o número do ticket pai, facilitando a identificação da solicitação principal — como no exemplo mostrado com o número **#3CODE-360**. Isso garante que o relacionamento entre os tickets esteja sempre visível para o usuário.

No ticket exibido, há dois campos distintos de SLA relacionados à conclusão: * **SLA de conclusão:** corresponde ao prazo definido para o ticket pai, ou seja, o chamado principal. * **SLA de conclusão (Original):** representa o SLA do ticket filho, criado a partir do ticket pai. Essa diferenciação permite acompanhar individualmente os prazos de cada ticket, garantindo que o controle de tempo e cumprimento dos SLAs seja mantido tanto no nível principal quanto nos subtickets derivados. Na aba de Tickets Filhos, o grid exibe todas as solicitações filhas relacionadas ao ticket pai. O contador exibido no topo dessa aba mostra quantos tickets ainda estão pendentes, oferecendo uma visão rápida do andamento e facilitando o gerenciamento das tarefas.

Ao encerrar um ticket filho, o sistema oferece a opção de abrir um novo ticket, conhecido como **ticket irmão**. Essa funcionalidade é útil quando você precisa continuar o atendimento ou criar uma nova demanda relacionada ao ticket pai, mantendo a rastreabilidade entre eles.

Na criação do ticket irmão, você tem a possibilidade de definir um novo prazo, substituindo o SLA atual conforme a necessidade do atendimento. Se quiser entender melhor sobre **SLA**, clique **[aqui](/ticket/sla)**. Ao criar um ticket filho para parceiro, o sistema permite vincular o ticket a um departamento de outra organização parceira, desde que haja uma API Key configurada para essa integração. A API Key deve estar previamente cadastrada na configuração do módulo, associando a organização parceira à sua plataforma. Com essa configuração, durante a criação do ticket filho, será possível visualizar e selecionar os departamentos disponíveis na organização parceira, garantindo que o ticket seja direcionado corretamente conforme a necessidade do atendimento. Se quiser entender melhor como **Configurar o módulo**, clique **[aqui](/ticket/module-settings#organizações-vinculadas)**.

*** ### Alterar estágio A funcionalidade de troca de estágio permite alterar a etapa em que um ticket se encontra dentro do fluxo de atendimento do departamento. Os estágios representam as etapas personalizadas criadas pelo próprio departamento, organizando o processo desde a abertura até o encerramento do ticket. Essa ação está disponível **apenas para o usuário que abriu o ticket e possui permissão para alterar o estágio, ou para usuários com perfil de Supervisor**. Além disso, a troca só estará disponível caso o departamento tenha estágios configurados em seu fluxo. Quando há estágios definidos, é possível mover o ticket entre essas etapas conforme o andamento do atendimento, garantindo que os processos internos sejam seguidos corretamente. A troca de estágio é uma forma de registrar e visualizar o progresso do ticket, facilitando o controle das demandas e a comunicação entre os membros da equipe. Se quiser saber mais sobre configuração do departamento, clique **[aqui](/ticket/department#configurando-um-departamento)**.

*** ### Alterar responsável A troca de responsável de um ticket só pode ser realizada em situações específicas. Essa ação está disponível apenas para o usuário que abriu o ticket e possui **permissão para alterar o responsável**, ou para **usuários com perfil de Supervisor**. Além disso, a alteração só é permitida quando o ticket já estiver com o atendimento iniciado, ou seja, no status **“Em Atendimento”**. Caso seja necessário **alterar responsáveis de múltiplos tickets de forma simultânea**, existe a funcionalidade de troca de responsável em massa, que permite realizar essa ação de maneira prática e rápida. Se quiser saber mais sobre a troca de responsável em massa, clique **[aqui](/ticket/migration)**.

*** ## Ticket pendente de aprovação Usuários que possuem permissão para aprovar ou rejeitar tickets terão acesso a uma nova **widget de "Aguardando aprovação" no overview do sistema**. Nela, é possível visualizar rapidamente todas as solicitações que aguardam uma ação de aprovação. A necessidade de aprovação em um ticket está vinculada ao Assunto selecionado no momento da abertura. Quando um assunto é configurado como “Necessita de Aprovação”, qualquer ticket aberto com esse assunto será automaticamente direcionado para o status Aguardando aprovação, aguardando validação por um responsável. Essa configuração é importante para garantir que certas solicitações passem por uma análise ou autorização antes de seguirem para atendimento. Se quiser saber mais sobre configuração do assunto, clique **[aqui](/ticket/subject#configurando-um-assunto)**. Aprovar um ticket é a ação que valida a solicitação feita, permitindo que o atendimento siga para as próximas etapas. Em muitos fluxos, certos tickets precisam passar por uma análise ou autorização antes de serem atendidos (como aprovação de um gerente ou responsável). Após a aprovação, o ticket será automaticamente atualizado para o **status Pendente**, permitindo o seguimento normal do atendimento pela equipe responsável.

*** ## Como encaminhar um ticket

A funcionalidade permite ao usuário interno transferir o atendimento para outro departamento, conforme a natureza do chamado. Essa opção é exibida apenas para usuários internos. Para tickets internos, o encaminhamento estará disponível somente para departamentos internos; já para tickets externos, apenas departamentos externos poderão ser selecionados. Essa ação facilita o direcionamento adequado do ticket, garantindo que ele seja tratado pela equipe responsável.

*** ## Logs A aba de logs exibe o histórico completo de interações do ticket. Nela é possível visualizar todas as ações realizadas, como alterações de status, movimentações, mensagens enviadas, edições e responsáveis envolvidos. Essa visualização ajuda no acompanhamento e auditoria do atendimento.

*** ## Tela de atividades As atividades servem para **organizar e dividir o atendimento do ticket em tarefas menores**, facilitando o gerenciamento e acompanhamento do trabalho. Em vez de lidar com um ticket grande e complexo, você pode criar múltiplas atividades específicas, cada uma com seu responsável, prazo e descrição detalhada. Esta funcionalidade é exclusiva para **usuários internos** que possuam permissão de visualizar calendário. As duas telas se integram, permitindo uma gestão completa das tarefas relacionadas ao ticket. Se quiser saber mais sobre o calendário, clique **[aqui](/organization/calendar)** Na tela de atividades, o usuário pode criar e gerenciar tarefas detalhadas atribuindo: * **Responsável** pela atividade * **Participantes** que irão colaborar na tarefa * **Descrições** detalhadas sobre o que precisa ser feito * **Anotações** adicionais para contexto e orientações * **URL da reunião** para videoconferências integradas

O grid exibe todas as atividades criadas para o ticket, permitindo visualização rápida do status, responsáveis e prazos de cada tarefa.

Quando uma atividade é adicionada através do ticket, ela aparece no calendário com uma cor específica **verde**, permitindo fácil identificação visual das tarefas vinculadas aos tickets.

A cor verde no calendário ajuda a diferenciar visualmente as atividades que foram criadas a partir de tickets, enquanto atividades criadas manualmente através do próprio calendário aparecem em roxo. ### Marcando Atividades como Concluídas Para marcar uma atividade como concluída, simplesmente clique no checkbox da tarefa. Uma vez marcada, a atividade aparecerá com o indicador de conclusão (✓) visualmente no card de atividades.

O gerenciamento completo das atividades e sua visualização detalhada podem ser feitos através da tela de calendário, onde todas as tarefas são organizadas e exibidas de forma ampla. *** ## Contador de Horas O contador de horas permite que o **usuário interno** com a permissão adequada registre e controle o tempo dedicado ao atendimento de um ticket. Esta funcionalidade é essencial para mensurar o esforço aplicado em cada solicitação e manter um controle preciso do tempo de atendimento. Enquanto o ticket está em atendimento, o usuário pode: * Registrar o tempo total dedicado ao atendimento * Adicionar anotações sobre o período trabalhado * Controlar o acúmulo de horas ao longo do processo * Visualizar o histórico de tempo registrado

O sistema mantém um registro detalhado de todo o tempo registrado, permitindo análise posterior do desempenho e planejamento de capacidade da equipe.

O contador de horas é uma ferramenta importante para gestão de tempo e análise de produtividade da equipe de atendimento. *** ## Outras abas e ações do ticket Além das abas já citadas, o detalhe do ticket pode oferecer: * **Questionário** — quando o assunto do ticket tem um **formulário dinâmico** vinculado, esta aba permite preenchê-lo diretamente no ticket. Veja **[Questionários Dinâmicos](/ticket/questionnaires)**. * **Projetos** — vincula e exibe os **projetos** relacionados ao ticket (conforme permissão). * **Compartilhamento público** — gera um link para compartilhar o ticket externamente, sem necessidade de login. Na aba de **mensagens**, é possível alternar entre uma **nota interna** (visível apenas para a equipe) e uma **interação** com o cliente — esta última pode pausar o SLA, conforme a configuração do módulo. # Solicitações de autenticação Source: https://agile-docs.3code.com.br/vault/auth-requests Acompanhe o histórico de tentativas de uso das credenciais do cofre. ## Visão geral Toda vez que uma credencial é utilizada, o cofre registra uma **solicitação de autenticação**. Esta tela reúne esse histórico para auditoria e diagnóstico. Solicitações de autenticação - tema claro

Solicitações de autenticação - tema claro

Solicitações de autenticação - tema escuro

Cada linha mostra o **status**, a **credencial** utilizada, o **site** acessado e os horários de **início** e **conclusão**. *** ## Status possíveis * **Pendente** — solicitação criada, aguardando processamento. * **Processando** — o acesso está sendo executado. * **Sucesso** — autenticação concluída com êxito. * **Falhou** — ocorreu um erro durante o processo. * **Credenciais inválidas** — usuário/senha ou certificado não foram aceitos pelo site. Use **[Filtrar](/general/filter)** para refinar por sites, credenciais, status e período. *** ## Detalhes da solicitação Ao abrir uma solicitação, a aba **Informações** mostra os dados completos (status, credencial, site, quem criou e os horários), uma eventual **mensagem** de erro/retorno e a lista de **eventos de navegação** — o passo a passo do que aconteceu durante a tentativa de acesso. # Credenciais Source: https://agile-docs.3code.com.br/vault/credentials Cadastre e gerencie as credenciais (usuário/senha ou certificado) armazenadas no cofre. ## Visão geral A tela de **Credenciais** lista tudo o que está guardado no cofre. Cada linha mostra o **status**, o **tipo**, o **nome**, o **código da credencial**, se **permite acesso simultâneo** e quem a **criou**. Lista de credenciais - tema claro

Use **[Filtrar](/general/filter)** para refinar por nome, status, data de expiração, site ou usuário. *** ## Como criar uma credencial Clique em **[Criar Novo](/general/create)** no canto superior direito. * **Ativo?**: define se a credencial já entra em uso (padrão: ativada). * **Permitir acesso simultâneo?**: libera o uso por vários usuários ao mesmo tempo (padrão: desativado). * **Tipo**: **Usuário e Senha** ou **Certificado A1**. * **Nome**: identificação da credencial. * **Usuário** (tipo Usuário e Senha): login da credencial. * **Certificado** (tipo Certificado A1): arquivo `.pfx`. * **Senha**: senha da credencial ou do certificado. Clique em **Confirmar** para salvar. *** ## Detalhes da credencial Ao abrir uma credencial, você encontra três abas: Visualize e edite nome, status e acesso simultâneo. O **tipo** e o **usuário/certificado** não podem ser alterados após a criação. Aqui também é possível **excluir** a credencial. Defina **em quais sites** e por **qual método** (Acesso Direto, Azure AD ou GOV.BR) a credencial pode ser usada, e configure **MFA** quando aplicável. Os sites disponíveis variam conforme o método e o tipo de credencial. Libere o uso da credencial para **usuários específicos**, escolhendo os sites e aplicando restrições de **dias da semana**, **horário** e **data de expiração**. É possível **simular um acesso** para validar a configuração. Os métodos de autenticação compatíveis dependem do tipo de credencial: **Usuário e Senha** suporta Acesso Direto, Azure AD e GOV.BR; **Certificado A1** suporta Acesso Direto e GOV.BR. O MFA está disponível em Acesso Direto e Azure AD. # Cofre de Senhas Source: https://agile-docs.3code.com.br/vault/i Armazene credenciais com segurança e controle quem pode usá-las, onde e quando. ## Visão geral O **Cofre de Senhas (Vault)** centraliza o armazenamento seguro de credenciais da sua organização — usuários e senhas ou certificados — e controla **quem** pode utilizá-las, **em quais sites** e **sob quais condições**. Assim, ninguém precisa conhecer a senha em si para acessar um sistema: o acesso é mediado e auditado pelo Vault. A tela inicial (**Overview**) reúne indicadores rápidos — **credenciais ativas**, **credenciais a expirar**, **autenticações do dia** e **falhas do dia** — além de um gráfico com o volume de solicitações de autenticação por período. Overview do Cofre de Senhas - tema claro

Overview do Cofre de Senhas - tema claro

Overview do Cofre de Senhas - tema escuro

*** ## Conceitos principais A senha ou o certificado armazenado no cofre. Cada credencial tem um **tipo** (Usuário e Senha ou Certificado A1), um **status** (ativa/inativa) e pode permitir ou não **acesso simultâneo** por vários usuários. Autoriza o uso de uma credencial **em um site específico** por um **método de autenticação** (Acesso Direto, Azure AD ou GOV.BR). Pode exigir **MFA** (autenticação multifator). Uma mesma credencial pode ter vários acessos. Autoriza um **usuário específico** a usar uma credencial em determinados sites, com **restrições opcionais** de dias da semana, horário e data de expiração. O registro de cada tentativa de uso de uma credencial: qual credencial, qual site, o **status** (pendente, processando, sucesso, falhou) e os eventos de navegação. Serve para auditoria e diagnóstico. *** ## Fluxo de uso típico Crie a credencial no cofre (usuário/senha ou certificado A1). Veja **[Credenciais](/vault/credentials)**. Defina em quais sites e por qual método a credencial pode ser usada (aba **Acessos** da credencial). Libere o uso para usuários específicos, com restrições de horário e validade (aba **Concessões**). Monitore as tentativas de acesso em **[Solicitações de autenticação](/vault/auth-requests)**.