Un webhook publica un mensaje corto en un canal de Discord cuando pasa algo en tu servidor: se inicia, se detiene o se cae, entra o sale un jugador, o termina un backup. Todos los del canal lo ven sin abrir el panel. Un webhook también puede enviar a cualquier otra dirección https, para tus propias herramientas.
Solo el propietario de un servidor puede configurar sus webhooks. Las personas a las que invitaste al servidor no ven la página.
1. Crea un webhook en Discord
Necesitas permiso para gestionar webhooks en el servidor de Discord. Su propietario y los administradores normalmente lo tienen.
- En Discord, abre Ajustes del servidor y ve a Integraciones.
- Haz clic en Crear webhook, ponle un nombre y elige el canal de texto en el que publica, por ejemplo un canal
#server-alerts. - Haz clic en Copiar URL del webhook.
Discord explica estos pasos con imágenes en su guía Intro to Webhooks. Trata la URL del webhook como una contraseña: cualquiera que la tenga puede publicar en ese canal.
2. Añádelo a tu servidor
- Abre tu servidor en el panel y haz clic en Webhooks en el menú de la izquierda.
- Haz clic en Añadir uno, o en Webhook nuevo si el servidor ya tiene uno.
- Ponle un Nombre si quieres. Es solo para ti y etiqueta el webhook en tu lista.
- Pega la dirección en URL. Tiene que empezar por
https://. Cuando es un webhook de Discord, el panel muestra Webhook de Discord reconocido. - En Enviar cuando, marca los eventos que quieras (mira más abajo). Servidor caído viene marcado al principio, y hay que marcar al menos uno.
- Haz clic en Crear webhook.
Los eventos
| Evento | Cuándo se envía |
|---|---|
| Servidor iniciado | Cuando el servidor está activo y listo para los jugadores, también después de un reinicio. |
| Servidor detenido | Una detención que alguien pidió: tú, un miembro del equipo o una programación. |
| Servidor caído | El servidor se cayó sin que se lo pidieran. Se envía uno o dos minutos después, cuando estamos seguros, e indica si el servidor volvió a levantarse solo. |
| Jugador conectado | Con el nombre del jugador, en los juegos que informan de quién está conectado. Los juegos que solo informan de una cifra dicen cuántos. |
| Jugador desconectado | Lo mismo, cuando alguien sale. Los jugadores se comprueban una vez por minuto mientras el servidor está en marcha. |
| Backup terminado | Si el backup salió bien y cuánto ocupa. |
| Instalación terminada | Tras la primera instalación o una reinstalación. |
| Transferencia terminada | Cuando termina un traslado de tu servidor. |
Los servidores de Project Zomboid tienen eventos extra que se leen del log del juego: Un jugador murió, Muerte en PvP, Acción de admin, Mod actualizado, Empezó la cuenta atrás del reinicio y Reenviar el chat del juego. El chat solo se envía si lo marcas, y solo el chat general: los susurros y el chat de facción y de refugio nunca se envían.
Qué llega
- En Discord, los mensajes llegan de PlayNHost como tarjetas breves con el nombre del servidor, qué pasó y cuándo. Discord muestra la hora en la zona horaria de cada lector.
- Los mensajes nombran tu servidor, pero nunca incluyen su dirección ni su ID, así que pueden ir a un canal público. Para cambiar el nombre que muestran, renombra el servidor. Mira Cómo cambiar el nombre de tu servidor y los slots de jugadores.
- Un jugador no puede mencionar a todo tu canal con su nombre. Un nombre como
@everyonellega como texto normal. - Cualquier otra dirección recibe los eventos como JSON. Mira Para tus propias herramientas más abajo.
Desactiva un webhook, cámbialo o elimínalo
- Usa el interruptor de la fila de un webhook para desactivarlo y volver a activarlo. Conserva sus ajustes mientras está desactivado.
- Abre el menú de la fila y elige Editar para cambiar el nombre, la dirección o los eventos, o Eliminar para quitarlo. Nada más se ve afectado: tu servidor sigue en marcha y el canal simplemente deja de recibir mensajes.
Conviene saber
- Un servidor puede tener hasta 10 webhooks, por ejemplo uno por canal.
- Para que un canal siga siendo legible, cada webhook envía como máximo 4 mensajes por minuto y 40 por hora. Los mensajes que pasan de ese límite se omiten en lugar de enviarse tarde, y el siguiente mensaje dice cuántas actualizaciones anteriores se omitieron.
- Si el webhook se elimina en Discord, el panel lo desactiva solo la próxima vez que intenta enviar, y la fila muestra Desactivado. Crea un webhook nuevo en Discord, elige Editar, pega la dirección nueva y vuelve a activarlo.
- No hay botón de prueba. Para comprobar un webhook nuevo, marca Servidor iniciado y reinicia tu servidor. El mensaje llega poco después de que el servidor esté listo.
- Los webhooks son para un canal que comparte tu grupo. Para recibir alertas solo tú, en el panel o por correo, mira Cómo gestionar las notificaciones y las preferencias.
Para tus propias herramientas
Una dirección que no es un webhook de Discord recibe un POST con un cuerpo JSON:
sourceesPlayNHost.eventses una lista. Cada evento tiene untype(comoserver.crashoplayer.join),server(el nombre del servidor),at(cuándo ocurrió), untitley untextlegibles, y un objetodatacon los detalles.skippedes cuántos mensajes anteriores se dejaron fuera por el límite de arriba.
La dirección tiene que usar https y apuntar a una dirección pública de internet. No se siguen las redirecciones. Los mensajes no van firmados, así que mantén en secreto la propia dirección.
Relacionado
- Cómo ver qué ha pasado en tu servidor muestra quién inició, detuvo o cambió qué, y cuándo.
- Cómo arreglar un servidor que no arranca ayuda cuando una alerta de caída se repite.
