Discord

Receive Instructionly checkpoint notifications directly in your Discord channels.

Overview

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

Step 1: Create a Discord Webhook

1. Open Discord and go to the server where you want notifications
2. Right-click on the channel and select Edit Channel
3. Go to Integrations in the sidebar
4. Click Webhooks
5. Click New Webhook
6. Give it a name (e.g., "Instructionly")
7. Optionally, upload an avatar image
8. Click Copy Webhook URL

Step 2: Configure Instructionly

1. Go to Settings → Webhooks in Instructionly
2. Paste your Discord 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 Discord 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 content field that Discord 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 hasn't been deleted
• Test works but real notifications don't: Make sure "Webhook" is enabled under MCP Checkpoint Notifications in Settings
• Webhook URL expired: Discord webhooks don't expire, but they can be deleted. Create a new one if needed
• Rate limited: Discord has rate limits. If you're sending many notifications, some may be delayed