Gå til hovedinnhold

Webhooks

Webhooks lar GamePanel sende sanntidsvarsler til eksterne tjenester når noe skjer på serveren din. Du kan motta varsler i Discord, Slack, Telegram eller en egendefinert HTTP-endepunkt.

Støttede destinasjoner

DestinasjonBeskrivelse
DiscordVarsler i en Discord-kanal via webhook-URL
SlackVarsler i en Slack-kanal via innkommende webhook
TelegramMeldinger til en Telegram-bot eller -gruppe
HTTPEgendefinert HTTP POST til valgfri URL

Hendelsestyper

GamePanel kan sende webhooks for 16 ulike hendelsestyper:

Serverhendelser

HendelseBeskrivelse
server.startedServeren har startet
server.stoppedServeren har stoppet
server.crashedServeren krasjet uventet
server.restartedServeren ble restartet
server.reinstalledServerfilene ble reinstallert

Backup-hendelser

HendelseBeskrivelse
backup.startedBackup har startet
backup.completedBackup fullført uten feil
backup.failedBackup feilet
backup.restoredBackup gjenopprettet
backup.deletedBackup slettet

Ressurshendelser

HendelseBeskrivelse
resource.cpu_highCPU-bruk overskrider terskelverdi
resource.memory_highMinnebruk overskrider terskelverdi
resource.disk_highDiskbruk overskrider terskelverdi

Sikkerhetshendelser

HendelseBeskrivelse
security.loginNy innlogging på kontoen
security.permission_changedTillatelser endret

Spillerhendelser

HendelseBeskrivelse
player.bannedSpiller ble bannet

Opprette en webhook

Discord-webhook

  1. I Discord: Kanalinnstillinger → Integrasjoner → Webhooks → Ny webhook
  2. Kopier webhook-URL-en
  3. I GamePanel: Gå til WebhooksNy webhook
  4. Velg Discord som destinasjon
  5. Lim inn webhook-URL-en
  6. Velg hendelsestyper du vil motta varsler for
  7. Klikk Test webhook for å verifisere
  8. Klikk Lagre

Slack-webhook

  1. I Slack: Apps → Incoming Webhooks → Add to Slack
  2. Velg kanal og kopier webhook-URL
  3. I GamePanel: Velg Slack som destinasjon
  4. Lim inn webhook-URL
  5. Konfigurer hendelsestyper og lagre

Telegram-webhook

  1. Opprett en bot via @BotFather i Telegram
  2. Kopier bot-tokenet
  3. Finn chat-ID til kanalen eller gruppen
  4. I GamePanel: Velg Telegram som destinasjon
  5. Fyll inn bot-token og chat-ID
  6. Konfigurer hendelsestyper og lagre

Egendefinert HTTP-webhook

  1. I GamePanel: Velg HTTP som destinasjon
  2. Angi URL-en til ditt endepunkt
  3. Velg HTTP-metode (POST anbefales)
  4. Legg eventuelt til tilpassede headere (f.eks. autentiseringstokener)
  5. Konfigurer hendelsestyper og lagre

Webhook-payload

Alle webhooks sender JSON-data med informasjon om hendelsen:

{
"event": "server.started",
"server": {
"name": "Min Minecraft-server",
"id": "abc123"
},
"timestamp": "2025-06-15T14:30:00Z"
}

Tilpassede HTTP-webhooks mottar hele payload-en og kan behandle den i sitt eget system.

Teste og feilsøke webhooks

  • Bruk Test webhook-knappen for å sende en testmelding
  • Se Webhook-logg for historikk over sendte webhooks og eventuelle feil
  • Vanlige feil: feil URL, utgått webhook-token, nettverk-timeout

Administrere webhooks

  • En server kan ha opptil 10 aktive webhooks (avhenger av lisenstier)
  • Deaktiver webhooks midlertidig uten å slette dem
  • Rediger destinasjon og hendelsestyper uten å opprette ny webhook