EventsVR Docs

Channel Discord Webhooks

Send Discord webhook announcements and member-only event reminders for channel events.

Channel Setup

Channel owners can paste a Discord webhook URL into the channel edit page.

  • Create the webhook in the target Discord server channel.
  • Only the canonical https://discord.com/api/webhooks/{id}/{token} URL is accepted.
  • Use Send Test Webhook and the delivery history on the channel edit page after saving the URL.

New Event Announcements

The event form has an explicit channel notification checkbox for Discord announcements.

  • The first-publish announcement is opt-in per event.
  • Editing an already published event does not resend the new-event announcement.
  • Draft or moderated events wait until they are actually published before the webhook can send.

Event Reminders

Webhook reminders are a membership feature controlled by the Webhook reminders tier perk.

  • Eligible users can opt in to a one-hour reminder.
  • Eligible users can opt in to a start-time reminder.
  • Reminder send markers are stored on the event so the same reminder is not sent repeatedly.

Admin Scheduler

Admins must run the webhook worker regularly for reminders and pending publish notifications.

  • Use Admin > Settings > Discord Channel Webhooks to see queued counts and recent delivery results.
  • Run php send_channel_webhook_reminders.php every few minutes with cron or Windows Task Scheduler.
  • The worker waits 15 minutes before retrying a failed scheduled delivery and prunes delivery records older than 90 days.

Spam Control

Webhook sends are intentionally conservative so channel Discord servers are not spammed by routine edits.

  • New-event webhook sends use a dedicated sent-at marker.
  • Event updates do not reset the new-event sent marker.
  • Changing the event start time only resets the reminder sent markers so reminders match the new time.
Manage My Channels