PIXORPHEUS

Added a full help channel ticket system to pixorpheus, the bot I’m building for my YSWS program. The bot now automatically creates support tickets when someone posts in the help channel, notifies the support team in a private channel, and lets helpers resolve tickets with a button.

Started by reading through the nephthys source code (Hack Club’s open-source support bot) to understand how help channel bots work architecturally. Studied the ticket lifecycle, macro system, and database schema, then designed my own simplified version in JavaScript using Bolt.js, instead of using python like nephtys.
Set up a PostgreSQL database on Neon, wrote the schema, and connected it to the bot. Migrated hosting from Nest to Railway for proper always-on deployment with automatic GitHub deploys.
Ran into a few interesting issues along the way:

Socket Mode vs HTTP mode : Railway doesn’t support WebSocket-based Socket Mode, so I switched to standard HTTP and configured the Slack Event Subscriptions and Interactivity URLs accordingly
502 errors : Railway was routing traffic to the wrong port; fixed by explicitly setting PORT=3000
Duplicate events : Slack sometimes sends the same event twice, causing duplicate ticket inserts; handled with a ON CONFLICT DO NOTHING in the DB

Also added 11 slash commands (/pixl-ping, /pixl-stats, /pixl-roll, etc.) and a permission system so only helpers or support team members can resolve tickets.
Tools used

Claude & GitHub Copilot for looking up Bolt.js API docs and debugging error messages (~8 min total on Hackatime), mostly used to quickly read through unfamiliar error logs and API references rather than writing code

What’s next !!

Fix remaining edge cases where some messages don’t trigger ticket creation
Add stale ticket auto-close
Add a /pixl-ticket command to manually create tickets

I followed the guide and added the first command for my SLACK bot. for the moment it has only /pixl-joke /pixl-help /pixl-catfact and I will add more later. I only spent 20m on hackatime but spent like 1h trying to understand the different terminal I had to go through to setup nest, git push etc. I had a problem and first asked people why my bot wasn’t loading on nest server but after asking claude, I found out it was because the file with working directory was on /root and not /home.pixorpheus !