Discord to Linear Ticket Automation

This automation creates Linear tickets from Discord messages when they receive a specific emoji reaction (🧿 :charmaine:).

1. Set environment variables: Add DISCORD_BOT_TOKEN, LINEAR_API_KEY, and LINEAR_TEAM_ID to your Val Town environment
2. Create and add Discord bot: Follow the setup instructions below
3. Test the integration: Use the setup dashboard to verify everything works
4. Start using: React to Discord messages with 🧿 to create tickets!

Set these in your Val Town environment:

In your Val Town environment, add these 3 required variables:

• DISCORD_BOT_TOKEN - Your Discord bot token
• LINEAR_API_KEY - Your Linear API key
• LINEAR_TEAM_ID - Your Linear team ID

1. Go to Discord Developer Portal
2. Create a new application and bot
3. Copy the bot token to DISCORD_BOT_TOKEN
4. Enable these bot permissions:
   • Read Message History
   • Add Reactions

1. In Discord Developer Portal, go to OAuth2 → URL Generator
2. Select "bot" scope
3. Select the permissions mentioned above
4. Use the generated URL to invite the bot to your server

1. Go to Linear Settings → API
2. Create a new Personal API key
3. Copy it to LINEAR_API_KEY

1. Open the setup dashboard (/setup-dashboard.ts)
2. Click "Get Linear Teams" button
3. Copy your team ID to LINEAR_TEAM_ID

1. Use the setup dashboard to verify all environment variables are set
2. Test ticket creation with the built-in test form
3. Try reacting to a Discord message with 🧿

This automation uses a cron job to poll Discord for new reactions. You need to configure your Discord bot with proper permissions:

Your bot needs these permissions (use integer: 2147549248):

• ✅ View Channels
• ✅ Read Message History
• ✅ Add Reactions

In your Discord application settings:

1. Go to "Bot" → "Privileged Gateway Intents"
2. Enable "Message Content Intent" ✅

Edit discord-reaction-cron.ts to add/remove channels to monitor for reactions.

1. User reacts to a Discord message with the configured emoji (🧿)
2. Val Town's Discord webhook automatically triggers the automation
3. Service fetches the full message content
4. Creates a Linear ticket with:
   • Title: First 100 characters of the message
   • Description: Full message content + link to Discord message
   • Labels: "discord-import"
   • Priority: Medium (configurable)

├── discord-reaction-cron.ts     # Main automation (runs every minute)
├── backend/
│   ├── config.ts               # Configuration constants
│   ├── discord.ts              # Discord API integration
│   └── linear.ts               # Linear API integration
└── README.md

• discord-reaction-cron.ts - The main automation that runs every minute to check for new reactions
• backend/config.ts - Configuration constants and environment helpers
• backend/discord.ts - Discord API calls and message formatting
• backend/linear.ts - Linear API calls and ticket creation

Edit /backend/config.ts to customize:

• Target emoji (default: "nazar_amulet" for 🧿)
• Linear label name (default: "discord-import")
• Ticket priority (default: 3 = Medium)
• Title length limit (default: 100 characters)

The automation creates tickets with titles in format: [Discord] <message content>

1. Cron job runs every minute (discord-reaction-cron.ts)
2. Checks monitored Discord channels for new messages with target emoji reactions
3. Creates Linear tickets for new reactions with:
   • Title: [Discord] <actual message content>
   • Description: Full message content + link to Discord message
   • Labels: "discord-import"
   • Priority: Medium (configurable)
4. Prevents duplicates by tracking processed messages