Configurações avançadas para administradores: auto-mod, filtros de log granulares, warns automático.
Esta página é para administradores de servidores onde o Starbot está presente. Se você é um usuário comum, a documentação pública é o que você precisa.
O Starbot pode automaticamente deletar mensagens que contenham palavras proibidas que você definir. Funciona em qualquer canal (exceto os que você ignorar).
PATCH /dashboard/api/guilds/{guildId}
Content-Type: application/json
{
"automod": {
"badWords": ["palavra1", "palavra2", "insulto"]
}
}Você pode configurar canais e cargos que são imunes à auto-moderação (útil para canais de staff ou cargos VIP):
PATCH /dashboard/api/guilds/{guildId}
{
"automod": {
"ignoredChannels": ["1234567890", "0987654321"],
"ignoredRoles": ["1111111111"]
}
}Ative para bloquear automaticamente qualquer mensagem que contenha URLs (http/https):
PATCH /dashboard/api/guilds/{guildId}
{
"automod": {
"antiLink": true
}
}O Starbot permite ativar/desativar individualmente cada tipo de evento que vai pro canal de log. Isso evita spam em canais de log quando você só quer registrar certos eventos.
| Evento | Descrição | Default |
|---|---|---|
messageDelete | Quando uma mensagem é deletada | ✅ Ativado |
messageUpdate | Quando uma mensagem é editada | ✅ Ativado |
memberUpdate | Quando um membro recebe/perde cargo ou muda apelido | ❌ Desativado |
memberJoinLeave | Quando um membro entra ou sai do servidor | ✅ Ativado |
ban | Quando um membro é banido | ✅ Ativado |
PATCH /dashboard/api/guilds/{guildId}
{
"logs": {
"messageDelete": true,
"messageUpdate": false,
"memberUpdate": false,
"memberJoinLeave": true,
"ban": true
}
}Configure limites de warns que disparam punições automáticas. Quando um membro atinge o limite, o bot age sem intervenção manual.
/configurar-warns
ativar: true
mute_limite: 3
mute_duracao: 60
ban_limite: 5Exemplo: 3 warns → mute de 60min, 5 warns → banimento automático.
Quando um membro sai do servidor e volta depois, o Starbot restaura automaticamente os cargos que ele tinha. Isso é automático — não precisa configurar.
Se você configurou boas-vindas com cargo automático, o bot não duplica cargos — só aplica o cargo automático se o membro NÃO tinha cargos recuperáveis.
O sistema de boas-vindas suporta variáveis que são substituídas automaticamente:
| Variável | Substituída por |
|---|---|
{membro} ou {user} | Menção ao usuário (@João) |
{servidor} ou {server} | Nome do servidor |
{total} | Total de membros do servidor |
/configurar-boas-vindas
canal: #boas-vindas
mensagem: Bem-vindo {membro} ao {servidor}! Você é o membro #{total}.
cargo: @MembroCada servidor pode definir seu idioma padrão. Usuários podem ainda assim definir seu próprio idioma (sobrepõe o do servidor para eles):
/idioma idioma: pt-BR # ou en-US ou es-ES