slack-realtime-events_skill

Overview

This skill implements real-time Slack event handling using Socket Mode and the Events API for Go-based apps. It provides patterns for handling messages, app mentions, reactions, interactive components, slash commands, and connection management. Use it to build responsive, event-driven Slack bots and integrations that run locally, behind firewalls, or in production cloud environments.

How this skill works

The skill wires a slack-go client to either Socket Mode (WebSocket) or the Events API (HTTP webhooks). It reads incoming envelopes or HTTP requests, acknowledges events, dispatches handlers for event types (message, app_mention, reaction, etc.), and responds via the Slack Web API. It includes patterns for interactive components (buttons, modals), slash commands, graceful shutdown, and error handling.

When to use it

• Building interactive Slack bots that must respond in real time
• Running a Slack app on localhost or behind a firewall (use Socket Mode)
• Deploying to production with a public HTTPS endpoint (use Events API)
• Handling button clicks, modal submissions, reactions, or slash commands
• Creating event-driven automations that react to workspace activity

Best practices

• Acknowledge incoming events immediately to avoid timeouts
• Filter out bot-generated messages to prevent loops
• Run long-running work in goroutines to avoid blocking handlers
• Verify Events API request signatures in HTTP handlers
• Implement reconnection and error handling for Socket Mode clients
• Use graceful shutdown with context cancellation to stop cleanly

Example use cases

• A helpdesk bot that replies to app mentions and opens modals for ticket details
• CI/CD approval workflow that uses button actions to approve or reject deployments
• Feedback collector that opens a modal, processes submission, and stores results
• Monitoring bot that reacts to keywords and posts status updates in channels
• Slash-command driven utilities like /deploy or /status with immediate or delayed responses