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

1. Visit the setup dashboard: Open /setup-dashboard.ts in your browser to see the configuration interface
2. Set environment variables (see below)
3. Test the integration using the built-in test form
4. Start using: React to Discord messages with 🧿 to create tickets!

Set these in your Val Town environment:

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
5. Add the bot to your Discord server

1. Go to Linear Settings > API
2. Create a new Personal API key
3. Copy it to LINEAR_API_KEY
4. Find your team ID (use the setup dashboard) and set LINEAR_TEAM_ID

✅ This automation uses Val Town's built-in discordWebhook utility, so no manual webhook configuration is needed.

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-linear-automation.ts  # Main automation (uses discordWebhook)
├── 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-linear-automation.ts - The main automation that processes Discord reactions
• setup-dashboard.ts - Web interface for configuration and testing
• Use the setup dashboard to test ticket creation and verify your configuration

Edit /backend/config.ts to customize:

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

1. Use the setup dashboard web interface
2. Or manually test with the /test-ticket endpoint:

   curl -X POST https://your-setup-dashboard.web.val.run/test-ticket \
     -H "Content-Type: application/json" \
     -d '{"message_id": "123", "channel_id": "456", "guild_id": "789"}'

1. Check configuration status on the setup dashboard
2. Verify environment variables are set correctly
3. Test Discord bot permissions in your server
4. Check Linear API key has proper permissions
5. Use the test form to verify message fetching works

The automation is built with:

• Val Town's discordWebhook utility for Discord integration
• Hono for the setup dashboard HTTP server
• Discord API v10 for message fetching
• Linear GraphQL API for ticket creation
• TypeScript for type safety
• TailwindCSS for the frontend

• Uses Val Town's built-in Discord webhook system (much simpler than manual webhooks!)
• Only processes MESSAGE_REACTION_ADD events
• Automatically creates the "discord-import" label if it doesn't exist
• Handles both text messages and messages with attachments/embeds
• Generates meaningful ticket titles from message content
• Includes full context and links back to original Discord message

• ✅ No manual webhook configuration required
• ✅ Automatic Discord event handling
• ✅ Built-in error handling and retries
• ✅ Simplified deployment and maintenance
• ✅ Works seamlessly with Val Town's infrastructure