Slack Integration Setup Guide

Connect AskVerdict to Slack to run AI debates and receive verdicts directly in any channel using slash commands.

3 min read
Share

Bring structured AI decision-making into Slack. Once connected, any team member can trigger a debate from any channel using a slash command and receive the verdict as a formatted message — no need to open AskVerdict separately.

Prerequisites

  • An AskVerdict account (any plan)
  • A Slack workspace where you have permission to install apps
  • At least one credit or a BYOK subscription (debates cost credits)

How It Works

plaintext
User types: /askverdict Should we migrate to a microservices architecture?
       ↓
AskVerdict runs a multi-agent debate (balanced mode by default)
       ↓
Verdict posted to the channel as a threaded reply

The integration uses Slack's OAuth flow to securely connect your workspace. AskVerdict receives only the permissions it needs — it cannot read existing channel history.

Step 1: Connect Slack

  1. Go to Settings → Integrations in the AskVerdict web app
  2. Click Connect Slack
  3. You will be redirected to Slack's OAuth consent screen
  4. Review the requested permissions:
    • commands — to register the /askverdict slash command
    • chat:write — to post verdict messages to channels
    • chat:write.public — to post in public channels without being a member
  5. Click Allow
  6. You will be redirected back to AskVerdict with a success confirmation

If you see "Slack integration is not configured", your workspace administrator may need to pre-approve the AskVerdict app. Share this page with your Slack admin.

Step 2: Choose a Default Channel

After connecting, configure a default channel for automated notifications (optional — slash commands work in any channel regardless of this setting).

  1. In Settings → Integrations, find the Slack card
  2. Click Configure
  3. Enter the channel name or ID (e.g. #decisions or C04XYZ...)
  4. Click Save

The API endpoint for updating configuration:

bash
PATCH /api/integrations/slack
Authorization: Bearer vrd_your_api_key
Content-Type: application/json
 
{
  "channelId": "C04XYZ12345",
  "channelName": "decisions",
  "postOnComplete": true,
  "dmOnOutcome": false
}
FieldTypeDescription
channelIdstringSlack channel ID (max 32 chars)
channelNamestringHuman-readable channel name for display
postOnCompletebooleanPost to channel when debate completes (default: true)
dmOnOutcomebooleanDM the debate creator when an outcome is recorded (default: false)

Step 3: Use the Slash Command

In any Slack channel or DM, type:

plaintext
/askverdict <your question>

Examples

plaintext
/askverdict Should we hire a contractor or full-time for the backend role?
/askverdict Is it worth rewriting the mobile app in React Native?
/askverdict Should we raise prices by 20% this quarter?

AskVerdict responds with an immediate acknowledgement, then posts the verdict when the debate completes (typically 30–90 seconds depending on mode).

Sample Verdict Response

plaintext
AskVerdict [APP]
Verdict: Should we hire a contractor or full-time?
 
Recommendation: Hire a contractor for the immediate project, then reassess full-time headcount in Q3.
Confidence: 72%  |  Mode: Balanced  |  3 rounds
 
Pros
• Immediate capacity without 6-month hiring timeline
• Project scope is well-defined and time-bounded
• Preserves headcount budget for product hires
 
Cons
• Knowledge transfer risk at project end
• Contractor rates 40% higher than equivalent full-time cost
 
View full debate → askverdict.ai/debates/dbt_abc123

Configuration Options

Access your integration status programmatically:

bash
GET /api/integrations/slack
Authorization: Bearer vrd_your_api_key
json
{
  "connected": true,
  "integration": {
    "id": "int_abc123",
    "active": true,
    "config": {
      "teamName": "Acme Corp",
      "teamId": "T01ABC...",
      "channelId": "C04XYZ12345",
      "channelName": "decisions",
      "postOnComplete": true,
      "dmOnOutcome": false,
      "botUserId": "U05BOT..."
    },
    "createdAt": "2026-02-01T10:00:00Z",
    "updatedAt": "2026-02-10T14:30:00Z"
  }
}
Config FieldDescription
teamNameYour Slack workspace name
teamIdSlack workspace ID
channelIdDefault notification channel ID
channelNameDefault notification channel name
postOnCompleteAuto-post verdicts to the default channel
dmOnOutcomeDM creator when an outcome is recorded
botUserIdThe bot's Slack user ID

Disconnecting

To remove the Slack integration:

  1. Go to Settings → Integrations
  2. Click Disconnect on the Slack card
  3. Confirm the disconnection

Or via the API:

bash
DELETE /api/integrations/slack
Authorization: Bearer vrd_your_api_key

This removes AskVerdict's access token from Slack. The /askverdict command will stop working in your workspace. Your debate history in AskVerdict is not affected.

Troubleshooting

IssueSolution
"Request verification failed"Slack sends signed requests — ensure SLACK_SIGNING_SECRET is current in AskVerdict settings
Command not appearing in SlackThe app may need to be reinstalled — click Connect Slack again
Verdict not posted to channelCheck that the bot has chat:write permission and is a member of the channel
"AskVerdict is not properly configured"Contact support — a server-side environment variable may be missing
Redirect to error page after OAuthAuthorization was denied or an OAuth state mismatch occurred — try connecting again

Slash commands run debates using your AskVerdict account's credits. Every team member who uses /askverdict in your workspace will consume credits from your account. Monitor usage at Developer Portal → Usage.

Was this page helpful?

PreviousBest PracticesNextDiscord Bot Integration Guide