aethex-forge/docs/DISCORD-ACTIVITY-DIAGNOSTIC.md

Discord Activity Errors - Diagnostic & Fix Guide

Problem

When opening Discord Activity, getting these errors:

GET https://discord.com/api/v9/application-directory-static/applications/578971245454950421?locale=en-US 403 (Forbidden)
Refused to display 'https://578971245454950421.discordsays.com/' in a frame because it set 'X-Frame-Options' to 'sameorigin'

Root Cause

The Discord app is NOT properly configured for Activities in the Discord Developer Portal.

Solution Checklist

Step 1: Go to Discord Developer Portal

1. Visit: https://discord.com/developers/applications
2. Click on "AeThex" application
3. Go to the "Activities" tab on the left sidebar (NOT "General Information")

Step 2: Enable Activities

1. If you don't see an "Activities" tab, the feature isn't enabled yet
2. Click "Enable Activities" or "Configure"
3. Fill in the required fields:

Activity Settings:

• Activity Name: AeThex
• Preview Image: Upload a 512x512px image (your app logo)
• Description: AeThex Creator Network & Talent Platform - Activity
• Privacy Policy URL: https://aethex.dev/privacy
• Terms of Service URL: https://aethex.dev/terms

Activity Instance Settings:

• Instance URL: https://aethex.dev/activity
• Enable this URL: ✅ Check this box

Step 3: Verify Manifest Configuration

The app must have a properly configured manifest. Check:

1. Manifest file exists at: https://aethex.dev/discord-manifest.json
2. Manifest contains:

{
  "id": "578971245454950421",
  "version": "1",
  "name": "AeThex",
  "description": "AeThex Creator Network & Talent Platform - Activity",
  "rpc_origins": ["https://aethex.dev", "https://discord.com"],
  "interactions": {
    "request_url": "https://aethex.dev/api/discord/interactions"
  },
  "instanceUrl": "https://aethex.dev/activity",
  "orientation": "portrait-primary"
}

3. To verify, open in browser: https://aethex.dev/discord-manifest.json
4. Should return valid JSON, not 404

Step 4: Set Interactions Endpoint

Still in Discord Developer Portal:

1. Go to "General Information" tab
2. Under "Interactions Endpoint URL": https://aethex.dev/api/discord/interactions
3. Click "Save" (Discord will send PING to verify)
4. You should see: ✅ Interactions endpoint URL verified

Step 5: Check Bot Permissions

1. Go to "OAuth2" > "URL Generator"

2. Select these scopes:

   • ✅ applications.commands
   • ✅ identify
   • ✅ email
   • ✅ guilds

3. Select these permissions:

   • ✅ Send Messages
   • ✅ Read Messages/View Channels
   • ✅ Use Application Commands

4. Copy the generated URL and authorize the bot in your Discord server

Step 6: Verify Bot Token

In Discord Developer Portal:

1. Go to "Bot" tab
2. Under "TOKEN", verify the token is:
   • ✅ Not expired (if it shows "TOKEN EXPIRED", click "Reset Token")
   • ✅ Correctly set in your deployment environment variables
   • ✅ Has these intents enabled:
     • ✅ Server Members Intent
     • ✅ Message Content Intent
     • ✅ Guild Members

Step 7: Test the Activity

1. Open Discord
2. Go to any server where the bot is installed
3. Look for "Apps" section in the bottom left
4. Click to browse available activities
5. Find "AeThex" and click to open
6. Should load without 403 errors

If Still Getting Errors

403 Still Appears

• Cause: Activities might still not be fully enabled
• Fix: Wait 5-10 minutes for Discord to propagate settings, then retry
• Alternative: Try using a different Discord server to test

X-Frame-Options Error Persists

• Cause: Discord's internal sandbox is rejecting the Activity
• Fix: Verify instanceUrl in Developer Portal matches exactly: https://aethex.dev/activity
• Check: Make sure Activity URL returns valid HTML, not redirects

Activity Blank/Loading Forever

• Cause: /api/discord/activity-auth endpoint might be failing
• Debug:
  1. Open browser console (F12)
  2. Look for messages starting with [Discord Activity]
  3. Check if auth endpoint is being called
  4. Verify DISCORD_CLIENT_ID is set in environment

Slash Commands Not Working in Activity

• Cause: Interactions endpoint not verified
• Fix: Ensure https://aethex.dev/api/discord/interactions is set and verified in Discord Developer Portal

Environment Variables Needed

Verify these are set in your deployment (Vercel/Railway/etc):

VITE_DISCORD_CLIENT_ID=578971245454950421
DISCORD_BOT_TOKEN=<your_bot_token>
DISCORD_PUBLIC_KEY=<your_public_key>

Browser Console Debug Output

Open browser console (F12) and look for these messages:

✅ Success indicators:

[Discord Activity] Initialization starting...
[Discord Activity] Creating SDK with clientId: 578971245454950421
[Discord Activity] SDK is ready
[Discord Activity] Session authenticated
[Discord Activity] User authenticated successfully

❌ Error indicators:

[Discord Activity] Authorizing user...
[Discord Activity] Got access token, calling activity-auth...
ERROR: 403 Forbidden

Quick Verification Steps

1. Check manifest is accessible:

   curl https://aethex.dev/discord-manifest.json
   

   Should return valid JSON

2. Check interactions endpoint:

   curl -X POST https://aethex.dev/api/discord/interactions \
     -H "Content-Type: application/json" \
     -d '{"type":1}'
   

   Should return a response (not 404/500)

3. Check bot token:

   curl -H "Authorization: Bot YOUR_TOKEN" \
     https://discord.com/api/v10/users/@me
   

   Should return bot user info

Still Need Help?

1. Check Discord Activities documentation: https://discord.com/developers/docs/activities/building-an-activity
2. Review the bot logs: Check what [Discord Activity] messages appear in browser console
3. Verify manifest at: https://aethex.dev/discord-manifest.json
4. Test interactions endpoint manually with curl/Postman

References

• Discord Activities Guide: https://discord.com/developers/docs/activities/building-an-activity
• Manifest Format: https://discord.com/developers/docs/activities/manifest
• Interactions: https://discord.com/developers/docs/interactions/receiving-and-responding