Webhooks

Nachrichten in Kanäle senden ohne dauerhafte Socket-Verbindung.

Webhook erstellen

In der App: Kanal-Einstellungen → Webhooks, oder per API mit Berechtigung MANAGE_WEBHOOKS:

Code
POST /servers/{serverId}/webhooks
Authorization: Bearer <token>

{
  "name": "Status-Bot",
  "channelId": "clx..."
}

Antwort enthält token und url:

Code
{
  "id": "...",
  "name": "Status-Bot",
  "token": "a1b2c3...",
  "url": "https://api.voxery.xyz/webhooks/a1b2c3..."
}

Nachricht senden

Code
POST https://api.voxery.xyz/webhooks/{token}
Content-Type: application/json

{
  "content": "Deploy successful!",
  "embeds": []
}

Kanaltypen: TEXT und ANNOUNCEMENT. Max. 4000 Zeichen. Rate-Limit: 30/min pro Token.

Anzeige in der App

Webhook-Nachrichten erscheinen mit dem Webhook-Namen und Avatar (falls gesetzt), nicht als normaler Nutzer. Message-Typ: WEBHOOK.

Einschränkungen

  • Kein Empfang von Nachrichten über Webhooks
  • Keine Datei-Anhänge per Webhook (aktuell)
  • Keine ausgehenden Event-Webhooks an deine URL

Für bidirektionale Bots → Gateway-Bots.

Voxery Developers