Skip to content

docs: consolidated Slack connection + auth docs (magic link + Builder/SuperGTM)#659

Draft
jordanc-relevanceai wants to merge 4 commits into
mainfrom
consolidate/slack-auth
Draft

docs: consolidated Slack connection + auth docs (magic link + Builder/SuperGTM)#659
jordanc-relevanceai wants to merge 4 commits into
mainfrom
consolidate/slack-auth

Conversation

@jordanc-relevanceai
Copy link
Copy Markdown
Collaborator

This PR consolidates 2 drafter PRs that both add Slack connection/authentication documentation to the same page. Opened as draft for review before the source PRs are closed.

Source PRs (being closed in favor of this one)

Why consolidated

Both edit integrations/popular-integrations/slack.mdx and both add Slack-auth sections plus new FAQ accordions to the same FAQ group — so they conflicted on merge. Together they tell one coherent Slack-connection story (how to connect via magic link, and why the connection differs between Builder and SuperGTM).

Changes by source PR

#652 — TSP-1265

  • slack.mdx — new "Linking your account via magic link" section, a Troubleshooting section (magic link expiry, wrong email), and three magic-link FAQ entries.
  • microsoft-teams.mdx — same magic-link consent flow documented for Teams (new section + two troubleshooting entries + three FAQs).

#622 — TSP-1236

  • slack.mdx — new "Understanding Slack connections in Relevance AI" section (workspace bot token for Builder vs per-user OAuth for SuperGTM) and a FAQ entry: "Why does Slack work in SuperGTM but not in Builder (or vice versa)?".
  • get-started/chat/super-gtm/integrations.mdx — notes SuperGTM uses per-user OAuth, with a cross-link to the Builder Slack docs.

Reconciliation note

github-actions Bot and others added 4 commits May 13, 2026 02:07
…perGTM

Adds a new section and FAQ entry to the Builder Slack integration page
clarifying the workspace-level bot token (Builder) vs per-user OAuth
(SuperGTM) distinction. Updates the SuperGTM integrations page Slack
accordion with the same context and cross-links between pages.

Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
…eams

Documents the new /associate magic link consent flow from PR #15067. Adds
a "Linking your account via magic link" section to both integration pages,
plus troubleshooting entries and FAQs covering magic link expiry, wrong
email addresses, and the equivalence of both connection methods.

Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
…slack-auth

# Conflicts:
#	integrations/popular-integrations/slack.mdx
@mintlify
Copy link
Copy Markdown
Contributor

mintlify Bot commented Jun 3, 2026

Preview deployment for your docs. Learn more about Mintlify Previews.

Project Status Preview Updated (UTC)
relevanceai 🟢 Ready View Preview Jun 3, 2026, 9:45 AM

💡 Tip: Enable Workflows to automatically generate PRs for you.

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.

1 participant