Ao usar um webhook do Discord para enviar arquivos, você pode encontrar uma mensagem de erro informando que o arquivo é muito grande. Isso acontece porque o Discord impõe um limite de tamanho de upload específico para webhooks, que difere do limite para uploads diretos comuns. O limite depende do tipo de assinatura do Discord vinculada ao servidor onde o webhook foi criado. Este artigo explica os limites exatos de tamanho de arquivo para cada nível de assinatura, como verificar o limite para um webhook específico e o que fazer se o arquivo exceder o limite.
Os webhooks do Discord permitem mensagens automatizadas e uploads de arquivos de serviços externos como GitHub, Jenkins ou scripts personalizados. No entanto, o tamanho máximo de arquivo para um upload via webhook não é o mesmo que o limite de 25 MB para usuários gratuitos no chat. Entender essa distinção ajuda a evitar falhas de upload e planejar suas transferências de arquivos corretamente.
Principais Conclusões: Limites de Tamanho de Arquivo em Webhooks do Discord
- Servidores gratuitos (sem Nitro ou Server Boost): Tamanho máximo de arquivo por upload de webhook é 8 MB
- Server Boost Nível 1: Tamanho máximo de arquivo por upload de webhook é 50 MB
- Server Boost Nível 2: Tamanho máximo de arquivo por upload de webhook é 100 MB
- Server Boost Nível 3: Tamanho máximo de arquivo por upload de webhook é 100 MB
- Usuário Nitro Classic ou Nitro fazendo upload via webhook: Nenhum benefício extra — o nível de Boost do servidor determina o limite
Como Funcionam os Limites de Upload de Arquivo em Webhooks do Discord
Os webhooks do Discord funcionam como bots automatizados que podem postar mensagens e anexar arquivos a um canal de texto específico. O limite de tamanho de arquivo para um upload de webhook é determinado pelo nível atual de Server Boost do servidor, não pela assinatura Nitro do usuário. Este é um ponto comum de confusão, pois uploads de arquivos comuns em um chat são limitados pelo status Nitro de quem envia. Para webhooks, o proprietário ou administrador do servidor precisa impulsionar o servidor para aumentar o limite.
A tabela a seguir mostra os limites exatos de tamanho de upload para cada nível de Boost do servidor:
| Nível de Boost | Boosts Necessários | Limite de Upload de Webhook |
|---|---|---|
| Nenhum | 0 | 8 MB |
| Nível 1 | 2 boosts | 50 MB |
| Nível 2 | 7 boosts | 100 MB |
| Nível 3 | 14 boosts | 100 MB |
O limite se aplica ao tamanho total do arquivo de uma única execução de webhook. Se você enviar vários arquivos em uma chamada de webhook, o tamanho combinado não deve exceder o limite. O Discord não suporta uploads em partes ou uploads retomáveis para webhooks. Se o arquivo exceder o limite, o Discord retorna um código de status HTTP 413 Request Entity Too Large.
Como Verificar o Limite de Tamanho de Arquivo para um Webhook Específico
Você pode determinar o limite efetivo de tamanho de arquivo para um webhook verificando o nível de Boost do servidor. Siga estas etapas:
- Abra o servidor de destino no Discord
Selecione o servidor na barra lateral esquerda. Você precisa ter a permissão Gerenciar Servidor para visualizar as configurações do servidor. - Navegue até as Configurações do Servidor
Clique no nome do servidor no canto superior esquerdo e selecione Configurações do Servidor no menu suspenso. - Visualize o nível de Server Boost
Na barra lateral esquerda, clique em Server Boost. O nível atual aparece no topo da página. O número de boosts ativos e o nível (Nenhum, Nível 1, Nível 2 ou Nível 3) são exibidos. - Corresponda o nível ao limite de tamanho de arquivo
Use a tabela na seção anterior para encontrar o limite de upload de webhook correspondente. Por exemplo, se o servidor tiver Nível 2, o limite é 100 MB.
Como Aumentar o Limite de Upload de Arquivo do Webhook
Apenas Server Boosts aumentam o limite de tamanho de arquivo do webhook. Assinaturas Nitro individuais não afetam os limites do webhook. Para aumentar o limite, o servidor precisa de mais Boosts ativos:
- Compre ou receba Nitro Boosts
Usuários com assinatura Nitro podem impulsionar um servidor clicando no botão Boost no menu suspenso do servidor. Cada usuário pode contribuir com até 2 boosts por servidor (até 4 com Nitro Basic). - Atinga a contagem de Boost necessária
Para atingir o Nível 1, o servidor precisa de 2 boosts. O Nível 2 requer 7 boosts. O Nível 3 requer 14 boosts. O limite não aumenta além de 100 MB mesmo com mais de 14 boosts. - Verifique o novo limite
Após os boosts serem aplicados, verifique a página de Server Boost novamente para confirmar o novo nível. O limite do webhook é atualizado imediatamente.
Se você não puder impulsionar o servidor, considere compactar o arquivo antes de enviar. Use uma ferramenta como 7-Zip ou WinRAR para criar um arquivo compactado. Para imagens, reduza a resolução ou converta para um formato mais eficiente, como JPEG ou WebP.
O Que Acontece Quando Você Excede o Limite de Tamanho de Arquivo do Webhook
Quando seu arquivo excede o limite, o Discord rejeita o upload e retorna um erro. O comportamento exato depende de como você envia o webhook:
Usando um Script Personalizado ou Cliente de API
Se você enviar o webhook diretamente via HTTP POST usando uma ferramenta como curl ou Python requests, receberá uma resposta HTTP 413 Request Entity Too Large. O corpo da resposta contém um objeto JSON com uma mensagem de erro. Exemplo:
{
"code": 40005,
"message": "Request entity too large. Try uploading a file smaller than 8 MB"
}
Usando um Serviço de Terceiros ou Integração
Serviços como GitHub, GitLab ou Zapier que enviam arquivos via webhooks geralmente registram o erro. O arquivo não é entregue e o serviço pode mostrar uma notificação de falha. Verifique os logs do serviço para o código de erro 413.
Limitações e Casos Especiais
Várias limitações importantes afetam os uploads de arquivos via webhook:
Sem Uploads Retomáveis
Os webhooks do Discord não suportam uploads retomáveis. Se o upload falhar no meio do processo, você deve tentar novamente o arquivo inteiro. Para arquivos grandes, considere dividir o arquivo em partes menores e enviar cada parte separadamente usando várias chamadas de webhook.
Limites de Taxa se Aplicam
Os webhooks estão sujeitos aos limites de taxa do Discord. O limite padrão é de 30 requisições por minuto por webhook. Se você enviar muitos arquivos rapidamente, pode receber um erro 429 Too Many Requests. Implemente um atraso entre os uploads para permanecer dentro do limite.
Restrições de Tipo de Arquivo
O Discord não bloqueia tipos de arquivo específicos para uploads de webhook, mas algumas extensões de arquivo podem ser sinalizadas como inseguras. Arquivos executáveis (.exe, .msi, .bat) e arquivos compactados contendo executáveis são bloqueados. Se seu arquivo for bloqueado, renomeie a extensão ou compacte-o em um arquivo protegido por senha.
Comparação dos Limites de Upload de Arquivo do Discord
| Método de Upload | Usuário Gratuito | Nitro Classic | Nitro Completo |
|---|---|---|---|
| Upload direto no chat (usuário) | 25 MB | 50 MB | 500 MB |
| Upload via webhook (baseado no servidor) | 8 MB | 8 MB | 8 MB |
| Webhook com Server Boost Nível 1 | 50 MB | 50 MB | 50 MB |
| Webhook com Server Boost Nível 2/Nível 3 | 100 MB | 100 MB | 100 MB |
A diferença principal é que uploads diretos no chat dependem da assinatura Nitro do usuário, enquanto uploads via webhook dependem exclusivamente do nível de Boost do servidor. Um usuário com Nitro Completo não pode enviar um arquivo de 500 MB através de um webhook em um servidor sem Boost — o limite permanece 8 MB.
Agora você entende como funcionam os limites de upload de arquivo em webhooks do Discord e como eles se relacionam com os Server Boosts. Para enviar arquivos maiores através de um webhook, impulsione o servidor para o Nível 1 ou superior. Se não for possível impulsionar, compacte o arquivo ou divida-o em partes menores. Para arquivos que precisam permanecer grandes, considere usar um serviço de hospedagem de arquivos e enviar o link de download através do webhook.