Criar um Webhook do Discord

Entregue cópias com o nome e o avatar do autor original, crie um webhook ou teste a entrega por webhook com seu bot do Discord existente.

Um webhook do Discord permite que o ForwardMsg envie mensagens copiadas para um canal de texto do Discord usando o nome e a foto do perfil do autor original. Por exemplo, uma mensagem de Maya chega com o nome e a foto de Maya, e a próxima mensagem de Tom chega com os de Tom.

Essa costuma ser a maneira mais simples de entregar cópias no Discord: você não precisa criar nem convidar um bot. Você não precisa de um token de bot. Você não precisa configurar intents nem permissões de bot. Crie o webhook no canal de destino e cole a URL dele no ForwardMsg.

Um webhook envia mensagens; ele não lê os chats de origem. Sua conta ou seu bot conectado faz essa leitura. Cada webhook pertence a um canal de destino, mas você pode adicionar outros destinos à mesma automação.

Webhook ou bot do Discord?

O que você quer	Webhook do Discord	Bot do Discord sem modo de webhook
Usar o nome e a foto de cada autor original	Sim, eles podem mudar a cada mensagem copiada.	As cópias usam o nome e a foto do próprio bot.
Configurar a entrega	Crie um webhook e cole a URL dele. Não é preciso configurar um bot.	Crie ou conecte um bot, convide-o e conceda acesso ao canal.
Enviar texto, imagens, vídeos e arquivos	Sim, com os recursos de mídia ativados e dentro do limite de upload.	Sim, com os recursos de mídia e as permissões de arquivo ativados, e dentro do limite de upload.
Espelhar edições e exclusões	Sim, para mensagens que o ForwardMsg já copiou, quando essas opções estão ativadas.	Sim, quando essas opções estão ativadas.
Manter respostas nativas e espelhar fixações e desafixações	Não.	Sim, com as permissões relevantes e as opções de espelhamento ativadas.

Escolha um webhook quando quiser que as cópias se pareçam com a conversa original. Escolha um bot do Discord quando precisar das respostas nativas do Discord ou do espelhamento de fixações e desafixações. Consulte Ações de sincronização e espelhamento para ver essas opções.

Testar webhooks com seu bot existente

Já entrega mensagens por um bot do Discord? Mantenha esse bot e os destinos atuais de Roteamento. Você não precisa criar um webhook manualmente nem substituir os canais de destino para testar:

No Discord, conceda ao seu bot existente a permissão Gerenciar Webhooks em cada canal de destino. Abra Configurações do servidor → Cargos para editar o cargo do bot, ou Editar canal → Permissões para permitir o acesso em um canal específico. Mantenha as permissões de encaminhamento existentes e confira se as regras do canal não estão negando o acesso.
No ForwardMsg, abra a automação e clique no chat de origem na lista à esquerda do editor para abrir as configurações dele.
Abra Avançado → Enviar usando o nome e foto do autor.
Ative Ativar webhooks.
Selecione Salvar Alterações. Se o ForwardMsg exibir um aviso para reiniciar, reinicie a automação.
Confira a próxima mensagem nova copiada do chat de origem: ela deverá usar o nome e a foto do autor original, a menos que você tenha definido uma substituição personalizada do autor.

O ForwardMsg usa seu bot para criar ou gerenciar automaticamente o webhook do canal de destino. Seu bot salvo e o Roteamento continuam iguais; somente a forma como as cópias são publicadas muda. Para voltar à entrega normal por bot, desative Ativar webhooks e salve novamente.

Use Configurações Globais em vez de selecionar um chat de origem se quiser que outros chats herdem essa configuração. Consulte Como as configurações funcionam para entender as substituições específicas de cada chat.

Use a entrega normal por bot para respostas e fixações

Enquanto esse modo estiver ativado, as cópias poderão usar o nome e a foto do autor original, mas as respostas nativas e o espelhamento de fixações e desafixações ficarão indisponíveis. Mantenha a entrega normal por bot nos roteamentos que precisam dessas ações.

Use essa configuração em um canal de texto comum. Para uma thread ou uma publicação dentro de um canal de fórum ou de mídia, mantenha a entrega por bot.

A próxima seção mostra a alternativa: criar você mesmo um webhook, sem usar um bot.

Criar e salvar o webhook

Você, ou a pessoa que vai criá-lo para você, precisa da permissão Gerenciar Webhooks no canal de destino do Discord. Você não precisa ser o proprietário do servidor. Você não precisa conceder a permissão Administrador a um bot. Se os controles de Webhooks não aparecerem, peça a um administrador do servidor para conceder o acesso ou criar o webhook para você. O Discord exige essa permissão para criar um webhook.

No Discord, abra as configurações do canal de texto de destino. Para essa configuração, use um canal de texto comum, não uma thread nem uma publicação de fórum ou de mídia.
Abra Integrações → Webhooks.
Selecione Novo Webhook (ou a opção equivalente atual).
Dê a ele um nome fácil de reconhecer.
Confirme que ele pertence ao canal em que você quer receber as cópias.
Selecione Copiar URL do Webhook. Mantenha-a em sigilo: qualquer pessoa com a URL poderá conseguir publicar nesse canal.
No ForwardMsg, clique no chat de origem monitorado na lista à esquerda para abrir as configurações dele.
Abra Roteamento.
Selecione Adicionar Webhook do Discord para adicionar uma linha de destino por webhook.
Abra o seletor de webhook dessa linha e escolha Adicionar Webhook do Discord. Se o webhook já estiver salvo, selecione-o e pule para salvar as alterações.
Cole a URL e selecione Adicionar.
Mantenha ou altere o nome dele no ForwardMsg. Selecione Salvar se tiver alterado o nome ou Fechar para mantê-lo.
Confirme que o webhook está selecionado na linha de Roteamento e selecione Salvar Alterações. Se o ForwardMsg exibir um aviso para reiniciar, reinicie a automação antes de testar a entrega.

Confira o canal de destino quando a próxima mensagem nova for copiada do chat de origem. Ativar webhooks não é necessário para um destino adicionado com Adicionar Webhook do Discord; essa opção é para destinos de bot.

Opções avançadas

Quer que todas as cópias usem sua própria marca em vez da identidade do autor original? Clique no chat de origem na lista à esquerda para abrir as configurações dele e, em seguida, abra Roteamento → Substituição do Autor do Webhook. Defina Nome do Autor Personalizado, como Novidades da Comunidade, e URL do Avatar Personalizado, como um link para seu logotipo. Depois, selecione Salvar Alterações.

Sem uma substituição personalizada, as cópias usam o nome e a foto do autor original. Um campo vazio ainda pode herdar um valor personalizado de Configurações Globais ou de um chat pai; confira essas configurações também se as cópias continuarem mostrando um nome ou uma foto fixa. Consulte Como as configurações funcionam.

Essas configurações alteram a identidade das cópias entregues por webhook; elas não renomeiam seu bot do Discord. Consulte nome e imagem personalizados do webhook.

Limites de upload de webhooks

O limite de upload é por arquivo, não pelo total que sua automação pode encaminhar. O ForwardMsg usa um limite padrão de 10 MB quando nenhum limite maior é detectado para webhooks do Discord. Quando o limite de upload do servidor está disponível por meio de um bot conectado, o ForwardMsg pode usar automaticamente esse limite mais alto detectado.

Para um webhook que você adicionou por URL, use Aumento de Upload Webhook para corresponder ao nível de boost compatível com o servidor de destino:

Para conferir o nível, o proprietário do servidor ou um administrador pode abrir Boosts do Servidor no topo da lista de canais do Discord e consultar o nível atual e os benefícios ativos. Se você não tiver acesso, peça que confirmem o nível do servidor de destino antes de escolher uma substituição.

Limite de upload a usar	Configuração no ForwardMsg	Limite do ForwardMsg por arquivo
Padrão, quando nenhum limite superior é detectado	Nenhuma substituição de Aumento de Upload, inclusive por configurações herdadas.	Limite padrão de 10 MB.
Boost nível 2	Ativar Aumento de Upload → Nível 2.	50 MB.
Boost nível 3	Ativar Aumento de Upload → Nível 3.	100 MB.

Abra a automação e clique no chat de origem cujos arquivos você quer encaminhar na lista à esquerda para abrir as configurações dele.
Abra Avançado → Aumento de Upload Webhook.
Ative Ativar Aumento de Upload.
Selecione o Nível de Boost que o servidor de destino realmente possui.
Selecione Salvar Alterações. Se o ForwardMsg exibir um aviso para reiniciar, reinicie a automação.

Você também pode definir isso em Configurações Globais para os chats que herdam essa configuração. Desativá-la em um chat limpa a substituição desse chat; um nível de boost definido em Configurações Globais ou em um chat pai ainda pode ser aplicado. Consulte a configuração herdada em Como as configurações funcionam se quiser voltar ao limite padrão.

Por exemplo, um vídeo de 20 MB ultrapassa o limite padrão de 10 MB. Se o servidor de destino tiver Boost nível 2, selecione Nível 2 para que o ForwardMsg possa enviar o vídeo usando o limite de 50 MB desse servidor. O recurso de vídeo também precisa estar ativado em Opções de Encaminhamento.

Essa configuração não compra nem aumenta o limite de upload do Discord

Escolher o nível 3 não dá um limite de 100 MB a um servidor sem boost. Seu limite pessoal do Nitro também não aumenta o limite do webhook. Use o limite real do servidor de destino; o Discord pode rejeitar um arquivo que o ultrapasse.

A configuração de boost de um chat de origem se aplica a todos os destinos de webhook dele, não individualmente a cada servidor de destino. Escolha um nível compatível com todos eles. Configurações separadas por chat só ajudam quando esses chats de origem têm destinos diferentes.

Os limites dos níveis 2 e 3 estão listados nas Perguntas frequentes sobre Boost de servidor do Discord. Consulte limites de upload e Aumento de Upload Webhook para obter mais detalhes.

Se o webhook parar de entregar mensagens

Um webhook adicionado manualmente: confira se ele ainda existe no canal de destino e se o destino de Roteamento usa o webhook salvo correto. Se tiver sido excluído, crie e salve um substituto. Se a URL tiver sido exposta, exclua esse webhook e substitua-o; não compartilhe a URL com o suporte nem em mensagens públicas.
Modo de webhook com um bot: confira se o bot tem a permissão Gerenciar Webhooks nesse canal específico, além do acesso existente ao canal e das permissões de encaminhamento.
Somente arquivos grandes falham: confira o tamanho do arquivo, o nível de boost do servidor de destino e a opção Aumento de Upload Webhook acima.

Para ver os controles de webhook do Discord, consulte Introdução aos Webhooks. Para problemas de acesso ao canal, consulte Permissões de entrega.