Documentación

Alertas de Discord: alertas de Pingsured en un canal

Pingsured puede publicar una alerta en un canal de Discord cuando un ping empieza a fallar, cuando se recupera y cuando se sustituye su certificado. Es un webhook que habla Discord: le das a Pingsured la URL de un webhook de Discord y cada alerta llega como un mensaje a ese canal. Las alertas de Discord están disponibles en los mismos planes que los webhooks, todos los planes de pago. Las configura un propietario o gestor de la cuenta, para un solo ping o como valor predeterminado de todos los pings de la cuenta.

Qué necesitas

  • Un servidor de Discord en el que puedas gestionar webhooks (el permiso Gestionar webhooks) y el canal al que deben ir las alertas. Un webhook publica en un solo canal; para avisar en un segundo, crea un segundo webhook.

Crea el webhook en Discord

  • En Discord abre los ajustes del canal (la rueda dentada junto a su nombre), ve a Integraciones, luego a Webhooks, y elige Nuevo webhook.
  • Ponle un nombre y, si quieres, un icono, por ejemplo Pingsured, y comprueba que el canal es el correcto.
  • Elige Copiar URL del webhook. Tiene este aspecto: https://discord.com/api/webhooks/…/….

Discord cambia de vez en cuando los nombres de sus menús. Lo que Pingsured necesita es la URL de un webhook.

Trata la URL como un secreto: quien la tenga puede publicar en ese canal. Pingsured solo la muestra completa a propietarios y gestores. Si se filtra, borra el webhook en Discord y crea otro.

Añádelo en Pingsured

  • Para todos los pings, abre Ajustes → Notificaciones, ve a Integraciones en Notificaciones predeterminadas y elige la tarjeta Discord.
  • Para un ping, abre el ping, ve a su sección Notificaciones, elige Añadir suscripción y selecciona Discord.

Pega la URL del webhook entera, con el token. Pingsured solo acepta las direcciones que tienen los webhooks de Discord (en discord.com, bajo /api/webhooks/), así que una URL de otro servicio, o una cortada antes del token, se rechaza al guardar. Después elige los disparadores. El conjunto recomendado es Primer error y Primer ok, con Certificado cambiado si compruebas certificados: te enteras cuando algo se rompe y cuando se arregla.

Elige Enviar prueba junto al canal para publicar un mensaje marcado como prueba. Es la forma más rápida de saber que la URL y el canal son correctos antes de que una alerta dependa de ellos.

Cómo es un mensaje

  • Un mensaje con una barra de color y un titular formado por el nombre del ping y un punto que indica su estado: rojo si falla, amarillo si está degradado, verde si se ha recuperado.
  • El motivo, cuando lo hay: el estado HTTP, el error o por qué falló una comprobación de contenido.
  • Desde dónde se vio: o bien la ubicación, como Desde de, o, en un ping comprobado desde varias, cuáles fallan, como Fallando desde de, sg (2 de 3 ubicaciones).
  • Un enlace, Ver ping en Pingsured, que abre el ping.

Un cambio de certificado dice Certificado cambiado en el ping, o Certificado inesperado en él cuando algo del cambio no parece una renovación, con los motivos debajo.

Los mensajes no avisan a nadie con menciones: un ping llamado @everyone, o un texto de error con una mención, se muestra como texto y no notifica a nadie más allá de lo que haga el propio canal con un mensaje nuevo.

El idioma de los mensajes

Los mensajes se escriben en el idioma de las notificaciones de la cuenta, que un propietario fija en Ajustes → Cuenta. Los mensajes existen en inglés, alemán, español, francés e italiano. Hasta que se fija, están en inglés. El mismo ajuste es el idioma de reserva de los correos de alerta a los miembros que no han elegido uno propio. La línea del motivo se muestra tal como la informó el servicio comprobado, en el idioma que sea.

Cuándo se envían los mensajes

Un canal de Discord sigue las mismas reglas que cualquier otro canal de alertas: qué cambios, cuántos fallos primero, con qué frecuencia y desde dónde se describen en la página de notificaciones. Un cambio de estado se envía siempre al instante, y las alertas repetidas del mismo ping y canal se retienen 15 minutos.

Si un mensaje no llega

Cuando no se puede alcanzar Discord, limita la petición o responde con un error que puede pasar, el envío se reintenta, 5 intentos en total, separados por 30 segundos, 5 minutos, 30 minutos y 2 horas. Cualquier otra respuesta es definitiva, y Pingsured muestra lo que dijo Discord al pasar el ratón por la insignia de estado junto al canal en Ajustes → Notificaciones. La habitual es Unknown Webhook: el webhook se borró en Discord. La solución es un webhook nuevo: créalo en Discord, añádelo en Pingsured y elimina el antiguo.

Límites

  • Los canales de Discord cuentan con los webhooks para los mismos límites: 50 en toda la cuenta y 20 en un ping.
  • Los mensajes se publican con el nombre y el icono que tiene el webhook en Discord. Las menciones y los mensajes directos aún no están disponibles.