Skip to content

docs: update Slack setup with production flow and event verification#14

Merged
ashpreetbedi merged 4 commits into
mainfrom
docs/slack-setup
Apr 7, 2026
Merged

docs: update Slack setup with production flow and event verification#14
ashpreetbedi merged 4 commits into
mainfrom
docs/slack-setup

Conversation

@Mustafa-Esoofally

Copy link
Copy Markdown
Contributor

Summary

  • Add production (Railway) deployment instructions alongside local Docker setup
  • Add critical Event Subscriptions verification step — when the Slack app is created before the server is running, the challenge verification fails silently and events never arrive. Step 5 documents the retry fix
  • Show both ngrok ports: 8000 for Docker Compose, 7777 for bare AgentOS
  • Update docs/SLACK_CONNECT.md to match README changes
  • Fix customer count: ~900 (was ~500, actual is 888)

Context

Discovered during Railway deployment of Dash to the Agno workspace. The Slack app was created from manifest before the server had Slack credentials, so the event subscription URL verification failed. Events weren't delivered until we manually retried verification in the Slack app settings.

Type of change

  • Documentation update

Checklist

  • Both README.md and docs/SLACK_CONNECT.md updated consistently
  • Port scoping reviewed (Codex second opinion confirmed Docker=8000, bare=7777)
  • format.sh and validate.sh pass
  • Tested E2E: Railway deploy + Slack bot in Agno workspace #slack-apps-testing channel

…est steps

Add production deployment instructions alongside local Docker setup.
Fix ngrok port (7777, not 8000). Add Event Subscriptions verification
step that was causing silent failures. Add test instructions.
Show both ports in ngrok instructions: 8000 for Docker Compose (Quick
Start), 7777 for bare AgentOS. Update SLACK_CONNECT.md to match README:
add Railway deployment path, event subscription verification step, and
production URL guidance.
Replace full step-by-step procedure with a 4-step summary that links
to the canonical setup guide. All procedural detail (ngrok ports,
manifest, credentials, Railway flow, event verification, scopes) now
lives only in docs/SLACK_CONNECT.md.
@ashpreetbedi ashpreetbedi merged commit 887d998 into main Apr 7, 2026
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants