# O acesso do suporte da Cademí

> O que o suporte da Cademí vê na sua conta ao atender um chamado, como ele pede para alterar algo e onde você confere o que ele fez.

Quando você abre um chamado, o suporte da Cademí pode precisar olhar a sua plataforma. O suporte só **lê**. Para **alterar** qualquer coisa, ele pede a sua autorização no painel, e você decide. Tudo fica registrado.

## A ideia em um minuto

O suporte da Cademí usa uma chave de acesso da sua conta, a **Suporte Cademí**. Ela tem duas partes:

- A **leitura** está sempre ligada. O suporte vê o mesmo que já vê no painel da sua conta. Cada acesso tem início e fim e dura no máximo 24 horas.
- A **escrita** começa desligada. Só você liga a escrita, por um período ou para uma alteração específica.

**A regra mais importante:** sem a sua liberação, o suporte não altera nada. A aba **Permissões** da chave diz isso com todas as letras: **Nenhuma escrita liberada. O suporte só lê.**

A chave fica em **Configurações > Chaves de API**, com a explicação: **Chave do suporte da Cademí, criada pelo sistema. Ela só é usada quando um técnico abre um chamado de suporte, sempre com registro de quem acessou e por quê. Por padrão só lê; a escrita depende da sua liberação.**

| | Leitura | Alteração |
|---|---|---|
| Quem decide | A Cademí, ao atender um chamado | Você, pelo aviso na página **Início** ou pela aba **Permissões** da chave |
| Duração | Cada acesso tem início e fim, e dura no máximo 24 horas | O tempo que você autorizar, ou uma aplicação única |
| O que inclui | O mesmo que o suporte já vê no painel da sua conta. Não se edita | Só o que o pedido descreve |
| Onde fica registrado | **Atividade** da chave: quem, quando, quantas alterações e, quando informados, o motivo e o chamado | **Atividade** da chave e a atividade do administrador que autorizou |

## Como o suporte pede autorização

Quando o suporte pede autorização, a página **Início** abre com o aviso **O suporte da Cademí precisa da sua autorização**. O aviso fica acima de tudo, com o selo **Pedido do suporte**. Ao lado, **Vence** mostra o prazo do pedido.

- O aviso aparece para os administradores que podem gerenciar as chaves de API da conta.
- Ele aparece só enquanto o pedido está pendente.
- Não chega e-mail. O aviso é o único alerta.

Há dois tipos de pedido.

### Autorização por um período

O suporte pede para alterar um conjunto de coisas por um tempo. O aviso mostra:

- **O que o suporte vai poder fazer**: o conjunto. Os conjuntos são:
  - **Gestão de conteúdo**: produtos, aulas, vitrines e banners;
  - **Gestão de alunos**: alunos, matrículas, tags e progresso;
  - **Vendas e matrículas**: entregas, eventos de venda e acessos;
  - **Configurações**: configurações, e-mails, código personalizado e campos do perfil;
  - **Acesso total**: tudo, menos administradores e chaves.
- **Por quanto tempo**: **24 horas**, **3 dias** ou **7 dias**, com a data e a hora em que termina.
- **Motivo**: o texto de quem pediu.
- **Chamado**: o número do seu chamado, quando o pedido tem um.
- **Quem pediu**: o nome da pessoa do suporte.

Você tem dois botões:

- **Autorizar por 24 horas** (ou pelo prazo pedido) libera a alteração até aquela data.
- **Recusar** encerra o pedido.

A nota abaixo dos botões lembra: **Você pode retirar a autorização a qualquer momento.** O link **Ver acessos e pedidos** abre a aba **Atividade** da chave **Suporte Cademí**.

### Uma alteração específica

O suporte prepara e testa uma alteração. Depois, ele pede para aplicar. O aviso diz: **O suporte da Cademí testou esta alteração e pede para aplicá-la na sua plataforma. Ao aprovar, ela é aplicada uma vez, exatamente como abaixo, e o acesso de escrita termina junto.**

O aviso mostra:

- **O que muda**, com o número de passos. Cada passo diz a ação: **Criar**, **Editar** ou **Excluir**. Ele também diz o item, como um produto, uma aula, um webhook ou uma configuração. Numa edição, cada campo aparece com o valor atual e o novo.
- **Permissões usadas só nesta aplicação**: as permissões que a alteração exige, e nada além.
- **Motivo**, **Chamado** e **Quem pediu**, como no outro tipo.

Você tem dois botões:

- **Aprovar e aplicar** aplica aquela lista na hora, uma vez só. O acesso de escrita termina junto. A tela confirma: **Alteração aprovada. Aplicando agora.**
- **Recusar** encerra o pedido.

Sua plataforma pode mudar entre o pedido e a aprovação. Nesse caso, nada é aplicado e a tela avisa: **A plataforma mudou desde o pedido, e nada foi aplicado. O suporte vai enviar o pedido de novo.**

## Liberar ou retirar a escrita você mesmo

Você pode liberar a escrita sem esperar um pedido. Você também pode retirar uma autorização antes do prazo.

### Liberar a escrita

1. Abra **Configurações > Chaves de API**.
2. Clique na chave **Suporte Cademí**.
3. Vá à aba **Permissões**.
4. Em **Liberar escrita para o suporte**, escolha o conjunto em **O que o suporte pode alterar**. Os conjuntos são os mesmos da lista acima.
5. Em **Por quanto tempo**, escolha **24 horas**, **3 dias** ou **7 dias**.
6. Clique em **Liberar escrita**.

Cada liberação vigente mostra **Liberada por**, com o nome de quem liberou e a data em que termina.

### Retirar a escrita

1. Na mesma aba **Permissões**, encontre a liberação.
2. Clique em **Retirar**.

A escrita termina na hora. A leitura continua. Uma liberação vencida fica na lista com **venceu em** e a data.

Logo abaixo, **O que o suporte sempre pode ler** lista as permissões de leitura da chave. Elas não se editam: **A leitura é a mesma que o suporte já tem no painel e não se edita. Cada acesso fica registrado com quem abriu e por qual chamado.**

### Os dois caminhos juntos

A escrita do suporte passa por estas situações. É um resumo didático: a leitura vale o tempo todo, e só você abre a escrita.

```mermaid
stateDiagram-v2
    accTitle: Quando o suporte pode alterar a sua conta
    accDescr: O suporte começa só lendo. Você pode liberar a escrita direto na aba Permissões ou responder a um pedido do suporte. Um pedido recusado ou vencido volta a só leitura. Autorizar um pedido por período, ou liberar você mesmo, abre a escrita até você retirar ou o prazo terminar. Aprovar uma alteração específica a aplica uma vez e a escrita termina junto.
    state "Só leitura" as Leitura
    state "Pedido pendente" as Pedido
    state "Escrita liberada" as Liberada
    state "Aplicando a alteração" as Aplicando
    [*] --> Leitura
    Leitura --> Pedido: Suporte pede autorização
    Leitura --> Liberada: Você clica em Liberar escrita
    Pedido --> Leitura: Recusar ou o pedido vence
    Pedido --> Liberada: Autorizar por um período
    Pedido --> Aplicando: Aprovar e aplicar
    Liberada --> Leitura: Retirar ou o prazo termina
    Aplicando --> Leitura: Aplicação termina
```

Em qualquer situação, o suporte continua lendo. Cada passo fica na aba **Atividade** da chave.

## Onde ver o que o suporte fez

O que o suporte faz com a escrita fica ligado à liberação que você deu. Essa liberação vem do aviso da página **Início** ou da aba **Permissões**. Para conferir:

1. Abra **Configurações > Chaves de API**.
2. Clique na chave **Suporte Cademí**.

Depois, olhe as duas abas:

- **Na aba Permissões**, em **Liberar escrita para o suporte**, cada liberação mostra o conjunto. Em **Liberada por**, ela mostra o nome de quem liberou e até quando vale. Uma liberação que terminou mostra a data (**venceu em**).
- **Na aba Atividade**, a liberação aparece como **liberou escrita ao suporte**. A linha mostra o nome de quem liberou, o conjunto e **Vale até** com a data. Uma retirada aparece como **retirou a escrita do suporte**.

Os acessos do suporte feitos enquanto a liberação valia ficam na mesma lista. Cada acesso mostra:

- o nome de quem acessou;
- o início e o fim do acesso;
- o motivo e o chamado, quando informados;
- quantas alterações ele fez (**sem alterações** quando nenhuma).

Um acesso em andamento tem o selo **Acessando agora**.

A aba **Atividade** vai do mais recente para o mais antigo. Ela tem um filtro por tipo:

- **Acessos do suporte**: cada acesso, como descrito acima.
- **Pedidos de escrita do suporte**: cada pedido, com o motivo, o chamado e o status. Os status são **Pendente**, **Autorizado**, **Recusado**, **Cancelado pelo suporte** e **Vencido**. Nas alterações específicas, também **Aplicando**, **Aplicado**, **Falhou na aplicação** ou **Desatualizado**. Uma alteração específica aparece com o número de passos que tinha.
- **Alterações da chave**: as liberações e retiradas de escrita, com quem fez.

Liberar e retirar a escrita também entram na atividade do administrador que fez, em **Configurações > Administradores**.

## Bom saber

- **Só um pedido pendente por vez.** Se o suporte envia um pedido novo, o anterior é encerrado.
- **O pedido vence sozinho.** Um pedido vale por 3 dias. O aviso mostra quanto falta em **Vence** e some quando o prazo passa. O pedido fica na atividade como **Vencido**. Se a alteração ainda é necessária, o suporte pede de novo.
- **A alteração específica não precisa de acesso aberto.** Quem autoriza é você, e a aplicação vale por si. O suporte não precisa estar acessando a sua conta na hora.
- **Recusar não fecha o chamado.** O atendimento continua. O que muda é que o suporte não altera nada na sua conta.
- **A chave não se apaga nem se desliga pelo painel.** Ela é do sistema. O que você controla é a escrita.

## Perguntas frequentes

**Aprovei uma alteração. O suporte continua com acesso de escrita?** Não. Na alteração específica, a escrita termina quando a aplicação termina. Na autorização por período, ela termina na data mostrada. Ela também termina antes, se você clica em **Retirar** na aba **Permissões** da chave.

**Posso ver o que o suporte mudou?** Sim, a partir da liberação que você deu. Na aba **Atividade** da chave **Suporte Cademí**, a liberação mostra quem liberou, o conjunto e até quando valeu. Cada acesso feito nesse período mostra o motivo, o chamado e quantas alterações fez. Numa alteração específica, a lista do que muda, campo a campo, aparece no aviso antes de você aprovar. Depois, o pedido fica na atividade com o número de passos e o status final.

**O aviso apareceu e eu não abri chamado nenhum.** O aviso traz o **Motivo**, o **Chamado** e **Quem pediu**. Se você não reconhece o pedido, clique em **Recusar**. Depois, fale com o suporte da Cademí pelo widget de suporte dentro do painel.

**O suporte pode alterar algo sem eu saber?** Não. Para alterar, o suporte precisa de uma liberação sua. Toda liberação, todo acesso e todo pedido ficam na aba **Atividade** da chave.