> ## Documentation Index
> Fetch the complete documentation index at: https://wiki.petto.sbs/llms.txt
> Use this file to discover all available pages before exploring further.

# Temporizadores

> Envie a mesma mensagem ou embed salvo em um canal de novo e de novo: a cada poucos minutos ou horas, ou todo dia ou semana em um horário do seu fuso.

## Visão geral

Um temporizador publica a mesma mensagem em um canal de novo e de novo: em um intervalo fixo, ou todo dia ou toda semana em um horário do seu fuso. Use para lembrar de ler as regras, convidar a votar no servidor ou um anúncio que se repete. Pode ser texto, um [embed salvo](https://wiki.petto.sbs/pt-br/resources/scripting/embeds.md), ou os dois.

Precisa de **Gerenciar servidor**. As mesmas configurações estão em **Automação → Temporizadores** do dashboard (veja [Dashboard](#dashboard)).

![liam adiciona um temporizador com um lembrete para ler as regras, o Petto confirma o temporizador 1 a cada 2 horas e mais tarde publica o lembrete](https://mintcdn.com/wikipetto/ptnLHVPEm0LsaT45/images/discord/automation/pt-br/timers.webp?fit=max\&auto=format\&n=ptnLHVPEm0LsaT45\&q=85\&s=2a5d44e3413c36ef924f554f0f2f0d74)

No Discord: um temporizador criado para o #general a cada 2 horas, e a mensagem dele quando chega.

## Comandos

```javascript Syntax theme={null}
!timer add <channel> <schedule> <message> [--embed_template nome] [--delete_previous true]
!timer edit <number> <schedule>
!timer message <number> <text|none>
!timer channel <number> <channel>
!timer embed <number> <name|none>
!timer previous <number> <true|false>
!timer run <number>
!timer pause <number>
!timer resume <number>
!timer view <number>
!timer list
!timer remove <number>
```

```javascript Example theme={null}
!timer add #general 2h Não esqueça de ler #regras!
!timer add #general diário 18:00 America/Bogota Não esqueça de ler #regras!
!timer edit 1 diário 07:00 America/Bogota
!timer embed 2 vote-reminder
!timer run 3
!timer pause 2
```

```text Result theme={null}
Temporizador #1 criado para #general a cada 2 horas.
```

> [accordion] !timer add (menos de 10 minutos)
>
> ![liam tenta um temporizador a cada 5m em memes e o Petto responde que o intervalo precisa ser de pelo menos 10 minutos](https://mintcdn.com/wikipetto/ptnLHVPEm0LsaT45/images/discord/automation/pt-br/timers-add-too-short.webp?fit=max\&auto=format\&n=ptnLHVPEm0LsaT45\&q=85\&s=707311fe9a1c679cb8ea27510c4b532e)
>
> No Discord: um temporizador de 5 minutos é recusado, o mínimo é 10.

> [accordion] !timer add (um canal que já tem um)
>
> ![liam adiciona um temporizador ao general e o Petto responde que o canal já tem o temporizador 1 e para removê-lo antes](https://mintcdn.com/wikipetto/ptnLHVPEm0LsaT45/images/discord/automation/pt-br/timers-add-exists.webp?fit=max\&auto=format\&n=ptnLHVPEm0LsaT45\&q=85\&s=f19646ce79e7e7f778ea6793da467967)
>
> No Discord: o #general já tem o temporizador #1, então um segundo é recusado.

> [accordion] !timer edit
>
> ![liam edita o temporizador 1 para diário 07:00 America/Bogota e o Petto confirma com o próximo envio](https://mintcdn.com/wikipetto/ptnLHVPEm0LsaT45/images/discord/automation/pt-br/timers-edit.webp?fit=max\&auto=format\&n=ptnLHVPEm0LsaT45\&q=85\&s=bc26e5c7c224512e02bb4a2c8e0c5660)
>
> No Discord: o temporizador #1 passa de a cada 2 horas para todo dia às 07:00.

> [accordion] !timer message
>
> ![liam dá um texto novo ao temporizador 2 e o Petto repete o que vai enviar](https://mintcdn.com/wikipetto/ptnLHVPEm0LsaT45/images/discord/automation/pt-br/timers-message.webp?fit=max\&auto=format\&n=ptnLHVPEm0LsaT45\&q=85\&s=309102cacdbd2edfa41c56dfe37913f1)
>
> No Discord: o texto do temporizador #2 muda.

> [accordion] !timer channel
>
> ![liam move o temporizador 2 para o canal de eventos e o Petto confirma](https://mintcdn.com/wikipetto/ptnLHVPEm0LsaT45/images/discord/automation/pt-br/timers-channel.webp?fit=max\&auto=format\&n=ptnLHVPEm0LsaT45\&q=85\&s=9c7b859c2502caadf69dda6d1fbdfbc5)
>
> No Discord: o temporizador #2 vai para o #eventos.

> [accordion] !timer embed
>
> ![liam coloca o embed salvo vote-reminder no temporizador 2 e o Petto confirma](https://mintcdn.com/wikipetto/ptnLHVPEm0LsaT45/images/discord/automation/pt-br/timers-embed.webp?fit=max\&auto=format\&n=ptnLHVPEm0LsaT45\&q=85\&s=4596174ba66b21c7168cdd7f287bd3bf)
>
> No Discord: o temporizador #2 agora envia o embed salvo vote-reminder.

> [accordion] !timer previous
>
> ![liam liga apagar a anterior no temporizador 2 e o Petto diz que precisa de Gerenciar mensagens no canal](https://mintcdn.com/wikipetto/ptnLHVPEm0LsaT45/images/discord/automation/pt-br/timers-previous.webp?fit=max\&auto=format\&n=ptnLHVPEm0LsaT45\&q=85\&s=47c8c884002016ddf2aaf91455c51d84)
>
> No Discord: o temporizador #2 agora apaga a mensagem da vez anterior.

> [accordion] !timer run
>
> ![liam executa o temporizador 3 e o Petto responde que enviou a mensagem em regras](https://mintcdn.com/wikipetto/ptnLHVPEm0LsaT45/images/discord/automation/pt-br/timers-run.webp?fit=max\&auto=format\&n=ptnLHVPEm0LsaT45\&q=85\&s=29672ee50ff158f7fc032c1d1941aa6f)
>
> No Discord: o temporizador #3 envia a mensagem agora; o horário não muda.
>
> ![O Petto publica o embed Regras do Petto Land no canal de regras](https://mintcdn.com/wikipetto/ptnLHVPEm0LsaT45/images/discord/automation/pt-br/timers-post-rules.webp?fit=max\&auto=format\&n=ptnLHVPEm0LsaT45\&q=85\&s=0ad1ea20c8db373ec081214faffd14ad)
>
> No Discord: a mensagem do temporizador #3 em #regras, o embed salvo rules-card.

> [accordion] !timer pause
>
> ![liam pausa o temporizador 2 e o Petto diz como ligar de novo](https://mintcdn.com/wikipetto/ptnLHVPEm0LsaT45/images/discord/automation/pt-br/timers-pause.webp?fit=max\&auto=format\&n=ptnLHVPEm0LsaT45\&q=85\&s=e7045957ba795af2a38370b4024ff0cf)
>
> No Discord: o temporizador #2 fica pausado e mantém a configuração.

> [accordion] !timer resume
>
> ![liam retoma o temporizador 2 e o Petto confirma com o próximo envio](https://mintcdn.com/wikipetto/ptnLHVPEm0LsaT45/images/discord/automation/pt-br/timers-resume.webp?fit=max\&auto=format\&n=ptnLHVPEm0LsaT45\&q=85\&s=2c5df8f8197acd3e961e0fcdb312c041)
>
> No Discord: o temporizador #2 volta a funcionar, a partir do próximo horário.

> [accordion] !timer view
>
> ![liam vê o temporizador 2: anuncios toda sexta às 19:00 America/Bogota, o texto e o próximo envio](https://mintcdn.com/wikipetto/ptnLHVPEm0LsaT45/images/discord/automation/pt-br/timers-view.webp?fit=max\&auto=format\&n=ptnLHVPEm0LsaT45\&q=85\&s=38c8e0c91390f66653864c245525fc12)
>
> No Discord: como o temporizador #2 está configurado: canal, horário, texto e próximo envio.

> [accordion] !timer list
>
> ![O Petto lista o temporizador 1 no general a cada 2 horas, o 2 em anuncios toda sexta e o 3 em regras todo dia com o embed rules-card](https://mintcdn.com/wikipetto/ptnLHVPEm0LsaT45/images/discord/automation/pt-br/timers-list.webp?fit=max\&auto=format\&n=ptnLHVPEm0LsaT45\&q=85\&s=c60be308aae27ac6aac8f8de32e37ace)
>
> No Discord: os três temporizadores do servidor com os horários e próximos envios.

> [accordion] !timer remove
>
> ![liam remove o temporizador 2 e o Petto responde Temporizador removido](https://mintcdn.com/wikipetto/ptnLHVPEm0LsaT45/images/discord/automation/pt-br/timers-remove.webp?fit=max\&auto=format\&n=ptnLHVPEm0LsaT45\&q=85\&s=9324fd320e9135676a1c7b1fc01015a5)
>
> No Discord: o temporizador #2 é removido.

* `channel` é o canal de texto para onde vai a mensagem. Um canal pode ter **um temporizador**: para enviar duas mensagens ali, coloque as duas em um temporizador só ou tire o antigo antes.
* `schedule` é quando ele publica: uma duração, como `2h`, ou um horário do dia com `daily` e `weekly` (veja [Todo dia ou toda semana](#todo-dia-ou-toda-semana)). Uma duração tem a unidade: segundos (`600s`), minutos (`30m`), horas (`2h`), dias (`1d`), semanas (`2w`), meses (`1mo`) ou anos (`1y`), sozinhas ou juntas (`3d 4h`). O **mínimo é 10 minutos** e o dashboard aceita até 10 anos.
* `message` é o texto que o Petto envia, exatamente como escrito, depois do horário. Não precisa de aspas. O texto de um temporizador não preenche [variáveis](https://wiki.petto.sbs/pt-br/resources/scripting/variables.md), então `{user}` ou `{server_name}` apareceriam como digitados. As menções nele nunca notificam.
* Cada temporizador tem um **número** no seu servidor (1, 2, 3...), o que `!timer list` mostra. Os outros subcomandos usam ele:
  * `edit` muda quando ele publica, `message` muda o texto (`none` tira o texto quando ele tem um embed salvo), `channel` move para outro canal.
  * `run` envia a mensagem agora; o horário não muda.
  * `pause` para o temporizador e mantém como ele está configurado; `resume` liga de novo a partir do próximo horário, sem os envios que ele perdeu.
  * `view` mostra um temporizador, `list` mostra todos os temporizadores do servidor com o próximo envio, e `remove` apaga um.

`!timer` também funciona como `!tm`.

## Todo dia ou toda semana

Em vez de uma duração, um temporizador pode publicar em um **horário do dia** em um **fuso horário**, todo dia ou toda semana em um dia:

```javascript Example theme={null}
!timer add #general diário 18:00 America/Bogota Não esqueça de ler #regras!
!timer add #anuncios semanal sexta 19:00 America/Bogota É sexta! 💜
!timer edit 3 daily 09:00 Europe/Madrid
```

* O horário vai no formato de 24 horas (`18:00`, `9:30`).
* O dia de um temporizador `weekly` é o nome de um dia da semana (`segunda`, `monday`, `lunes`...). As palavras `diário` e `semanal` também funcionam.
* O fuso horário é um nome como `America/Bogota` ou `Europe/Madrid`, `UTC`, ou uma diferença como `UTC-5`. Sem ele, é `UTC`. Um fuso que não existe é recusado.
* O temporizador mantém esse horário quando os relógios mudam no fuso dele, e a resposta diz o próximo envio. Se o Petto estava offline nesse horário, ele envia a mensagem uma vez quando volta e depois passa para o próximo horário.

> [accordion] Todo dia
>
> ![liam adiciona um temporizador diário às 18:00 America/Bogota no general e o Petto confirma o temporizador 1 com o próximo envio](https://mintcdn.com/wikipetto/ptnLHVPEm0LsaT45/images/discord/automation/pt-br/timers-add-daily.webp?fit=max\&auto=format\&n=ptnLHVPEm0LsaT45\&q=85\&s=87e43e37b115ff9c3be73d64dd494715)
>
> No Discord: um temporizador todo dia às 18:00 no horário de Bogotá, com o próximo envio.

> [accordion] Toda semana
>
> ![liam adiciona um temporizador semanal na sexta às 19:00 America/Bogota e o Petto confirma o temporizador 2 com o próximo envio](https://mintcdn.com/wikipetto/ptnLHVPEm0LsaT45/images/discord/automation/pt-br/timers-add-weekly.webp?fit=max\&auto=format\&n=ptnLHVPEm0LsaT45\&q=85\&s=51c4177cebcd3b8228c2be78b7eb34fa)
>
> No Discord: um temporizador toda sexta às 19:00 no #anuncios.

> [accordion] Um fuso horário que não existe
>
> ![liam escreve o fuso Bogota/Colombia e o Petto responde que não é um fuso horário, com exemplos como America/Bogota e UTC-5](https://mintcdn.com/wikipetto/ptnLHVPEm0LsaT45/images/discord/automation/pt-br/timers-add-bad-zone.webp?fit=max\&auto=format\&n=ptnLHVPEm0LsaT45\&q=85\&s=f7973b2bc23fec16032a80fc0b3ed154)
>
> No Discord: Bogota/Colombia não é um fuso horário, e o Petto diz como escrever um.

## Um embed salvo

`!timer embed <number> <name>` faz um temporizador enviar um embed salvo (também os designs novos em formato de cartão da página de Embeds). O embed preenche variáveis como `{server.name}`, e as reações que ele pede são colocadas na mensagem. Com um embed, o texto é opcional: se o temporizador também tem texto, o texto vai acima do embed. `!timer embed <number> none` tira o embed (um temporizador sem texto mantém seu embed, então precisa de um dos dois). Se um dia o embed salvo for apagado, o temporizador envia o texto, para não ficar em silêncio.

> [accordion] O que o temporizador #2 envia
>
> ![O Petto publica É sexta com o embed Vote no Petto Land embaixo e uma reação de coração roxo](https://mintcdn.com/wikipetto/ptnLHVPEm0LsaT45/images/discord/automation/pt-br/timers-post-embed.webp?fit=max\&auto=format\&n=ptnLHVPEm0LsaT45\&q=85\&s=40061e70c5cba12d0d9c2b013c58bd4a)
>
> No Discord: o que o temporizador #2 envia com o texto e o embed salvo: o texto em cima, o embed embaixo e a reação que ele pede.

> [accordion] !timer embed 2 none
>
> ![liam tira o embed do temporizador 2 e o Petto confirma](https://mintcdn.com/wikipetto/ptnLHVPEm0LsaT45/images/discord/automation/pt-br/timers-embed-none.webp?fit=max\&auto=format\&n=ptnLHVPEm0LsaT45\&q=85\&s=884aefbffd4094a09e6a9c38e704efca)
>
> No Discord: o temporizador #2 para de enviar o embed salvo e mantém o texto.

Em um comando, `!timer add` também aceita `--embed_template <nome>` e `--delete_previous true` no final. Com um embed, a mensagem pode ficar de fora. No dashboard, os dois são campos do temporizador.

## Apagar a mensagem anterior

Com **apagar a anterior** ligado, toda vez que o temporizador envia a mensagem ele apaga a que enviou da vez anterior, assim o canal só tem a última: "1. Oi", depois "2. Oi" (e o 1 é apagado), depois "3. Oi" (e o 2 é apagado).

* Vem **desligado por padrão**. Ligue com `!timer previous <number> true`, ou com a caixa do temporizador no dashboard.
* O Petto precisa de **Gerenciar mensagens** no canal para apagar.
* Se alguém já apagou a mensagem anterior, o Petto pula e envia a nova mesmo assim.

> [!TIP]
>
> Para uma mensagem que fica sempre no fim de um canal, use uma [mensagem fixa](https://wiki.petto.sbs/pt-br/automation/sticky-messages.md). Para um aviso único mais tarde, use os [lembretes](https://wiki.petto.sbs/pt-br/community/reminders.md).

Um temporizador nunca avisa ninguém. Um `!` antes de uma menção continua sendo lido como [menção silenciosa](https://wiki.petto.sbs/pt-br/concepts/variables-engine.md#menções-silenciosas), então a menção aparece normal, sem o `!`.

## Dashboard

Em **Automação → Temporizadores**, cada temporizador é um cartão com o número, o canal, quando ele publica e o próximo envio. **Enviar agora** envia na hora, o lápis abre as configurações e a lixeira apaga. Nas configurações, **Repetir** escolhe a cada intervalo (um número e uma unidade), todo dia ou toda semana (um horário, um dia e um fuso horário); a mensagem, o embed salvo, **apagar a mensagem da vez anterior** e **Pausado** também estão ali. O formulário embaixo adiciona um temporizador.

![A seção Temporizadores repetitivos com o temporizador 1 a cada 2 horas, o 2 toda sexta às 19:00 com o embed de votar, o 3 todo dia às 09:00 com o embed de regras, e o formulário para adicionar](https://mintcdn.com/wikipetto/X8GdsHqKNBomKSYc/images/dashboard/automation/pt-br/timers-dashboard.webp?fit=max\&auto=format\&n=X8GdsHqKNBomKSYc\&q=85\&s=afa1b905e37c209966b8da22e8cf0fbc)

Dashboard → Automação → Temporizadores: um cartão por temporizador, com a prévia, e o formulário para adicionar um.

![O temporizador 2 aberto com Repetir em toda semana, o horário, o dia sexta, o fuso America/Bogota, o texto, o embed salvo vote-reminder e a caixa Pausado](https://mintcdn.com/wikipetto/X8GdsHqKNBomKSYc/images/dashboard/automation/pt-br/timers-dashboard-edit.webp?fit=max\&auto=format\&n=X8GdsHqKNBomKSYc\&q=85\&s=fafe11016a65beaef231578250061b68)

Dashboard → Automação → Temporizadores: as configurações do temporizador #2, toda semana na sexta às 19:00 em America/Bogota.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.