Skip to main content

Connect to Slack

Query the Ascend Gateway V5 directly from Slack by messaging the Ascend GTM bot.

:::info Requirements

  • Ascend GTM Slack bot installed in your workspace
  • Bot must have chat:write, im:history, and im:read scopes :::

How It Works​

DM the Ascend GTM bot in Slack. The bot receives your message, executes the appropriate V5 gateway call, and replies with the results.

You: "list my connected APIs"
Bot: 📡 Connected Providers (53):
     ✅ hubspot (CRM)
     ✅ google_ads (Advertising)
     ✅ salesforce (CRM)
     ✅ ga4 (Analytics)
     ... and 49 more

Supported Queries​

Query PatternWhat It Does
"list APIs" / "show providers" / "what's connected"Lists all connected API providers
"hubspot contacts" / "search contacts"Searches HubSpot CRM
"google ads" / "campaigns"Queries Google Ads
"health" / "status"Shows gateway health status
"help"Shows available commands

Example Conversations​

Check System Health​

You: "How's the gateway?"
Bot: 🟢 Gateway Healthy
     Tokens: 42 active, 0 expired
     Errors (1h): 0
     Providers: 64 configured

Search CRM​

You: "Find HubSpot contacts from this week"
Bot: 📋 HubSpot Contacts (5 results):
     • John Smith (john@example.com) — Created 2026-04-10
     • Jane Doe (jane@company.com) — Created 2026-04-09
     ...

Setup (Workspace Admin)​

If the bot is not yet installed:

  1. Go to api.slack.com/apps → select the Ascend GTM app
  2. Under OAuth & Permissions, ensure these scopes are granted:
    • chat:write — Send messages
    • im:history — Read DM history
    • im:read — Detect DM channels
  3. Under Event Subscriptions, set the Request URL to: 
    https://ascend-gateway-v5.ascendgtm.workers.dev/slack/events
  4. Subscribe to: message.im (Direct messages)
  5. Install/reinstall the app to the workspace

Limitations​

  • DMs only — the bot responds to direct messages, not channel mentions (for security)
  • Text queries — no file uploads or Slack-specific formatting in queries
  • Default tenant — Slack queries use the ascend tenant. Multi-tenant Slack is a future feature.
  • No scheduling (yet) — scheduling intent detection is built but calendar integration is Phase 2

Troubleshooting​

IssueFix
Bot doesn't respondCheck bot has chat:write scope
"Invalid signature" in logsVerify SLACK_SIGNING_SECRET in Wrangler secrets
Results truncatedLarge results are trimmed to fit Slack's 3000-char block limit