Presença
Status e recado do bot.
Conectar no Gateway já deixa o bot online. Para outro status ou um recado personalizado, o próprio bot usa estas rotas.
GET
/api/bot/presence200
{ "status": "online", "statusMode": "online", "customStatus": "" }status é o que os outros veem; statusMode é o que o bot escolheu.
PUT
/api/bot/presenceCorpo da requisição
| Campo | Tipo | Descrição |
|---|---|---|
statusMode | string | online, idle, dnd ou invisible. |
customStatus | string | null | Até 128 caracteres. null ou "" limpa. Um emoji no início vira o ícone do recado. |
| statusMode | Aparece como |
|---|---|
online | Online — padrão |
idle | Ausente |
dnd | Não perturbe |
invisible | Offline para todos, mas o bot continua conectado e recebendo eventos |
Exemplo
async function setPresence(statusMode, customStatus) {
await fetch('https://nexapp.online/api/bot/presence', {
method: 'PUT',
headers: { 'Content-Type': 'application/json', Authorization: `Bearer ${TOKEN}` },
body: JSON.stringify({ statusMode, customStatus }),
});
}
socket.on('connect', () => setPresence('online', '👀 Esperando comandos'));Offline de verdade
O bot fica offline quando o último socket do Gateway desconecta. O recado é preservado, e ao reconectar o bot volta ao statusMode salvo (se estava invisible, continua invisível).
Nota
Ainda não há atividade ("Jogando…") para bots — só status e recado.