← Documentação
Matriz de recursos
Uma visão de “isso funciona?” para cada recurso de bot do Discord no GameVox. Use-a para dimensionar uma migração antes de trocar a URL do gateway. A coluna Auto-hospedado mostra se um recurso funciona quando o seu bot está instalado em um servidor GameVox auto-hospedado de um cliente. Veja a documentação de auto-hospedagem para a arquitetura de encaminhamento.
| Área | Recurso | Nuvem | Auto-hospedado | Observações |
|---|---|---|---|---|
| Gateway | Codificação JSON | Sim | Sim | Padrão; o que toda biblioteca usa |
| Compressão zlib-stream | Sim | Sim | Coberta por todas as principais bibliotecas | |
| Codificação ETF | Não | Não | As bibliotecas fazem fallback para JSON quando encoding=etf está ausente | |
| Compressão Zstandard | Não | Não | O zlib-stream é a alternativa universal | |
| Resume / op:6 | Sim | Sim | O buffer de retomada é espelhado no Redis, então o op:6 sobrevive a reinícios das tarefas api | |
| Sharding | Sim | Sim | Hash padrão (guild_id >> 22) % num_shards | |
| REST | CRUD de mensagens | Sim | Sim | Enviar, editar, excluir, excluir em lote, obter, fixar, indicador de digitação, reações, anexos de arquivo, enquetes |
| CRUD de canais | Sim | Sim | Nuvem: reordenação e escrita de exceções de cargo (PUT e DELETE); os objetos de canal ainda não listam as exceções. Auto-hospedado: reordenação sim, exceções de cargo sim (sem exceções de integrante), listadas nos objetos de canal | |
| Exceções de permissão por canal | Parcial | Parcial | Só exceções de cargo (grupo), sem exceções de integrante. A escrita (PUT, DELETE) funciona na nuvem e no auto-hospedado. A leitura (permission_overwrites nos objetos de canal e em CHANNEL_UPDATE) por enquanto só existe no auto-hospedado; os objetos de canal da nuvem não incluem o campo. No auto-hospedado, uma liberação nunca concede mais do que o próprio cargo tem permitido | |
| Integrantes / cargos / banimentos | Sim | Sim | CRUD completo; communication_disabled_until (timeout) não é suportado | |
| Webhooks (canal & app) | Sim | Sim | CRUD completo + execução (embeds, anexos, multipart). Em servidores auto-hospedados, os registros ficam no armazenamento na nuvem e as mensagens geradas pela execução são gravadas no canal auto-hospedado | |
| Emojis do próprio app | Só no portal | Só no portal | Gerenciados no portal de desenvolvedores; o GET na API de bots funciona. Veja Emojis | |
| Registro de auditoria | Parcial | Parcial | Entradas relevantes para bots; o histórico de exceções por canal não é indexado | |
| Cabeçalhos de limite de taxa | Sim | Sim | X-RateLimit-* em cada resposta, com noção de bucket | |
| Interações | Comandos de aplicação (barra, usuário, mensagem) | Sim | Sim | PUT em lote + CRUD individual. Os comandos são registrados na nuvem para os dois tipos de servidor; invocações em servidores auto-hospedados são roteadas pela nuvem |
| Botões, seletores de string, modais (Componentes v1) | Sim | Sim | Respostas efêmeras também. Só em canais de servidor, não em DMs. Veja Componentes de mensagem | |
| Seletores de usuário, cargo, mencionável e canal | Parcial | Parcial | Aceitos e armazenados; os clientes os mostram desativados, então nunca geram uma interação | |
| Componentes v2 | Não | Não | Não suportados; componentes de layout da v2 não são exibidos | |
| Interações em modo HTTP (endpoint de saída) | Parcial | Parcial | Enviadas por POST para a sua interactions_endpoint_url com assinatura Ed25519, com fallback para o gateway se o endpoint falhar. Exige uma sessão de gateway conectada, e o corpo da resposta é ignorado: responda pelo endpoint de callback. Veja OAuth2 | |
| Voz | Gateway de voz por UDP | Sim | Sim | Por região. Veja a documentação de voz |
| AEAD AES-256-GCM | Sim | Sim | Preferido | |
| AEAD XChaCha20-Poly1305 | Sim | Sim | Alternativa | |
| Alteração do estado de voz pelo bot | Sim | Parcial | Ambos: PATCH .../voice-states/{user_id} para silenciar / mover / desconectar. O auto-hospedado também aceita deaf, em qualquer combinação com uma movimentação; mover dispara dois eventos em vez de um | |
| Outros | Emojis de servidor (leitura) | Sim | Sim | Listar + obter; criar/alterar/excluir só pelo portal |
| Soundboard (leitura) | Sim | Sim | Listar + obter; reprodução pelo bot não é suportada | |
| URL personalizada | Parcial | Não | Nuvem: ler + alterar (servidores Gold ou acima). Auto-hospedado: o PATCH devolve 501 | |
| Tópicos / publicações de fórum | Parcial | Parcial | Publicações de fórum: criar uma (POST /channels/{forum}/threads), lê-la e responder nela. Os demais endpoints de tópicos (arquivamento, integrantes do tópico, tópicos ativos) não são suportados | |
| Eventos agendados | Sim | Parcial | CRUD e RSVP, mapeados para os eventos de servidor do GameVox. Sem eventos de gateway GUILD_SCHEDULED_EVENT_*. Auto-hospedado: eventos recorrentes são armazenados, mas as ocorrências seguintes não são geradas | |
| Canais de palco, AutoMod | Não | Não | Intents aceitos, sem eventos | |
| Apps Premium / entitlements | Não | Não | Sem camada de monetização na v1 | |
| Portal | Equipes (propriedade compartilhada) | Sim | Paridade com o Discord. Veja Equipes | |
| Transferência de app para equipe | Sim | Unidirecional (igual ao Discord) | ||
| Testadores do app (lista de permissão de instalação de apps privados) | Sim | 100 por app. Veja Equipes → Testadores | ||
| URLs de instalação OAuth2 (contextos de usuário + servidor) | Sim | Nenhuma / fornecida pelo GameVox / URL personalizada. Veja OAuth2 | ||
| Rotação do segredo de cliente | Sim | Com hash bcrypt; exibido uma vez na criação / rotação | ||
| Listagem no diretório de bots | Sim | Listagens aprovadas pela administração em gamevox.com/bots | ||
Legenda
- Sim: funciona igual ao Discord, sem mudanças de código.
- Parcial: compatível no transporte, mas falta parte da semântica. Pode ser chamado com segurança, mas talvez não gere eventos.
- Não: aceito no transporte (não dá 4014), mas não faz nada. Planeje como se não existisse.