Skip to content

feat(web): Telegram/Slack/Discord setup wizard — step-by-step with bot token validation + webhook auto-config #200

Description

@subinium

Severity: priority/warning
Source: Internal UX audit (v0.7 sweep)
Area: packages/web, packages/runtime-node, packages/gateway

Problem

Configuring a gateway platform (Telegram bot, Slack app, Discord bot) requires:

  1. Creating a bot/app on the platform's portal
  2. Setting env vars
  3. Setting up the webhook URL
  4. Verifying with curl

This is documented somewhere but no in-dashboard wizard. /api/gateway/telegram/webhook returns 400 'token not configured' as the only feedback.

Proposed fix

  1. Connect/Gateway tab: one card per platform with status chip (Configured / Not configured / Errored).
  2. 'Configure' opens a 4-step wizard per platform:
    • Step 1: External setup checklist with deeplinks ('Open BotFather', 'Open Slack app config', etc.).
    • Step 2: Token input → server-side validation (telegramGetMe etc.).
    • Step 3: Public URL detection or input (with ngrok/cloudflared hint if localhost).
    • Step 4: Auto-register webhook → poll status → success animation.
  3. Test message: after success, 'Send test message to your channel' button.
  4. Disconnect: cleanly removes webhook + clears token.

Expected impact

  • Time-to-first-Telegram-message drops from 'unclear, ask in Discord' to <5 minutes.
  • Drives platform adoption beyond the dashboard.
  • Reduces 'why isn't my bot responding?' triage to a green/red status check.

References

  • Internal v0.7 platform polish audit

Metadata

Metadata

Assignees

No one assigned

    Labels

    enhancementNew feature or requestonboardingFirst-run / setup flowpriority/warningReal cost / risk; fix when scheduledsource/auditInternal audit findinguxUser experience / interaction design

    Projects

    No projects

    Milestone

    No milestone

    Relationships

    None yet

    Development

    No branches or pull requests

    Issue actions