Canais fórum do Discord permitem organizar discussões por tópicos usando tags. Ao criar um canal fórum via API com um bot, você pode aplicar tags automaticamente a novos posts. Isso economiza tempo de moderação manual e mantém as threads organizadas desde o início. Este artigo explica como usar a API do Discord Bot para criar um canal fórum e aplicar tags durante a criação do post.

Principais Pontos: Criação de Canal Fórum do Discord Bot e Aplicação de Tags

POST /channels/{channel.id}/threads: Cria um post no fórum com o array opcional applied_tags contendo IDs das tags.
GET /guilds/{guild.id}/channels: Recupera detalhes do canal fórum, incluindo as definições de tags disponíveis com seus IDs.
PATCH /channels/{channel.id}/messages/{message.id}: Atualiza as tags de um post existente após a criação.

Visão Geral da API de Canal Fórum do Discord

Canais fórum do Discord são um tipo especial de canal projetado para discussões organizadas. Cada canal fórum possui um conjunto de tags predefinidas que moderadores ou usuários podem aplicar às threads. Ao criar uma thread em um canal fórum via API, você pode especificar quais tags aplicar incluindo o campo applied_tags no corpo da requisição. As tags são identificadas por seus IDs únicos, que você deve recuperar dos metadados do canal fórum.

Antes de usar a API, certifique-se de que seu bot tenha as permissões necessárias: CREATE_POSTS e MANAGE_THREADS no canal fórum. Você também precisa da permissão Send Messages no canal. O bot deve ser membro do servidor e ter o token de bot apropriado com o escopo bot.

Como as Tags Funcionam em Canais Fórum

As tags são definidas no nível do canal fórum. Cada tag tem um nome, um emoji (opcional) e um ID único. Quando um usuário cria um post, ele pode selecionar até 5 tags. A API replica esse comportamento: você pode aplicar até 5 tags por criação de thread. As tags ajudam a categorizar os posts para facilitar a busca e filtragem.

Passos para Criar um Post no Fórum com Tags Usando a API do Discord

Os passos a seguir assumem que você tem um bot do Discord configurado com as permissões necessárias e um token de bot válido. Você usará requisições HTTP para interagir com a API do Discord.

Recupere o ID do Canal Fórum e as Definições das Tags
Envie uma requisição GET para https://discord.com/api/v10/guilds/{guild.id}/channels. Isso retorna todos os canais do servidor. Encontre o canal fórum verificando o campo type (valor 15 para canais fórum). O objeto do canal contém um array available_tags com o id e name de cada tag. Anote o ID do canal e os IDs das tags que deseja aplicar.
Crie o Post no Fórum
Envie uma requisição POST para https://discord.com/api/v10/channels/{channel.id}/threads com o seguinte corpo JSON:
```
{
  "name": "Título do Seu Post",
  "message": {
    "content": "Conteúdo inicial do post aqui"
  },
  "applied_tags": ["tag_id_1", "tag_id_2"]
}
```
Inclua o array applied_tags com até 5 IDs de tags. A API retorna o objeto da thread criada, incluindo as tags aplicadas.
Verifique se as Tags Foram Aplicadas
Confira a resposta da requisição POST. O campo applied_tags no objeto da thread retornado deve conter os IDs de tags que você enviou. Se o array estiver vazio ou contiver tags diferentes, verifique os IDs das tags e se elas ainda estão disponíveis no canal fórum.
Atualize Tags em um Post Existente (Opcional)
Se precisar alterar as tags após a criação, envie uma requisição PATCH para https://discord.com/api/v10/channels/{channel.id}/messages/{message.id} (a primeira mensagem na thread) com um corpo como {"applied_tags": ["novo_tag_id"]}. Isso substitui todas as tags existentes pelo novo array.

Problemas Comuns ao Aplicar Tags via API

Tags Não Aplicadas Apesar de IDs Corretos

Se a API retornar 201 Created mas as tags estiverem ausentes, verifique se os IDs das tags são válidos e pertencem ao mesmo canal fórum. Certifique-se também de que seu bot tenha a permissão MANAGE_THREADS nesse canal específico. O campo applied_tags é opcional; se omitido, nenhuma tag é aplicada.

API Retorna 400 Bad Request

Um erro 400 geralmente indica IDs de tags inválidos ou muitas tags. Você pode aplicar no máximo 5 tags por post. Verifique se cada ID de tag é uma string de números e se a tag existe no array available_tags do canal. Certifique-se também de que o corpo da requisição é um JSON válido.

Bot Não Consegue Ver o Canal Fórum

Se o bot não encontrar o canal fórum, verifique se ele tem a permissão View Channels nesse canal. Confirme também que o bot é membro do servidor. Use o endpoint GET guilds/{guild.id}/channels para verificar se o canal aparece na resposta.

Item	POST /channels/{channel.id}/threads	PATCH /channels/{channel.id}/messages/{message.id}
Propósito	Criar um novo post no fórum com tags	Atualizar tags em um post existente
Campo do corpo da requisição	`applied_tags` array de IDs de tags	`applied_tags` array de IDs de tags
Máximo de tags	5	5
Permissões necessárias	CREATE_POSTS, MANAGE_THREADS, Send Messages	MANAGE_THREADS
Resposta	Objeto da thread com tags aplicadas	Objeto da mensagem atualizada

Agora você pode criar posts no fórum com tags específicas usando a API do Discord Bot. Comece recuperando os IDs das tags do seu canal fórum, depois inclua-os no array applied_tags durante a criação da thread. Para automação avançada, considere usar o campo auto_archive_duration para arquivar threads automaticamente após um tempo definido. Isso mantém seu fórum organizado sem intervenção manual.

← Voltar ao Início Mais em Windows & PC