What the Slack Integration Does

The FAQ Ally Slack app adds a Save to FAQ Ally message shortcut to every message in your workspace. Authorized team members can save any text-based Slack message as a draft snippet in FAQ Ally. The snippet appears in Knowledge ā†’ Snippets, pre-tagged where possible, ready to be reviewed and promoted into your AI agent's training set.

FAQ Ally never reads your channels, never auto-posts, and never calls the Slack API on its own. The bot scope is limited to commands, the minimum permission needed to receive the shortcut interaction. The app can only act when a user explicitly triggers it.

Prerequisites

  • A Slack workspace where you have permission to install apps.
  • A FAQ Ally account with the admin role.
  • At least one FAQ Ally user with admin or manager role who will use the shortcut.

Step 1: Install the Slack App

1 Open Integrations

In FAQ Ally, navigate to Integrations ā†’ Slack from the left sidebar.

2 Click Add to Slack

Click the Add to Slack button. FAQ Ally securely generates an OAuth link and redirects your browser to Slack's consent screen.

3 Approve the Install

Review the requested permissions (you will only see commands) and click Allow. Slack redirects you back to FAQ Ally.

4 Confirm the Connection

FAQ Ally shows a green confirmation with your workspace name, install date, and installer email. The Slack app is now active in your workspace.

Note: Only one Slack workspace can be linked per FAQ Ally company. The install is a one-time admin action; your team does not need to install anything individually.

Step 2: Link Users to Their Slack Identity

Installing the app grants workspace access, but each person who wants to use the Save to FAQ Ally shortcut needs to be linked to their Slack member ID.

1 Open User Settings

Navigate to Settings ā†’ Users and click Edit on the user you want to link.

2 Enter Their Slack Member ID

In the Slack section, paste the user's Slack member ID (their Uā€¦ identifier). You can copy this from Slack by opening the person's profile ā†’ clicking the kebab menu ā†’ Copy member ID.

3 Enable Slack Capture

Toggle Slack capture to enabled and save. The user can now use the shortcut.

Role requirement: Only users with the admin or manager role can save messages. Users with the user role cannot use the shortcut even when linked.

Step 3: Save a Message

Once a user is linked, saving a Slack message takes three clicks:

1 Hover Over the Message

In any Slack channel or DM, hover over the message you want to capture to reveal the action toolbar.

2 Open More Actions

Click the three-dot menu (More actions) on the message.

3 Choose "Save to FAQ Ally"

Select Save to FAQ Ally from the message shortcuts. FAQ Ally confirms the save with an ephemeral message (visible only to you).

What Happens After Saving

When you save a Slack message, FAQ Ally:

  • Normalizes the text: strips Slack formatting codes, link syntax, and special characters into clean plaintext.
  • Generates a title: creates a concise snippet title from the message content.
  • Suggests tags: matches the message text against your company's existing tags and auto-applies relevant ones (never creates new tags).
  • Creates a draft snippet: the message appears in Knowledge ā†’ Snippets with a draft status.
  • Records source metadata: stores the workspace, channel, timestamp, and who saved it for full traceability.

From there, follow the standard snippet workflow: review the draft, edit if needed, mark it Training Ready, and include it in your next agent training run.

Authorization Model

Install / Uninstall the Slack App

Who: FAQ Ally admin

Done once from Integrations ā†’ Slack. Applies to the entire company.

Toggle Slack Capture

Who: FAQ Ally admin

Pause or resume message capture without uninstalling the app.

Link Users to Slack

Who: FAQ Ally admin

Set each user's Slack member ID and enable their capture toggle.

Use the "Save to FAQ Ally" Shortcut

Who: Linked FAQ Ally admin or manager

The actual message-save action in Slack.

Edit / Promote Resulting Snippets

Who: Standard FAQ Ally snippet permissions

Draft snippets follow the same review workflow as any other snippet.

Security and Privacy

Minimal Permissions

The FAQ Ally Slack app requests only the commands scope, the absolute minimum needed to receive message shortcut interactions. It cannot read channels, list users, or access files in your workspace.

Encrypted Storage

The bot token issued by Slack is encrypted at rest with field-level encryption (AES with application-specific authenticated data). It is never logged or exposed in API responses.

Request Verification

Every incoming request from Slack is verified using HMAC-SHA256 signature verification with timestamp freshness checks and replay protection. Duplicate or stale requests are rejected silently.

Rate Limiting

Each user is limited to 30 saves per hour to prevent abuse. This budget is tracked server-side in the database, not in-memory, so it cannot be bypassed across multiple servers.

Managing the Integration

Pause Capture (Without Uninstalling)

In Integrations ā†’ Slack, toggle the Enable switch off. The Slack app stays installed but save attempts return an ephemeral message telling the user capture is paused. Toggle it back on at any time.

Disconnect the Integration

Click Disconnect Slack to fully remove the integration. This revokes the bot token, disables Slack capture for all linked users, and removes the app from your workspace. Previously saved snippets are not deleted.

Re-install After Disconnecting

You can always re-install by clicking Add to Slack again. User links (Slack member IDs) are preserved; you just need to re-enable the capture toggle on each user.

Troubleshooting

"Slack install was cancelled"

You clicked Cancel in the Slack consent screen. Click Add to Slack again to retry.

"Slack install link expired or was already used"

Each install link is single-use and expires after 10 minutes. Click Add to Slack again to generate a fresh link.

"You are not authorized to save messages to FAQ Ally"

Your FAQ Ally user either isn't linked to your Slack member ID, your role is below manager, or your capture toggle is disabled. Ask a FAQ Ally admin to check Settings ā†’ Users ā†’ (your name) ā†’ Slack.

"No text was found on that Slack message"

The shortcut only captures text-based messages. Files, images, and non-text attachments aren't supported in the current release.

"That Slack workspace is already linked to another FAQ Ally company"

Two FAQ Ally companies cannot share the same Slack workspace. Contact FAQ Ally support if this is unexpected.

Best Practices

  • Save answers, not questions. The most valuable messages for training are answers, explanations, and clarifications: the knowledge your team is sharing every day.
  • Review drafts promptly. Draft snippets need to be marked Training Ready and assigned matching document tags before they join an agent's training set.
  • Use existing tags wisely. FAQ Ally auto-suggests tags based on message content, but you can adjust them during review to ensure snippets land in the right training scope.
  • Save long-form messages over short ones. A detailed explanation trains better than a one-word reply. If a message is too short, consider combining it with context in the snippet editor.
  • Brief your team. Let linked users know the shortcut exists and when to use it. Great triggers: someone gives a detailed answer, resolves a confusing process, or clarifies a policy.

Learn More

For snippet management details, see Knowledge Snippets. For AI training tips after your snippets are ready, see AI Agent Training.