Webhooks do Discord
Incluída no Macro DeckPublique mensagens ricas com embeds e menções em canais do Discord por webhooks, com uma prévia ao vivo.
A caixa de diálogo Adicionar um webhook do Discord com os campos Nome e URL do webhook
- Salve webhooks por nome, um por canal
- Editor visual com uma prévia igual ao Discord
- Até 10 embeds com campos, imagens, autor e rodapé
- Menções não notificam ninguém, a menos que você permita
- Variáveis de template são preenchidas quando a ação é executada
Um webhook do Discord permite que qualquer coisa que conheça a URL dele publique em um canal do Discord. A integração Webhooks do Discord salva webhooks com um nome e oferece uma ação, Enviar mensagem por webhook do Discord, com um editor visual para a mensagem. Ela não precisa do app do Discord nem de uma conta do Discord no computador em que o Macro Deck está rodando.
O que dá para enviar
O editor tem quatro abas:
- Mensagem: o texto da mensagem com Markdown do Discord e quebras de linha, além de botões que inserem uma menção a um usuário ou cargo,
@everyoneou@here. - Embeds: até 10 embeds, cada um com título e link do título, descrição, cor, data e hora, autor, rodapé, imagem, miniatura e até 25 campos que podem aparecer lado a lado.
- Perfil: um nome de usuário e um avatar para esta mensagem, no lugar dos do próprio webhook.
- Menções: quem pode ser notificado pelas menções da mensagem.
Por padrão, uma mensagem não notifica ninguém, mesmo quando menciona alguém, @everyone ou @here. A menção continua aparecendo no Discord, só não gera notificação. Todos os campos de texto aceitam variáveis de template, preenchidas quando a ação é executada, então uma mensagem pode trazer a cena, a música ou o número de espectadores atuais.
A prévia abaixo do editor muda enquanto você digita e mostra a mensagem do jeito que o Discord a desenha. Ela nunca envia nada ao Discord. As imagens aparecem como espaços reservados, e as variáveis aparecem como você as escreveu. Enviar mensagem de teste envia a mensagem ao Discord na hora, depois que você confirma com Enviar agora, para conferir como ela fica de verdade.
Alguns exemplos de uso:
- Um botão Ao vivo que publica um embed com o título e o link da sua live no canal de anúncios.
- Um botão que publica a música que está tocando em um canal de música.
- Uma automação que envia uma mensagem a um canal de moderadores quando algo acontece na sua live.
Webhooks salvos e URLs personalizadas
Adicione uma configuração por canal e escolha o webhook pelo nome em cada ação. Quando a URL muda, você a muda em um só lugar. Para uma mensagem avulsa, também é possível definir Webhook como URL personalizada e colar a URL na ação. O Macro Deck guarda cada URL de webhook criptografada, nunca a mostra de novo e nunca a grava no log.
O Macro Deck confere os limites do Discord antes de enviar, por exemplo 2000 caracteres de texto da mensagem e 6000 caracteres em todos os embeds juntos, e lista qualquer problema acima da prévia enquanto você edita. Quando o Discord limita com que frequência um webhook pode publicar, o Macro Deck espera e tenta mais uma vez se a espera for de 5 segundos ou menos.
O que é necessário
- Macro Deck 3 no Windows, macOS ou Linux
- Uma conexão com a internet no computador em que o Macro Deck está rodando
- Um canal do Discord em que você possa gerenciar webhooks, e a URL do webhook dele
Configuração
Passo 1: Crie um webhook no Discord
No Discord, abra as configurações do canal, vá em Integrações e depois em Webhooks, e crie um webhook ou escolha um existente. Clique em Copiar URL do webhook. A URL começa com
https://discord.com/api/webhooks/. Qualquer pessoa que a tenha pode publicar no canal, então trate-a como uma senha.Passo 2: Abra Webhooks do Discord no Macro Deck
No Macro Deck, clique em Integrações na barra lateral e depois em Webhooks do Discord. Na aba Visão geral, clique em Adicionar configuração na seção Configuração. Ativar a chave no canto superior direito abre a mesma caixa de diálogo.
Passo 3: Salve o webhook
Preencha a caixa de diálogo Adicionar um webhook do Discord:
- Nome: aparece quando você escolhe o webhook em uma ação, por exemplo o nome do canal.
- URL do webhook: a URL que você copiou no Discord.
Clique em Continuar. Adicione uma configuração para cada canal adicional.
Passo 4: Adicione a ação a um botão
Na página Deck, clique no botão que quer usar. O deck precisa estar desbloqueado: quando o botão no canto superior direito mostra Bloquear, ele está desbloqueado. O editor abre com Toque curto selecionado. Clique em + Adicionar ação, selecione Webhooks do Discord à esquerda da caixa de diálogo Adicionar ação e escolha Enviar mensagem por webhook do Discord.
Passo 5: Escreva a mensagem
Escolha o webhook salvo em Webhook. Escreva o Texto da mensagem na aba Mensagem e, se quiser, adicione embeds na aba Embeds. Confira a prévia e clique em Enviar mensagem de teste e Enviar agora para ver a mensagem no Discord.
Passo 6: Pressione o botão
Pressione o botão no celular, no tablet ou no cliente web. A mensagem aparece no canal do Discord, com as variáveis preenchidas. Se não aparecer, a ação mostra o motivo, por exemplo que o Discord rejeitou o token do webhook.
Ações1
Coloque estas ações em um botão ou execute-as a partir de um fluxo.
- Enviar mensagem por webhook do Discord
- Envia uma mensagem com embeds opcionais por um webhook do Discord salvo ou personalizado, editada com uma prévia ao vivo.
Perguntas frequentes
Como menciono um usuário ou um cargo?
Uma menção precisa do ID do Discord. No Discord, ative o Modo desenvolvedor nas configurações avançadas, depois clique com o botão direito no usuário ou cargo e escolha Copiar ID. Na aba Menções, escolha se ninguém, todos os mencionados ou só os IDs que você listar serão notificados.
Qual é a diferença para a integração Discord?
A integração Discord tem uma ação mais antiga, Executar webhook, com um embed e sem prévia. Ela continua funcionando. Webhooks do Discord acrescenta vários embeds, controle das menções, um perfil por mensagem e a prévia ao vivo.
Onde a URL do webhook fica guardada?
O Macro Deck a guarda criptografada no computador em que está rodando. Ela nunca é mostrada de novo, nunca é gravada no log e nunca faz parte da prévia. Para mudá-la, informe-a de novo. Só são aceitos endereços de webhook do Discord em discord.com, discordapp.com, ptb.discord.com e canary.discord.com.
Por que uma variável não é preenchida na minha mensagem de teste?
Enviar mensagem de teste envia as variáveis como foram escritas. Elas só são preenchidas quando a ação é executada por um botão, uma automação ou um script.
Por que a ação falha?
A ação mostra o motivo, por exemplo que a mensagem está vazia ou longa demais, que o webhook não existe mais no Discord, que o Discord rejeitou o token do webhook ou que o Discord está limitando a frequência do webhook. Se o token foi rejeitado, copie a URL do webhook de novo e informe-a na configuração.
Posso editar a mensagem no app Companion?
O app Companion e apps de desktop mais antigos mostram as configurações simples da ação, com a mensagem como chaves e valores, como content e embeds.0.title, e não salvam alterações feitas no editor visual. Edite mensagens ricas no app de desktop atual.
