Skip to main content

Documentation Index

Fetch the complete documentation index at: https://docs.ascendgtm.net/llms.txt

Use this file to discover all available pages before exploring further.

​
Connect to Slack

Query the Ascend Gateway V5 directly from Slack by messaging the Ascend GTM bot.
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 (70+):
     ✅ hubspot (CRM)
     ✅ google_ads (Advertising)
     ✅ salesforce (CRM)
     ✅ ga4 (Analytics)
     ... and 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: 70+ 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.

​
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