Automating Discord Scheduled Events via API: Developer Guide with Dynamic Timestamps

import { 
  Client, 
  GatewayIntentBits, 
  GuildScheduledEventEntityType, 
  GuildScheduledEventPrivacyLevel, 
  time, 
  TimestampStyles 
} from 'discord.js';

const client = new Client({ 
  intents: [GatewayIntentBits.Guilds, GatewayIntentBits.GuildScheduledEvents] 
});

async function createCommunityEvent(guildId: string, announcementChannelId: string) {
  const guild = await client.guilds.fetch(guildId);
  const channel = await guild.channels.fetch(announcementChannelId);
  if (!channel || !channel.isTextBased()) return;

  // Schedule event for 48 hours in the future
  const startTime = new Date(Date.now() + 48 * 60 * 60 * 1000);
  const endTime = new Date(startTime.getTime() + 2 * 60 * 60 * 1000);

  // 1. Create the Guild Scheduled Event via Discord API
  const scheduledEvent = await guild.scheduledEvents.create({
    name: 'Developer Q&A and Roadmap Livestream',
    scheduledStartTime: startTime.toISOString(),
    scheduledEndTime: endTime.toISOString(),
    privacyLevel: GuildScheduledEventPrivacyLevel.GuildOnly,
    entityType: GuildScheduledEventEntityType.External,
    entityMetadata: {
      location: 'https://twitch.tv/example_stream'
    },
    description: 'Join the core engineering team for our monthly Q&A session.'
  });

  // 2. Post a synchronized announcement message in chat with dynamic timestamps
  const fullDate = time(startTime, TimestampStyles.LongDateTime);
  const relativeCountdown = time(startTime, TimestampStyles.RelativeTime);

  await channel.send({
    content: `📢 **NEW EVENT SCHEDULED: ${scheduledEvent.name}**\n\n` +
      `**Kickoff Time:** ${fullDate} (${relativeCountdown})\n` +
      `**Location:** <${scheduledEvent.entityMetadata?.location}>\n` +
      `**Event RSVP:** Click 'Interested' on the official event card: ${scheduledEvent.url}`
  });
}

client.login(process.env.DISCORD_BOT_TOKEN);