O que é a Vesta
Vesta é o nome do ecossistema que reúne o bot para Discord e a API HTTP de integração.
No chat, o bot responde a comandos com prefixo !: pode juntar-se a canais de voz,
gerir sessões e, quando permitido, ajudar na captura de áudio para arquivo ou processamento posterior.
Em paralelo, a API REST exposta pelo mesmo processo permite que sistemas externos criem eventos na guild, listem canais de voz e criem novas salas — ideal para dashboards, agendadores ou automações que precisam de falar com o Discord sem abrir o cliente.
- Bot no Discord — comandos de voz, sessões e fluxos orientados a equipas.
- API com chave — integração segura via header
x-api-key. - Um só serviço — mesmo processo serve o gateway do Discord e as rotas HTTP.
Documentação
A referência completa da API e o guia de uso do bot no servidor estão nos ficheiros Markdown do repositório
(docs/api.md e docs/uso.md). Abaixo fica um resumo das rotas HTTP e dos comandos mais usados.
Base e autenticação
Base local por defeito: porta definida por HTTP_PORT (ex.: 3000).
Header obrigatório: x-api-key: <INTEGRATION_API_KEY>
Rotas HTTP
| Método | Rota | Descrição |
|---|---|---|
| POST | /guild-events | Cria evento na guild (VOICE, STAGE ou EXTERNAL). |
| GET | /guilds/:guildId/voice-channels | Lista canais de voz; query opcional availableForEveryone. |
| POST | /guilds/:guildId/voice-channels | Cria canal de voz (nome e limite opcionais). |
Exemplo rápido (curl)
curl -X POST http://localhost:3000/guild-events \
-H "content-type: application/json" \
-H "x-api-key: SUA_CHAVE" \
-d '{"guildId":"...","name":"Daily","description":"...",
"scheduledStartTime":"2026-05-01T13:00:00.000Z",
"entityType":"VOICE","privacyLevel":"GUILD_ONLY","channelId":"..."}'
Comandos do bot (prefixo !)
| Comando | Função |
|---|---|
!ping | Teste de vida — responde pong. |
!join | Entra no canal de voz e inicia sessão. |
!leave | Sai do canal, finaliza gravação ativa e guarda metadados. |
!record on / !record off | Liga ou desliga gravação PCM (se permitido no ambiente). |