Discord - Documentação do PostRite

Como funciona

O PostRite oferece duas formas de conectar ao Discord, cada uma adequada a um caso de uso:

Integração de bot (OAuth): autorize o bot do PostRite no seu servidor. Assim você escolhe qualquer canal de texto por publicação e gerencia vários servidores com uma única conexão.
Webhook: cole a URL de um webhook para publicar em um canal específico. Configuração rápida, sem permissões de bot, ideal para uso em um único canal.

Qual método devo usar?

Use a integração de bot se você quer publicar em vários canais ou gerenciar vários servidores. Use o webhook se só precisa publicar em um canal específico com o mínimo de configuração.

Opção 1: Integração de bot (OAuth)

A integração de bot oferece total flexibilidade — selecione qualquer canal de texto por publicação e gerencie vários servidores.

Adicionar o bot ao seu servidor

Acesse a página Plataformas no PostRite
Clique em Conectar no cartão do Discord
Mude para a aba Bot
Clique em Adicionar bot ao servidor — você será redirecionado ao Discord para selecionar um servidor e conceder as permissões (Enviar mensagens, Inserir links, Anexar arquivos)
Depois que o bot for adicionado, clique em Autorizar conta para vincular sua identidade do Discord via OAuth
Selecione qual servidor conectar na lista de servidores em que o bot está instalado

Seleção de canal por publicação

Com a integração de bot, você escolhe o canal de destino ao criar cada publicação — não é preciso criar conexões separadas por canal. Os canais em que o bot não consegue publicar aparecem na lista, esmaecidos e com a permissão que falta — dê a ele <strong>Ver Canal</strong> e <strong>Enviar Mensagens</strong> nesse canal no Discord para liberar.

Opção 2: Webhook

Webhooks são a forma mais simples de publicar em um único canal do Discord. Cada webhook aponta para um canal específico.

Criar um webhook

Abra o Discord e acesse seu servidor
Clique com o botão direito no canal em que você quer publicar
Selecione Editar canal
Acesse Integrações → Webhooks
Clique em Criar webhook
Dê um nome a ele (ex.: "PostRite")
Copie a URL do webhook

Conectar o webhook

Acesse a página Plataformas no PostRite
Clique em Conectar no cartão do Discord
Permaneça na aba Webhook
Cole a URL do webhook que você copiou
Dê um nome à conexão (ex.: "Canal de anúncios")
Clique em Conectar para salvar

Vários canais

Você pode criar várias conexões de webhook para canais diferentes do seu servidor.

Recursos compatíveis

Mensagens de texto com até 2.000 caracteres
Formatação em Markdown
Embeds com conteúdo rico
Anexos de imagem
Nome de usuário e avatar personalizados por mensagem
Publicação agendada

Formatação de mensagens

O Discord aceita formatação em markdown:

Formato	Sintaxe
Negrito	texto
Itálico	texto
Tachado	~~texto~~
Código	`código`
Bloco de código	```código```
Citação	> texto

Identidade do webhook

As publicações enviadas por uma conexão de webhook podem substituir o nome de usuário e o avatar exibidos pelo webhook em cada publicação — defina ambos nas opções do Discord no editor de publicações. Publicações via bot sempre usam a identidade do próprio bot.

Embeds

O PostRite oferece suporte a embeds do Discord para uma apresentação mais rica do conteúdo (por enquanto disponíveis ao criar publicações via API ou integrações MCP — o editor visual envia texto e anexos de mídia):

Título e descrição
Cor personalizada
Imagem em miniatura
Campos com opção inline
Texto de rodapé
Carimbo de data e hora

Boas práticas

Bot para múltiplos canais: use a integração de bot quando precisar publicar em muitos canais ou servidores
Webhooks pela simplicidade: use webhooks quando publicar sempre no mesmo canal com o mínimo de configuração
Nomes descritivos: use nomes de conexão descritivos para identificar a origem do conteúdo
Use embeds: embeds se destacam mais do que texto simples
Horários consistentes: publique em horários regulares para engajar a comunidade

Solução de problemas

Quando uma mensagem falha, o PostRite mostra o motivo específico na publicação com falha (ex.: o webhook não existe mais, permissões insuficientes ou limite de requisições atingido) em vez de um erro genérico.

A mensagem não é enviada (Webhook)

O webhook pode ter sido excluído — o PostRite reporta isso como o destino não existe mais; crie um novo webhook e atualize a conexão
A mensagem passa de 2.000 caracteres
O embed excede os limites do Discord
Limite de requisições atingido — o PostRite tenta novamente de forma automática

A mensagem não é enviada (Bot)

O bot pode ter sido removido do servidor — adicione-o novamente
O bot não tem permissão para publicar no canal selecionado — o seletor de canais marca esses casos, então isso só acontece se as permissões mudarem depois do agendamento
O canal foi excluído ou ficou privado sem acesso para o bot
O token expirou — reconecte sua conta do Discord

Segurança do webhook

Mantenha as URLs dos seus webhooks em sigilo. Qualquer pessoa com a URL pode publicar mensagens no seu canal. Em caso de vazamento, exclua o webhook e crie um novo.

Não vejo meu servidor na lista (Bot)

Só aparecem os servidores em que você tem permissão de Administrador ou Gerenciar servidor e nos quais o bot do PostRite já está instalado. Certifique-se de ter adicionado o bot primeiro usando o botão "Adicionar bot ao servidor".

Nome de usuário/avatar errado sendo exibido

O nome e o avatar padrão do webhook podem ser alterados no Discord. O PostRite também pode substituí-los por mensagem nas configurações da publicação.