# Ponto Defina o canal do ponto no Discord, apague pontos fora do lugar e acompanhe quem bate ponto todo dia, com ranking e sequência. Source: https://fivedash.fivex.gg/docs/pt/discord/clock-in O **Ponto** organiza o bate-ponto da equipe da cidade no Discord. Uma mensagem de ponto é só um ponto final (`.`), e ela só vale no canal do ponto. Em qualquer outro canal, o bot apaga na hora. O painel conta cada ponto e mostra quem mais manda, para a gestão acompanhar a presença da equipe. Esta página é para o dono e a equipe que cuidam do Discord do servidor. ## Antes de começar * **Plano:** o módulo Discord precisa estar no plano da organização (vale para Plus, Pro e Ultra). * **Bot conectado:** o bot da cidade precisa estar conectado ao servidor do Discord. Veja [Bot](https://fivedash.fivex.gg/docs/pt/discord/bot). * **Message Content Intent:** ligue em **Bot → Privileged Gateway Intents**, no Developer Portal do Discord. Sem ele, o Discord não mostra o texto das mensagens e o bot não sabe o que é um ponto. A página avisa quando ele está desligado. * **Permissão no Discord:** para apagar mensagens, o bot precisa de **Gerenciar mensagens** nos canais. * **Nível de acesso** na área **Ponto**: | Nível | O que permite | | -------------- | ---------------------------------------------------------- | | **Ver** | Quem manda ponto e o que foi apagado (aba **Visão geral**) | | **Configurar** | Canal, regras, quem passa e avisos (aba **Configurações**) | Quem só tem **Ver** vê o aviso: "Seu acesso permite só ver as configurações do ponto." ## O que conta como ponto Um ponto é uma mensagem só com pontos finais (`.`, `..`, `•` e parecidos) e espaços, sem nada anexado. Edições não contam, e mensagens de bots e webhooks são ignoradas. | Onde | O que o bot faz | | ----------------------- | --------------------------------------------------------- | | Ponto no canal do ponto | Conta como ponto, para todo mundo. | | Texto no canal do ponto | Apaga, se **Só pontos no canal** estiver ligado. | | Ponto em outro canal | Apaga, se **Apagar pontos fora do canal** estiver ligado. | | Texto em outro canal | Nada. | Quem está em **Quem passa** pode mandar ponto em qualquer canal e escrever no canal do ponto sem ter a mensagem apagada. ## Ligar o ponto ### Abra a página No painel, vá em **Discord → Ponto** e abra a aba **Configurações**. ### Escolha o canal do ponto Em **Canal do ponto → Canal**, escolha o único canal onde dá para mandar mensagens de ponto. ### Escolha as regras Deixe **Só pontos no canal** e **Apagar pontos fora do canal** ligados ou desligados, como preferir. ### Defina quem passa Em **Quem passa**, escolha os **Cargos que passam**, adicione **Pessoas** e decida se **Administradores passam**. ### Escolha o aviso Em **Aviso**, escolha **Como avisar** e ajuste os textos. ### Ligue e salve Ligue **Ligar o ponto** (fica **Ligado**) e clique em **Salvar**. > O ponto depende do bot recebendo eventos ao vivo. Se a página mostrar "O bot não está recebendo eventos ao vivo agora", nenhum ponto é contado nem apagado até ele voltar. ## Configurações ### Canal do ponto | Campo | O que faz | Padrão | | ------------------------------ | --------------------------------------------------------------------------------- | ------ | | **Canal** (**Canal do ponto**) | O único canal onde dá para mandar mensagens de ponto (.). Obrigatório para ligar. | Nenhum | | **Só pontos no canal** | Qualquer outra coisa mandada no canal do ponto é apagada, para ele ficar limpo. | Ligado | ### Nos outros canais | Campo | O que faz | Padrão | | ------------------------------- | ---------------------------------------------------------------------- | ------ | | **Apagar pontos fora do canal** | Uma mensagem que é só um ponto, em qualquer outro canal, some na hora. | Ligado | ### Quem passa | Campo | O que faz | Limite | Padrão | | ---------------------------------- | ------------------------------------------------------------------------------------------- | ---------- | ---------------- | | **Cargos** (**Cargos que passam**) | Quem tem um desses cargos pode mandar ponto em qualquer canal e escrever no canal do ponto. | 25 cargos | **Nenhum cargo** | | **Pessoas** | Membros que passam, mesmo sem um desses cargos. | 25 pessoas | Nenhuma | | **Administradores passam** | Quem tem a permissão de Administrador e o dono do servidor. | — | Ligado | > O dono do servidor do Discord nunca tem a mensagem apagada, mesmo com **Administradores passam** desligado. ### Aviso **Quando o bot apaga uma mensagem**: como o membro fica sabendo. No máximo um aviso por pessoa a cada 30 segundos, para quem manda vários pontos seguidos não receber vários avisos. | Campo | O que faz | Opções | Padrão | | ---------------------------- | --------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------- | ---------------------------------------------------------------------- | | **Como avisar** | Onde o aviso aparece. | **No canal** (uma mensagem rápida que some sozinha), **Na DM** (só o membro vê, no privado), **Sem aviso** (a mensagem só some) | **No canal** | | **Ponto em outro canal** | O aviso para quem manda ponto fora do canal. Obrigatório com aviso e a regra ligados. Até 300 caracteres. | — | "`{{error}}` `{membro}`, o ponto é só no `{canal}`." | | **Texto no canal do ponto** | O aviso para quem escreve no canal do ponto. Obrigatório com aviso e a regra ligados. Até 300 caracteres. | — | "`{{error}}` `{membro}`, no `{canal}` vale só o ponto: mande um **.**" | | **Apagar o aviso depois de** | Só com **No canal**. O aviso no canal some sozinho, para não poluir a conversa. | 5, 10, 15 ou 30 segundos | 10 segundos | `{{error}}` é o ícone de erro do pacote de emojis do bot. ### Variáveis | Variável | O que vira | | ---------- | ----------------- | | `{membro}` | Marca quem mandou | | `{canal}` | O canal do ponto | ## Prévia A prévia ao lado mostra o Discord em dois canais. Em **Canal da prévia**, troque entre **Canal do ponto** e **Outros canais** para ver o que fica, o que o bot apaga e como o aviso aparece. ## Visão geral A aba **Visão geral** mostra os números do ponto: | Número | O que mostra | | ----------------------- | ------------------------------------------------------------------- | | **Pontos hoje** | Pontos de hoje e de quantas pessoas. | | **Pontos · 7 dias** | Pontos nos últimos 7 dias, comparados com a semana anterior. | | **Pessoas na semana** | Quantas pessoas mandaram ponto nos últimos 7 dias. | | **Apagados · 7 dias** | Pontos fora do lugar e texto no canal, apagados nos últimos 7 dias. | | **Pontos por dia** | Gráfico dos últimos 14 dias, com o que foi apagado. | | **Mandaram ponto hoje** | Quem mandou ponto hoje, o mais recente primeiro. | **Quem mais manda ponto** é um ranking com **Membro**, **Esta semana**, **30 dias**, **Sequência** (dias seguidos com ponto, terminando hoje ou ontem) e **Último ponto**. Use **Ver mais** para carregar mais linhas. **Atividade** lista cada ponto e cada mensagem que o bot apagou: **Mandou ponto**, **Ponto fora do canal, apagado** e **Texto no canal do ponto, apagado**. Filtre por **Tudo**, **Pontos** ou **Apagados**. > Os dias seguem o horário de Brasília. ## Perguntas frequentes **O bot não apaga nada e não conta pontos.** Confira se o **Message Content Intent** está ligado no Developer Portal, se **Ligar o ponto** está **Ligado** e se a página não mostra o aviso de eventos ao vivo. Confira também se o bot tem **Gerenciar mensagens** no canal. **A equipe precisa conversar no canal do ponto.** Coloque o cargo da equipe em **Cargos que passam**, ou desligue **Só pontos no canal**. **Pontos editados contam?** Não. Só a mensagem enviada conta. Uma edição não vira ponto nem é apagada. ## Próximos passos [Moderação](https://fivedash.fivex.gg/docs/pt/discord/moderation) Comandos de punição e registro de casos. [Alinhamento](https://fivedash.fivex.gg/docs/pt/discord/alignment) Chame membros para conversar com a equipe. [Bot](https://fivedash.fivex.gg/docs/pt/discord/bot) Intents, permissões e pacote de emojis do bot. [Equipe e permissões](https://fivedash.fivex.gg/docs/pt/dashboard/team-and-permissions) Defina quem vê e quem configura o ponto.