Comandos¶

Referência completa dos comandos. Os comandos marcados com (Admin) estão disponíveis apenas para administradores do chat. Os aliases (sinónimos curtos e variantes na língua respetiva) são mostrados logo ao lado do comando principal.

Gerais¶

Comando	Descrição
`/start`	Saudação e estado do bot
`/help`	Ajuda e lista de comandos
`/ask`, `/ai`, `/bot`, `/kwitka`, `/comment`	Perguntar à inteligência artificial
`/info`, `/id`	Info sobre o chat e o utilizador
`/kickme`	Sair sozinho (pode voltar)
`/admins`, `/adminlist`	Lista dos admins
`/my_status`, `/status`, `/why`	O meu estado e verificação de restrições
`/settings`	Definições do chat (Admin)
`/air_raid`, `/alarm`	Avisos de alerta aéreo (Admin)
`/my_alerts`	Notificações pessoais sobre bans/spam (em privado)

Conteúdo e IA¶

Comando	Descrição
`/report`, `/report_spam`, `/denunciar`	Denunciar spam (reply)
`/explain`	Explicar uma mensagem com IA (reply)
`/translate`	Traduzir uma mensagem (Admin)
`/pull`	Descarregar um vídeo por link (YouTube, TikTok, Instagram, Facebook, X)

«explica»

Além de /explain, o resumo de um artigo/vídeo é acionado pela palavra explica em resposta a uma mensagem com link.

Notas e regras¶

Comando	Descrição
`/save`, `/addnote`	Guardar uma nota (Admin)
`/get`, `/note`	Obter uma nota
`/notes`	Lista de todas as notas
`/clear`, `/delnote`	Eliminar uma nota (Admin)
`/rules`, `/rule`	Mostrar as regras do chat
`/setrules`	Definir as regras do chat (Admin)

Filtros e boas-vindas¶

Comando	Descrição
`/filter`	Resposta automática a um gatilho: texto, média (sticker/foto/GIF/vídeo), botões (Admin)
`/stop`	Remover um filtro (Admin)
`/filters`	Lista de filtros (Admin)
`/setwelcome`	Definir o texto de boas-vindas (Admin)
`/welcome`	Ativar/desativar boas-vindas (Admin)
`/setgoodbye`	Define o texto de despedida (Admin)
`/goodbye`, `/bye`	Liga/desliga a despedida (Admin)

Botões-link

Em /save, /setrules, /setwelcome e /filter são suportados botões: [Texto](buttonurl://url), e :same coloca o botão na mesma linha.

Menção de utilizador numa nota

Nas notas funciona uma variável de menção: o bot insere a pessoa a quem respondeu ou, caso contrário, quem chamou a nota. Grafias equivalentes: {mention}, {user}, {username}, {name}, {user_mention}.

Moderação¶

Comando	Descrição
`/move`	Mover um intervalo de mensagens (Admin)
`/move1`	Mover uma única mensagem (reply) (Admin)
`/target`, `/here`	Alvo para mover (Admin)
`/purge`, `/flush`	Limpar um intervalo (Admin)
`/purgefrom`, `/purgeto`	apagar um intervalo de mensagens (responder). (Admin)
`/del`, `/delete`, `/apagar`	Eliminar uma mensagem (Admin)
`/ban`, `/tban`, `/banir`	Banir um participante (Admin)
`/mute`, `/tmute`, `/silenciar`	Restringir um participante (Admin)
`/kick`	Expulsar um participante (Admin)
`/permapin`	Fixar com notificação (resposta) (Admin)
`/pinned`	Mostrar a fixada
`/spurge`	Limpeza silenciosa (resposta) (Admin)
`/unapproveall`	Remover 'de confiança' de todos (Admin)
`/title`	Título de admin personalizado (resposta) (Admin)
`/admincache`	Limpa a cache de admins (Admin)
`/setflood`, `/antiflood`	Antiflood on/off (Admin)
`/connect`	Gestão pelo navegador (painel) (Admin)
`/swarn`	Aviso silencioso (resposta) (Admin)
`/antiraid`, `/raid`	Modo raid: restringir quem entra (Admin)
`/resetwarn`, `/resetwarns`	Repor TODOS os avisos (resposta) (Admin)
`/dwarn`	Avisar + apagar (resposta) (Admin)
`/promote`	Promove a admin (resposta) (Admin)
`/demote`, `/unadmin`	Despromove um admin (resposta) (Admin)
`/pin`	Fixa uma mensagem (resposta) (Admin)
`/unpin`, `/unpinall`	Desafixa / limpa todas (Admin)
`/b`	Resposta a um bot de spam (“hello” + foto): silencia o autor e apaga (Admin)
`/disable`	Desativa um comando de utilizador (Admin)
`/enable`	Reativa um comando (Admin)
`/unban`, `/desbanir`	Levantar o ban (Admin)
`/unmute`	Levantar a restrição (Admin)

Ban/mute temporário

/ban e /mute aceitam duração e motivo: /ban 1d spam, /mute 2h flood (unidades: m, h, d, w).

Avisos e confiança¶

Comando	Descrição
`/warn`	Emitir um aviso (Admin)
`/unwarn`	Retirar o warn (Admin)
`/warns`	Histórico de warns (Admin)
`/cwarn`	Aviso da comunidade (responder): membros com patente votam, peso conforme a patente
`/trust`	Estatuto de confiança (Admin)
`/approved`, `/trusted`	lista de utilizadores de confiança. (Admin)

Exceções (listas brancas)¶

Comando	Descrição
`/bio_white_add`	Adicionar uma exceção de Bio (Admin)
`/bio_white_del`	Eliminar uma exceção de Bio (Admin)
`/bio_white_list`	Lista de exceções de Bio (Admin)

Reputação e atividades¶

Comando	Descrição
`/myrep`, `/rep`, `/my_rep`	A minha reputação
`/toprep`, `/top_rep`, `/reputation`	Top por reputação (Admin)
`/modstats [N]`, `/spamstats`	Eficácia da moderação: detetados/restaurados(FP)/por ação/motivos top (Admin)
`/digesthere`, `/setdigest`	Tópico para o resumo semanal: execute no tópico desejado (`off` → feed principal) (Admin)
`/digestnow`, `/digest_now`	Publicar o resumo semanal agora (forçar) (Admin)
`/top`, `/leaderboard`	Classificação: `/top active [N]` — top de ativos, `/top rep` — top por reputação (Admin)
`/rank`, `/level`	Perfil de atividade: nível, XP, posição
`/poll`, `/oputuvannya`	Criar uma sondagem (Admin)

Palavras-stop¶

Comando	Descrição
`/addstop`, `/banword`	Adicionar uma palavra-stop (Admin)
`/delstop`, `/unbanword`	Eliminar uma palavra-stop (Admin)
`/liststops`, `/listwords`	Lista de palavras-stop (Admin)

Comandos de admin adicionais¶

Comando	Descrição
`/night_mode`	Modo noturno do chat (Admin)
`/silence`	Silêncio manual — bloqueio instantâneo, só os administradores escrevem (Admin)
`/ad_topic`, `/topic`	Marcar um tópico como publicitário (permitir anúncios) (Admin)
`/airules`	Regras especiais para a IA (Admin)
`/lock`	Bloquear um tipo de conteúdo (Admin)
`/unlock`	Desbloquear um tipo de conteúdo (Admin)
`/locks`, `/locktypes`	bloqueios ativos / todos os tipos. (Admin)
`/link_white_add`	Adicionar uma exceção para links (Admin)
`/link_white_del`	Eliminar uma exceção para links (Admin)
`/link_white_list`	Lista de exceções para links (Admin)
`/card_white add\\|del\\|list`	Whitelist de números de cartão permitidos (p. ex. angariação para o exército) — o bot não os bloqueia; guardam-se normalizados, no chat mascarados `•••• 1234` (Admin)
`/welcomedelete`	Tempo de auto-eliminação das boas-vindas (Admin)
`/setlog`	Canal de log do chat: bans/mutes/avisos/eliminações por IA duplicam-se num canal separado; `/setlog off` — desativar (Admin)
`/export`, `/import`	Transferência de definições entre grupos da rede: `/export` dá o ficheiro de configuração, `/import` (reply ao ficheiro) aplica-o. As chaves ligadas ao chat (fios, canal de log, nome) não se transferem. Também no painel web `/settings` (botões 📤/📥) (Admin)
`/welcometopic`, `/welcomehere`	Fio para boas-vindas: executar no tópico necessário (ou `/welcometopic off` — em General) (Admin)
`/cleancommands`	Eliminar mensagens com comandos do bot (o mesmo interruptor que em `/settings`); sem argumentos — alternar, `on`/`off` — explícito (Admin)
`/cfg`, `/config`	Qualquer definição simples por comando (paridade com o painel): `/cfg list`, `/cfg get chave`, `/cfg set chave valor` (Admin)
`/network`, `/net`, `/fed`	Rede de chats: ligar os seus grupos (`create`/`join`/`leave`/`info`) para ban cross-chat (Admin)
`/fban`, `/unfban`	Ban/unban na rede: atua em TODOS os chats da rede (`/ban` normal permanece local) (Admin)

Outros¶

Comando	Descrição
`/appeal`, `/recurso`	Apresentar um recurso (em mensagens privadas ao bot)
`/donate`, `/support`	Apoiar o projeto

Comandos de serviço

Uma série de comandos técnicos e de proprietário (ban global, diagnóstico, estatísticas de IA etc.) está intencionalmente oculta do menu público.

Palavras-gatilho (em resposta)¶

Além dos comandos, o bot reage a palavras-gatilho em resposta a uma mensagem:

Palavra	Ação
`explica`	Resumo por IA da mensagem
`obrigado` / `+` / `rep`	Agradecer a um participante (+reputação)

Em mensagens privadas ao bot¶

/appeal, /recurso — apresentar um recurso.
/porquê, /motivo — saber o motivo do bloqueio.

Exemplos de utilização¶

Notas¶

/save boasvindas Bem-vindo! [O nosso canal](buttonurl://t.me/Kwitka_Antispam)
/get boasvindas
/notes
/clear boasvindas

Boas-vindas e regras¶

/setwelcome Bem-vindo, {mention}! Lê as regras 👇
[Regras](buttonurl://t.me/Kwitka_Antispam)
/setrules 1. Sem spam. 2. Comunicação em ucraniano. 3. Respeito.
Detalhes: https://t.me/Kwitka_Antispam
[📜 Regras completas](buttonurl://t.me/Kwitka_Antispam)

Moderação¶

Em resposta à mensagem de um infrator:

/ban 1d spam            → ban por um dia com motivo
/mute 2h flood          → mute por 2 horas
/kick                   → expulsar (sem ban)
/warn reclame no chat   → aviso

Limpeza e mudança (fios)¶

/del       → eliminar uma mensagem (em resposta)
/purge     → eliminar do escolhido para baixo (em resposta)
/target    → marcar o fio-alvo (no tópico necessário)
/move      → mover um intervalo para o fio-alvo (em resposta)
/move1     → mover apenas uma mensagem (em resposta)

Alertas¶

/air_raid Kyiv
/air_raid all
/air_raid off

Filtros e palavras-stop¶

/filter promocode Descontos só no canal: [Ir](buttonurl://t.me/Kwitka_Antispam)
/addstop casino
/liststops

Comunidade¶

/trust     → conceder confiança (em resposta)
/report    → denunciar spam (em resposta)
/myrep     → a minha reputação e patente

Botões na mesma linha

Adicione :same no fim, para que o botão seguinte fique ao lado: [A](buttonurl://t.me/a) [B](buttonurl://t.me/b:same)

🎮 Gamificação¶

/checkin — check-in diário: sequência 🔥 + moedas 🪙.
/balance — saldo de moedas 🪙 e sequência 🔥 (resposta — de alguém).
/badges — as tuas conquistas 🏆 (resposta — de alguém).
/shop — loja de flair 🛒.
/buy id — compra um flair.
/give 50 (resposta) — transferir moedas 🪙.
/dice 50 — dado contra o bot 🎲 (aposta em moedas).
/guess 50 4 — adivinha o dado 🎲, ganha 4×.

🚚 Transporte (transportadores)¶

/carrier_add Nome | Contacto — adicionar transportador 🚚.
/vouch código — recomenda um transportador (de confiança).
/carriers — lista de transportadores 🚚 (✅ verificados).
/carrier_report código — denuncia um transportador 🚩.

🆕 Mais¶

/slowmode 30s — Modo lento: intervalo mínimo entre mensagens (/slowmode off — desativar).
/tldr — resumo IA do chat recente (/tldr 6 — últimas 6 h).
/remind 2h texto — lembrete neste chat (/reminders · /unremind — lista).
/quiz Pergunta | A | B* | C — quiz (★ marca a opção correta).
/cleaninactive 30 — remove inativos 30+ dias (primeiro pré-visualização, depois confirm; nunca admins/confiáveis).

🎁 Sorteios¶

/giveaway 1h winners=2 Prémio — um sorteio com botão de participação; os vencedores são sorteados ao acaso (/gend — terminar antes) (Admin).
🪙 Resgatar silêncio com moedas: o admin ativa nas definições e define um preço; um membro silenciado toca no botão sob o aviso e remove a restrição.

🆕 Comunidade e serviços¶

/setup — visão rápida das funções + botão para o painel (Admin).
/listing, /listings, /listing_del — anúncios: habitação / emprego / coisas / serviços.
/fundraise, /fundraisers — angariações transparentes (o bot não toca em dinheiro) (Admin).
/event, /events — eventos com botões de presença (Vou / Talvez / Não).
⏳ Retenção: os anúncios duram 14 dias e depois são removidos automaticamente; as angariações fechadas são apagadas 30 dias após o encerramento; os eventos passados — após um dia.
/checkscam — verificação IA de fraude de mensagem suspeita (resposta).
/question — «pergunta do dia» para animar o chat (auto ou manual) (Admin).

Exemplos¶

/listing Vendo bicicleta, quase nova | @user — um anúncio; depois escolha uma categoria com um botão.
/fundraise 50000 | Angariação para um drone | https://… — abrir uma angariação (o bot dá um código).
/fund_add a1b2c3 500 — adicionar 500 à angariação a1b2c3.
/fund_close a1b2c3 — fechar a angariação.
/event 15.07 19:00 | Encontro da comunidade — um evento com RSVP; formatos de data: 2026-07-15 19:00, 15.07.2026 19:00, 15.07 19:00.
/checkscam — em resposta a uma mensagem suspeita: a IA avalia o risco.
/question — publicar a pergunta do dia agora.
📷 Podes anexar fotos/vídeos a /listing, /fundraise, /event, /carrier_add — até um álbum (coloca o comando na legenda do media).

📚 Lingua — aprendizagem de línguas¶

/word — palavra ou frase do dia (🇩🇪→🇺🇦 / 🇬🇧→🇺🇦; ativa no painel, secção Reputação).
/learn, /addword, /vocab, /seed — treinador de palavras: repetição espaçada, baralho pessoal (em privado com o bot).
🌐 app.kwitka.kyiv.ua/lingua — o mesmo baralho no navegador.

🛠 Mais para admins¶

/tpoll — sondagem de avaliação de uma mensagem (responde: recomendo / nuances / não recomendo / fraude).
/blacklist, /unblacklist — Gerir a lista negra «Anti-discussão».
/ad_mute — Mute por repetição de publicidade.
/ai_limit — Limite de IA para um chat.
/disable / /enable <cmd> — Ativa/desativa um comando de utilizador no chat. /disableable, /disabled.
/ai_stats, /chat_stats — Estatísticas de IA e chat.