Slack

Receive Instructionly checkpoint notifications directly in your Slack channels.

Overview

When your AI agent completes a task or needs your attention, Instructionly can send a notification to Slack. This integration uses Slack's Incoming Webhooks feature.

Step 1: Create a Slack Webhook

1. Go to Slack API Apps
2. Click Create New App and select From scratch
3. Name your app (e.g., "Instructionly") and select your workspace
4. In the sidebar, click Incoming Webhooks
5. Toggle Activate Incoming Webhooks to On
6. Click Add New Webhook to Workspace
7. Select the channel where you want notifications
8. Click Allow
9. Copy the Webhook URL (starts with https://hooks.slack.com/)

Step 2: Configure Instructionly

1. Go to Settings → Webhooks in Instructionly
2. Paste your Slack webhook URL
3. Click Save
4. Enable Webhook under MCP Checkpoint Notifications

Step 3: Test the Integration

1. In Instructionly Settings → Webhooks, click Send Test
2. Check your Slack channel for the test notification

You should see a message like:

This is a test notification from Instructionly

Payload Format

Instructionly sends notifications with a text field that Slack displays automatically:

{
  "event": "checkpoint_notification",
  "type": "completion",
  "text": "Task completed: Refactored authentication module",
  "content": "Task completed: Refactored authentication module",
  "sessionId": "abc-123",
  "timestamp": "2025-01-15T10:30:00.000Z"
}

Notification types:

• completion — Task completed successfully
• attention_needed — AI needs your input to proceed

Troubleshooting

• No message appears: Verify the webhook URL is correct and the Slack app has permission to post to the channel
• Test works but real notifications don't: Make sure "Webhook" is enabled under MCP Checkpoint Notifications in Settings
• Channel not found: Re-add the webhook to the correct channel in your Slack app settings