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/presence
Auth: Bot
200
{ "status": "online", "statusMode": "online", "customStatus": "" }

status é o que os outros veem; statusMode é o que o bot escolheu.

PUT/api/bot/presence
Auth: Bot30 por minuto. Envie só o que quiser mudar.

Corpo da requisição

CampoTipoDescrição
statusModestringonline, idle, dnd ou invisible.
customStatusstring | nullAté 128 caracteres. null ou "" limpa. Um emoji no início vira o ícone do recado.
statusModeAparece como
onlineOnline — padrão
idleAusente
dndNão perturbe
invisibleOffline 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.