Slack — Story Agent

The Aprity Story Agent for Slack brings AI-powered user story generation directly into your Slack workspace. Use the /aprity slash command to generate structured user stories, validate requirements, and export results — all grounded in your Salesforce org's real metadata.

info

The Slack integration rides on the Story Agent, which is available on the Intelligence and Trial plans (not on Documentation).

note

This Slack app is the Story Agent surface (the /aprity slash command). A separate Help Agent Slack adapter — which would forward org questions asked in Slack to the Help Agent — is only partially available today: workspace-to-tenant binding and event verification are in place, but full forward-to-answer is not yet complete. The /aprity Story Agent commands described below work end to end.

Prerequisites

Before you begin, make sure you have:

• A Slack workspace (free or paid plan).
• Workspace Admin or Owner permissions to install apps.
• An active aprity account with a connected Salesforce org (at least one completed scan).
• Access to the Connectors tab in the aprity Salesforce app.

Step 1 — Install the Slack app

1. Go to the Slack App Directory and search for Aprity Story Agent.
2. Click Add to Slack.
3. Review the requested permissions and click Allow.

The app requests the following permissions:

Permission	Purpose
commands	Register the /aprity slash command
chat:write	Send Story Agent responses in channels
files:write	Post generated stories as a Slack snippet when you export to the channel

Once installed, the /aprity slash command becomes available in all channels.

tip

If the app is not yet listed in the Slack App Directory, contact support@aprity.ai for a direct install link.

Step 2 — Connect Slack to aprity

Option A — Setup via slash command

1. In any Slack channel, type /aprity setup.
2. The bot responds with instructions and a prompt for the activation code.
3. Generate the activation code from the aprity Connectors tab in Salesforce (see Step 3 below).
4. Paste the code when prompted.

Option B — Generate the activation code first

1. Open Salesforce and navigate to the aprity app.
2. Go to the Connectors tab.
3. Locate the Slack card and click Connect Slack (or Generate New Code).
4. A code in the format APRT-XXXX-XXXX appears. It expires in 30 minutes.
5. Copy the code.
6. In Slack, type /aprity setup and paste the code when prompted.

caution

The code expires after 30 minutes and can only be used once. Generate a new one if it expires.

Step 3 — Verify the connection

Once connected, type /aprity help in any channel. You should see a response listing all available commands:

Command	Description
/aprity stories [description]	Generate user stories from a natural language description
/aprity continue	Continue or refine the last generation
/aprity validate	Validate generated stories against org metadata
/aprity export	Export the generated stories — push them to a connected tracker (Jira / Azure DevOps) or post them back into the channel
/aprity usage	Show your current usage and quota
/aprity cancel	Cancel the current generation
/aprity setup	Configure or reconfigure the connection
/aprity help	Show available commands

If the bot responds with an error about missing configuration, re-run /aprity setup with a fresh activation code.

Using the Story Agent

Generate stories

Type /aprity stories followed by a description of what you need:

/aprity stories Add a lead qualification scoring system based on our existing Account and Lead objects

The Story Agent will:

1. Analyze your org's metadata (objects, fields, flows, triggers, validation rules).
2. Generate structured user stories with acceptance criteria.
3. Include impact analysis showing which components are affected.
4. Estimate complexity based on the actual org structure.

Continue a conversation

Use /aprity continue to refine or iterate on the last generated stories. You can ask for modifications, additional details, or alternative approaches.

Export results

Use /aprity export to push the generated stories to a connected tracker (Jira or Azure DevOps) or post them back into the channel. The export sends stories to your tracker / Slack — it does not produce a downloadable documentation file.

Disconnecting

To disconnect the Slack app:

1. In Slack, go to Settings & Administration > Manage apps.
2. Find Aprity Story Agent in the list.
3. Click Remove to uninstall the app.

Alternatively, type /aprity setup and follow the disconnect flow.

After disconnecting, the /aprity command will no longer work. You will need to reinstall the app and use a new activation code to reconnect.

Troubleshooting

Issue	Solution
/aprity command not found	Verify the app is installed in your workspace (Manage apps).
"Not configured" error	Run /aprity setup and enter a valid activation code.
"Code expired" error	Generate a new code from the aprity Connectors tab in Salesforce.
Bot not responding	Check that the bot has been added to the channel. Mention @Aprity to verify.
"No scan data"	Run at least one scan from the aprity app before using the Story Agent.
Rate limited	The Story Agent has usage quotas based on your plan. Check /aprity usage.