# Alinhamento

Chame um membro para conversar com a equipe usando /alinhar, com prazo para aparecer na call ou abrir um ticket, e acompanhe tudo no painel.

Source: https://fivedash.fivex.gg/docs/pt/discord/alignment

O Alinhamento é o jeito da equipe chamar alguém da cidade para uma conversa. Com **/alinhar**, a staff marca o membro, escreve o motivo e dá um prazo. O bot posta um aviso no canal, manda uma DM e, se você quiser, dá um cargo de pendência. Quando a pessoa entra na sala de voz do alinhamento ou abre um ticket, a presença é marcada sozinha. Se o prazo acabar, o aviso fica vermelho e ela recebe outra DM. É para donos e staff que precisam de conversas com hora marcada, sem perder ninguém de vista.

## Antes de começar

* O módulo **Discord** precisa estar no plano da organização, no plano **Pro** ou **Ultra**. No Plus, a página do Alinhamento não abre.
* O bot da cidade precisa estar conectado ao servidor. Veja [Bot](https://fivedash.fivex.gg/docs/pt/discord/bot).
* Para a presença pela sala de voz ser marcada sozinha, o bot precisa estar recebendo eventos ao vivo. Se não estiver, a página avisa; abrir ticket e marcar presença pelo painel continuam funcionando.
* Para a presença por ticket, configure o módulo [Tickets](https://fivedash.fivex.gg/docs/pt/discord/tickets).
* Se usar o **Cargo de pendência**, o cargo do bot precisa ficar acima dele.

Nível de acesso no painel (área **Alinhamento**):

| Nível          | O que permite                              |
| -------------- | ------------------------------------------ |
| **Ver**        | Alinhamentos e números                     |
| **Gerenciar**  | Marcar presença, estender prazo e cancelar |
| **Configurar** | Comando, canais, salas e mensagens         |

## Ligar o alinhamento

### Abra o Alinhamento

No painel, vá em **Discord → Alinhamento** e abra a aba **Configurações**.

### Ligue o módulo

Ligue **Ligar o alinhamento**. Ele começa desligado.

### Defina a equipe e o prazo padrão

Em **Comandos**, escolha em **Quem pode usar** os cargos da equipe, o **Prazo padrão** e, se quiser, os **Cargos protegidos**.

### Escolha onde avisar

Em **Onde avisar**, escolha o **Canal do alinhamento**. É obrigatório.

### Escolha como a pessoa comparece

Em **Como comparecer**, escolha as **Salas de voz** e/ou deixe **Abrir ticket conta** ligado. Pelo menos um dos dois precisa valer.

### Salve

Clique em **Salvar** na barra de **Você tem alterações não salvas**.

## Como funciona um alinhamento

1. Alguém da equipe usa `/alinhar membro motivo prazo` no Discord. A resposta é privada.
2. O bot dá o **Cargo de pendência** (se houver), manda a DM, posta o aviso no **Canal do alinhamento** e registra no **Canal do registro** (se houver). O aviso fica **Aguardando**.
3. A pessoa comparece entrando em uma das **Salas de voz** ou abrindo um ticket (se **Abrir ticket conta** estiver ligado). A equipe também pode marcar com `/alinhado` ou pelo painel.
4. Ao comparecer, o aviso muda para **Compareceu**, o cargo de pendência sai e o registro é atualizado.
5. Se o prazo acabar antes, o aviso fica vermelho, a pessoa recebe a DM de **Prazo vencido** (se ligada) e o alinhamento fica **Não compareceu**. Ela ainda pode aparecer: aí fica **Compareceu · atrasado**.

Cada membro tem só um alinhamento aguardando por vez. Quem entra na sala de voz enquanto o bot reconecta também conta: o bot olha quem já está sentado lá.

## Os comandos no Discord

| Comando     | Opções                                                                              | O que faz                                                                           |
| ----------- | ----------------------------------------------------------------------------------- | ----------------------------------------------------------------------------------- |
| `/alinhar`  | `membro` (obrigatório), `motivo` (opcional, até 500 caracteres), `prazo` (opcional) | Chama o membro para um alinhamento. Sem `prazo`, vale o **Prazo padrão** do painel. |
| `/alinhado` | `membro` (obrigatório)                                                              | Marca o alinhamento em aberto do membro (aguardando ou vencido) como feito.         |

Quem pode usar: quem tem um dos cargos escolhidos em **Quem pode usar**. Administradores e quem tem **Gerenciar servidor** sempre podem. Sem cargos escolhidos, só eles usam.

O bot recusa `/alinhar` quando o módulo está desligado, quando o alvo é um bot, a própria pessoa ou tem um cargo protegido, e quando o membro já tem um alinhamento aguardando.

Prazos do `prazo`: 15 minutos, 30 minutos, 1 hora, 2 horas, 3 horas, 6 horas, 12 horas, 1 dia, 2 dias, 3 dias e 7 dias.

Veja todos os comandos do bot em [Comandos](https://fivedash.fivex.gg/docs/pt/discord/commands).

## Configurações

### Comandos

| Campo                 | O que faz                                                                                                 | Padrão                          |
| --------------------- | --------------------------------------------------------------------------------------------------------- | ------------------------------- |
| **Quem pode usar**    | Os cargos que podem usar /alinhar. Quem tem um desses cargos usa o /alinhar e o /alinhado. Até 25 cargos. | Nenhum (**Só administradores**) |
| **Prazo padrão**      | Quando a equipe não escolhe o prazo no comando. Mesmas opções do `prazo`.                                 | 2 horas                         |
| **Cargos protegidos** | Quem tem um desses cargos não pode ser chamado. Até 25 cargos.                                            | Nenhum                          |

### Onde avisar

| Campo                    | O que faz                                                                                                   | Padrão |
| ------------------------ | ----------------------------------------------------------------------------------------------------------- | ------ |
| **Canal do alinhamento** | O aviso público vai aqui e muda sozinho: aguardando, compareceu ou venceu. Obrigatório com o módulo ligado. | Nenhum |
| **Marcar o membro**      | O aviso notifica quem foi chamado. Desligado, o nome aparece sem notificar.                                 | Ligado |
| **Avisar por DM**        | A pessoa recebe o motivo e o prazo no privado, com os atalhos para a sala e o ticket.                       | Ligado |
| **Mostrar quem chamou**  | Coloca o nome de quem usou o /alinhar na DM.                                                                | Ligado |

### Como comparecer

| Campo                     | O que faz                                                                                                                                                             | Padrão             |
| ------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ------------------ |
| **Salas de voz**          | Entrar em uma delas conta como presença, na hora. A primeira vira o botão **Entrar na sala**. Até 5 salas.                                                            | Nenhuma            |
| **Abrir ticket conta**    | Abrir um ticket também conta como presença.                                                                                                                           | Ligado             |
| **Categorias que contam** | Só tickets dessas categorias contam. Sem escolher, qualquer categoria conta. Até 25. Se o módulo de tickets ainda não tem categorias, aparece **Configurar tickets**. | Qualquer categoria |

### Enquanto aguarda

| Campo                            | O que faz                                                                       | Padrão |
| -------------------------------- | ------------------------------------------------------------------------------- | ------ |
| **Cargo de pendência**           | Dado no /alinhar e tirado quando a pessoa aparece ou o alinhamento é cancelado. | Nenhum |
| **Avisar quando o prazo acabar** | Uma segunda DM lembra que o prazo passou e que ainda dá para resolver.          | Ligado |

### Registro no Discord

| Campo                 | O que faz                                                                                                     | Padrão        |
| --------------------- | ------------------------------------------------------------------------------------------------------------- | ------------- |
| **Canal do registro** | Cada alinhamento, presença, prazo vencido e cancelamento vira uma mensagem aqui. Sem canal: **Só no painel**. | Nenhum        |
| **Mensagens**         | Aviso no canal, DM e prazo vencido.                                                                           | Textos padrão |
| **Embed**             | Cores por situação, foto, servidor e botões.                                                                  | Veja abaixo   |

### Personalizar mensagens

| Aba                | Quando vai                                                                                                   |
| ------------------ | ------------------------------------------------------------------------------------------------------------ |
| **Aviso no canal** | Postado no canal do alinhamento. A situação (aguardando, compareceu, venceu) aparece embaixo e muda sozinha. |
| **DM**             | Vai no privado assim que o /alinhar é usado.                                                                 |
| **Prazo vencido**  | Vai no privado quando o prazo acaba e a pessoa ainda não apareceu.                                           |

Cada texto aceita até 1.500 caracteres e uma imagem opcional, larga (2:1), no fim da mensagem. O aviso no canal nunca pode ficar vazio; a DM e a de prazo vencido só podem ficar vazias se estiverem desligadas.

Variáveis:

| Variável     | O que mostra                                         |
| ------------ | ---------------------------------------------------- |
| `{membro}`   | Marca quem foi chamado (@Jogador)                    |
| `{nome}`     | O nome de quem foi chamado                           |
| `{servidor}` | O nome do servidor do Discord                        |
| `{motivo}`   | O motivo escrito no /alinhar                         |
| `{prazo}`    | Quanto falta ("em 2 horas"), atualizado pelo Discord |
| `{horario}`  | Dia e hora em que o prazo acaba                      |
| `{sala}`     | A primeira sala de voz do alinhamento                |
| `{equipe}`   | Quem usou o /alinhar                                 |
| `{caso}`     | O número do alinhamento (#012)                       |

Texto padrão do aviso no canal:

```text
### {{warning}} Alinhamento {caso}
{membro}, a equipe precisa conversar com você.
**Motivo:** {motivo}

Apareça na {sala} ou abra um ticket até **{horario}** ({prazo}).
```

### Personalizar embed

| Campo                                        | O que faz                                                         | Padrão    |
| -------------------------------------------- | ----------------------------------------------------------------- | --------- |
| **Cor** de **Aguardando**                    | O aviso e a DM enquanto o prazo corre.                            | `#F0B232` |
| **Cor** de **Compareceu**                    | O aviso depois que a pessoa aparece, e o registro.                | `#57F287` |
| **Cor** de **Venceu**                        | O aviso, a DM e o registro quando o prazo acaba.                  | `#ED4245` |
| **Foto do membro no aviso**                  | A foto de quem foi chamado no canto do aviso.                     | Ligado    |
| **Servidor no topo das DMs**                 | O nome e o ícone do servidor em cima das mensagens privadas.      | Ligado    |
| **Botões "Entrar na sala" e "Abrir ticket"** | Atalhos sob o aviso e as DMs, enquanto o alinhamento está aberto. | Ligado    |

Alinhamentos cancelados ficam cinza. A prévia mostra quatro vistas: **Aviso**, **DM**, **Venceu** e **Registro**.

## Acompanhar os alinhamentos

### Visão geral

A aba **Visão geral** mostra os **Alinhamentos** da semana, **Aguardando agora**, **Tempo até aparecer** (mediana), a taxa de quem **Compareceu no prazo**, o gráfico **Chamados e comparecimentos**, **Como apareceram** (sala de voz, ticket ou pela equipe), **Prazos correndo** (quem ainda precisa aparecer) e **Quem mais chama**.

### Registro

A aba **Registro** lista cada /alinhar. Os blocos no topo filtram por situação: **Aguardando**, **Compareceram**, **Não compareceram** e **Cancelados**. Busque por membro, equipe, motivo, ID ou número.

| Situação           | O que quer dizer                                                                                                     |
| ------------------ | -------------------------------------------------------------------------------------------------------------------- |
| **Aguardando**     | O prazo está correndo.                                                                                               |
| **Compareceu**     | A pessoa apareceu (pela sala de voz, pelo ticket ou marcada pela equipe). Com **· atrasado** se foi depois do prazo. |
| **Não compareceu** | O prazo acabou e ela ainda não apareceu. Ainda pode aparecer ou ter o prazo estendido.                               |
| **Cancelado**      | A equipe encerrou o alinhamento.                                                                                     |

## Mudar um alinhamento pelo painel

Precisa do nível **Gerenciar**. Abra o alinhamento em **Discord → Alinhamento → Registro** e use uma das ações:

| Ação                     | O que faz                                                                                                                                                                                                              |
| ------------------------ | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| **Marcar presença**      | Encerra como **Compareceu**, marcado por você. Use quando a conversa aconteceu de outro jeito.                                                                                                                         |
| **Estender prazo**       | Em **Mais tempo a partir do prazo**, escolha 30 minutos, 1 hora, 3 horas, 12 horas ou 1 dia. Se o prazo já passou, conta a partir de agora e o alinhamento volta para **Aguardando**. O aviso no Discord é atualizado. |
| **Cancelar alinhamento** | Pede **Por que cancelar (opcional)**. O aviso no canal fica cinza e o cargo de pendência sai.                                                                                                                          |

### Abra o alinhamento

Em **Discord → Alinhamento → Registro**, clique na linha do alinhamento.

### Estenda o prazo

Clique em **Estender prazo** e escolha quanto tempo a mais.

### Confira

Aparece **Prazo estendido em 1 hora** (ou o tempo escolhido) com o novo prazo. O aviso no Discord já mostra o horário novo.

## Perguntas frequentes

**A pessoa entrou na sala e não foi marcada.**
Confira se a sala está em **Salas de voz** e se a página não mostra o aviso de que o bot não está recebendo eventos ao vivo. Enquanto isso, use **Marcar presença** ou `/alinhado`.

**Dá para chamar a mesma pessoa duas vezes?**
Não enquanto houver um alinhamento aguardando. Estenda o prazo do que já existe ou cancele antes.

**O cargo de pendência não foi dado.**
O cargo do bot precisa ficar acima do cargo de pendência em Configurações do servidor → Cargos.

## Próximos passos

[Tickets](https://fivedash.fivex.gg/docs/pt/discord/tickets)Configure as categorias que contam como presença.
[Moderação](https://fivedash.fivex.gg/docs/pt/discord/moderation)/ban, /kick e /mute com motivo e provas.
[Comandos](https://fivedash.fivex.gg/docs/pt/discord/commands)Todos os comandos do bot e quem usa.
[Equipe e permissões](https://fivedash.fivex.gg/docs/pt/dashboard/team-and-permissions)Dê o nível certo para cada pessoa.
