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

1. Visit the setup page: Open your Val Town URL in a browser to see the configuration dashboard
2. Set environment variables (see below)
3. Configure Discord webhook (instructions on the setup page)
4. Test the integration using the built-in test form

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

1. In your Discord server settings, go to Integrations > Webhooks
2. Create a new webhook pointing to: https://[your-val-name].web.val.run/discord-webhook
3. Configure it to listen for "Message Reactions" events

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 /linear-teams endpoint) and set LINEAR_TEAM_ID

1. User reacts to a Discord message with the configured emoji (🧿)
2. Discord sends a webhook to our service
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)

├── backend/
│   ├── index.ts          # Main HTTP handler and webhook endpoint
│   ├── 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 and testing interface
└── README.md

• GET / - Setup dashboard (web interface)
• POST /discord-webhook - Discord webhook endpoint
• POST /test-ticket - Manual ticket creation for testing
• GET /config - Configuration status
• GET /linear-teams - List available Linear teams
• GET /health - Health check

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 web interface at your Val Town URL
2. Or manually test with the /test-ticket endpoint:

   curl -X POST https://your-val.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 web 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. Verify webhook URL is correctly configured in Discord

The automation is built with:

• Hono for the HTTP server
• Discord API v10 for message fetching
• Linear GraphQL API for ticket creation
• TypeScript for type safety
• TailwindCSS for the frontend

• 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