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 Discord webhook to receive reaction events. You need to configure this in the Discord Developer Portal:

1. Go to Discord Developer Portal
2. Select your bot application
3. Go to "Webhooks" in the left sidebar
4. Click "New Webhook"
5. Set webhook URL to: https://[your-username]-discord-linear-automation.web.val.run
6. Subscribe to event: MESSAGE_REACTION_ADD
7. Save the webhook

In your Discord application settings:

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

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)
├── discord-linear-automation.ts # Manual trigger endpoint for testing
├── setup-dashboard.ts           # Setup interface and testing tools
├── backend/
│   ├── discord.ts              # Discord API integration
│   ├── linear.ts               # Linear API integration
│   ├── config.ts               # Configuration and constants
│   └── types.ts                # TypeScript type definitions
├── frontend/
│   └── index.html              # Setup dashboard interface
└── README.md

• discord-reaction-cron.ts - The main automation that runs every minute to check for new reactions
• setup-dashboard.ts - Web interface for configuration and testing
• discord-linear-automation.ts - Manual endpoint for testing specific messages

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