Os Webhooks integrados do Discord são uma maneira fácil de enviar mensagens automatizadas e atualizações de dados para um canal de texto em seu servidor.

Pense neles como uma daquelas coisas extravagantes de tubo pneumático que você adorava enviar dinheiro para um banco e ver desaparecer, mas em vez de nunca mais ver seu dinheiro, você está enviando mensagens de outra plataforma para o Discord.

Ao criar um endpoint de webhook em seu servidor, você gerará uma URL de webhook que pode ser colocada em vários outros serviços diferentes para vincular os dois.

Enquanto todo o mundo ama tubos pneumáticos (100% verdade), é importante notar que os webhooks exigem outro site para usar (embora os usuários inclinados à programação possam fazer sua própria sonda de tubo). 

Alguns serviços e sites são criados para incorporar facilmente webhooks e enviar mensagens, mas outros não. Aqui está uma pequena lista de referência útil:

CRIANDO UM WEBHOOK

Com isso em mente, se você deseja atualizar seu servidor Discord com commits e pull requests do GitHub ou rastrear análises do DataDog ou algo semelhante, veja como!

1. Abra a guia do Webhook de Configurações do Servidor:
2. Clique no botão para criar um novo webhook!

Você terá algumas opções aqui. Você pode:

•  Editar o avatar: clicando no avatar ao lado do nome no canto superior esquerdo
• Escolher em qual canal o Webhook publica: selecionando o canal de texto desejado no menu suspenso;
• Dar um nome ao seu Webhook: bom para distinguir vários webhooks para vários serviços diferentes.

Agora você tem seu próprio URL acessível que você pode vincular a mais sites para receber mensagens. 

EXEMPLO RÁPIDO: INTEGRAÇÃO DO WEBHOOK DO GITHUB

Como os webhooks não podem funcionar sozinhos e precisam ser vinculados a outro site para funcionar como pretendido, achei que seria melhor incluir uma integração de exemplo para qualquer um de vocês entusiastas do GitHub.

Você pode usar os Webhooks do Discord para enviar qualquer mesclagem de código ou enviar atualizações em um repositório seu para um canal de texto em seu servidor.  

1. Obtenha o URL do webhook para o servidor/canal que você deseja receber mensagens:

No meu servidor, criei um canal de texto chamado #general-chat e eu quero que minhas atualizações de repositório postem mensagens aqui!

Então pegarei o URL do webhook para este canal:

2. Adicione o URL do webhook nas configurações do repositório do GitHub

CEscolha o repositório do qual você gostaria de obter atualizações em seu servidor Discord. Depois de selecionar o repositório, vá para o menu Configurações do Servidor > Webhooks:

Massa. Clique no botão "Adicionar Webhook" e insira a URL gerada pelo Discord no campo "Payload URL". 

Para fazer com que o webhook exiba as mensagens corretamente, é realmente muito muito muito importante que você acrescente '/github' no final dele.

Além do URL, você tem mais algumas opções específicas do GitHub para escolher. Para o tipo de conteúdo, fique com application/json. O formato de webhook do Discord realmente gosta de JSON. Na próxima seção, você pode optar por personalizar o tipo de evento que aciona as mensagens do webhook. 

Clique no último botão "Adicionar webhook" abaixo da opção de personalização de notificações de eventos e está tudo pronto! O envio de qualquer atualização no repositório (incluindo a edição do arquivo leia-me) aparecerá no seu canal de texto: 

E está tudo pronto! O GitHub é apenas um exemplo de integração que pode postar mensagens via webhook. Se você tem um talento especial para a criação de aplicativos JSON ou solicitações HTTP POST e deseja personalizar seus próprios webhooks, pode encontrar mais informações em nossa documentação para desenvolvedores.