Discord webhook – zprávy do kanálu bez bota

Webhook je adresa, na kterou pošleš zprávu a ta se objeví v Discord kanálu. Nepotřebuješ bota, token ani program, který pořád běží – hodí se na oznámení o zálohách, objednávkách nebo zprávy z kontaktního formuláře. Číst zprávy a reagovat na příkazy ale neumí, na to je potřeba bot.

1. Vytvoření webhooku

1. U kanálu klikni na ozubené kolečko (Upravit kanál) → Integrace → Webhooky.
2. Klikni na Nový webhook a nastav mu jméno, případně ikonu.
3. Klikni na Kopírovat URL webhooku.

Potřebuješ k tomu oprávnění Spravovat webhooky.

2. Odeslání zprávy

curl (Linux, VPS, cron):

curl -H "Content-Type: application/json" \
  -d '{"content": "Záloha je hotová."}' \
  "https://discord.com/api/webhooks/ID/TOKEN"

Node.js (od verze 18 má fetch vestavěný):

await fetch(process.env.WEBHOOK_URL, {
  method: 'POST',
  headers: { 'Content-Type': 'application/json' },
  body: JSON.stringify({ content: 'Nový hráč na serveru!' }),
});

Python (balíček requests):

import os, requests
requests.post(os.getenv("WEBHOOK_URL"), json={"content": "Server běží."})

Embed místo prostého textu

{
  "username": "Monitoring",
  "embeds": [{
    "title": "Záloha dokončena",
    "description": "Velikost: 1,2 GB",
    "color": 3066993
  }],
  "allowed_mentions": { "parse": [] }
}

color je barva zapsaná jako desítkové číslo. allowed_mentions s prázdným seznamem zabrání tomu, aby třeba text z formuláře označil @everyone.

Limity

• Text zprávy (content) má nejvýš 2000 znaků, jedna zpráva unese až 10 embedů.
• Při příliš častém posílání vrátí Discord chybu 429. Posílej souhrny, ne zprávu za každou maličkost.

URL webhooku je tajná jako token – kdo ji zná, může do kanálu psát. Ulož ji do .env (viz Tajné údaje v .env). Když unikne, webhook v Discordu smaž a vytvoř nový.