Los webhook integrados de Discord funcionan como una manera fácil de hacer que un canal de texto de tu servidor reciba mensajes automatizados e información sobre actualizaciones. Dicho de otro modo, serían como unos de esos tubos neumáticos tan cool que se usan en algunos bancos para enviar el dinero, pero, en lugar de verlo desaparecer, recibirás mensajes en Discord desde otra plataforma.
Al crear un destino de webhook en tu servidor de Discord, generarás una URL que puedes pegar en todo tipo de servicios para vincular ambos.
Sabemos que a todo el mundo le encantan los tubos neumáticos (100% confirmado), pero es importante tener en cuenta que los webhook requieren otro sitio web para poder utilizarse (aunque los usuarios más mañosos pueden hacer que su tubo termine en sí mismo). Algunos servicios y páginas web están diseñados de forma que se puedan incorporar webhook fácilmente y enviar mensajes a otras plataformas, pero otros, no. Aquí tienes una lista básica de referencia:
Permiten el uso de webhook: | No permiten el uso de webhook: |
GitHub | Twitch / YouTube |
CircleCI | Nelly The Hamster |
DataDog |
Crear un webhook
Teniendo esto en cuenta, si quieres actualizar tu servidor de Discord con peticiones de GitHub o rastrear analíticas de DataDog, por ejemplo, ¡podrás hacerlo de este modo!
1. Abre la pestaña de webhook desde tus Ajustes de servidor:
2. ¡Selecciona el botón verde para crear uno nuevo!
Aparecerán unas cuantas opciones:
- Editar el avatar: Para ello, pulsa el avatar que aparece junto al nombre arriba a la izquierda.
- Elegir en qué canal se publica el contenido del webhook: Elige un canal del menú desplegable para esto.
- Nombrar tu webhook: Esto es útil si utilizas varios para distintos servicios.
Ahora tendrás tu propia URL (o tubo neumático) para enlazar a los sitios web de los que quieres recibir mensajes.
Ejemplo fácil: Integración del webhook de GitHub
Puesto que los webhook no funcionan por sí mismos y necesitan estar enlazados a otro sitio web, vamos a incluir un ejemplo para los fans de GitHub. Puedes usar los webhook de Discord para enviar cambios de código o actualizaciones desde un repositorio a un canal de texto en tu servidor.
1. Crea la URL del webhook para el servidor/canal en el que quieras recibir mensajes:
En este servidor, hay un canal de texto llamado #actualizacionesgit. Quiero que éstas aparezcan por aquí, así que tomaré la URL del webhook para este canal concreto:
2. Añade la URL del webhook a tus ajustes de repositorio de GitHub:
Elige el repositorio del que te gustaría recibir actualizaciones en tu servidor. Puedes hacerlo desde el menú ajustes > webhook:
Genial. Pulsa en el botón «añadir webhook» e introduce la URL generada en Discord en el espacio correspondiente.
Para que el webhook muestre los mensajes como es debido, es EXTREMADAMENTE importante que añadas '/github' al final. Sí, es importante en mayúsculas.
Además de la URL, tienes algunas opciones específicas para GitHub. Para el tipo de contenido, recomendamos que mantengas app/json, porque al formato de los webhook de Discord le encanta JSON. En la sección siguiente, puedes personalizar qué tipo de eventos son los que generan la aparición de mensajes del webhook.
Por último, pulsa el botón «añadir webhook» bajo la opción de personalización de notificaciones, ¡y ya está! Cualquier tipo de actualización que haya en el repositorio (incluyendo la edición del archivo readme) aparecerá en tu canal de texto:
¡Eso es todo! Recuerda que GitHub es sólo un ejemplo de una integración que funciona con los webhook, pero si sabes acerca de la creación de apps en JSON o peticiones HTTP POST siempre puedes personalizar los tuyos propios; encontrarás más información al respecto en nuestra documentación para desarrolladores (en inglés).