Webhooks
Discover, Manage, and Scale Discord Bots. Event-driven notifications for BotNexus integrations. Receive real-time payloads when developers install your bot or leave new reviews.
Available Events
Subscribe to specific lifecycle triggers to automate your CI/CD pipelines, analytics dashboards, or support ticket routing.
bot.install
Fires when a server admin adds your bot to a new guild. Includes guild ID, installation timestamp, and the inviting user’s Discord snowflake. Average delivery latency: 120ms.
bot.uninstall
Triggers on guild removal. Useful for cleaning up cached data, revoking OAuth2 tokens, or archiving moderation logs before they expire under GDPR compliance.
review.created
Delivered when a user submits a rating or text review on your BotNexus listing. Payload contains star rating (1–5), review body, and reviewer’s public profile URL.
review.updated
Sent when an author edits their existing review. Includes a diff summary, previous rating, and updated moderation flags if triggered by community reports.
Request Payload Structure
All webhook POST requests include a JSON body, a X-BotNexus-Signature header for HMAC-SHA256 verification, and a X-BotNexus-Event identifier.
Sample Install Payload
{
"event": "bot.install",
"timestamp": "2024-05-12T18:34:09Z",
"bot_id": "bn_8f92a1c4e7",
"guild": {
"id": "992847103829475840",
"name": "NovaGaming Hub",
"member_count": 1420
},
"installer": {
"discord_id": "284710938475628032",
"username": "alex_dev"
}
}
Validate the X-BotNexus-Signature header against your registered secret before processing. Retries follow an exponential backoff schedule (2s, 10s, 60s, 5m, 30m) with a maximum of 5 attempts. If your endpoint returns a 2xx status, the event is marked as delivered.