Integrations

Plexus can send notifications to external services when your AI agents need attention. This is especially useful when you're away from your computer or working in a team.

Webhook Notifications

Plexus supports webhook-based notifications for:

• Discord - Get alerts in your Discord server
• Slack - Receive notifications in Slack channels
• Custom Webhooks - Send to any HTTP endpoint

Setting Up Discord

1. In Discord, go to Server Settings > Integrations > Webhooks
2. Click New Webhook
3. Choose a channel and copy the webhook URL
4. In Plexus, go to Settings > Integrations
5. Paste the webhook URL in the Discord field
6. Click Save

Test the Connection

Click Test to send a test notification to your Discord channel.

Setting Up Slack

1. Go to Slack API and create a new app
2. Enable Incoming Webhooks
3. Add a new webhook to your workspace
4. Copy the webhook URL
5. In Plexus, go to Settings > Integrations
6. Paste the webhook URL in the Slack field
7. Click Save

Using Slack Workflows

For more advanced notifications, you can use Slack Workflows:

1. Create a new Workflow in Slack
2. Add a webhook trigger
3. Use the workflow URL in Plexus

Notification Events

You can choose which events trigger notifications:

Custom Webhooks

For custom integrations, Plexus can send POST requests to any HTTP endpoint.

Payload Format

{
  "event": "agent_waiting",
  "agent": {
    "type": "claude-code",
    "status": "waiting"
  },
  "session": {
    "id": "session-123",
    "project": "my-project",
    "branch": "main"
  },
  "timestamp": "2024-01-15T10:30:00Z"
}

Headers

Custom webhooks include these headers:

• Content-Type: application/json
• User-Agent: Plexus/1.0
• X-Plexus-Event: <event-type>

Troubleshooting

Notifications Not Arriving

1. Verify the webhook URL is correct
2. Check that the webhook is active in Discord/Slack
3. Ensure Plexus has internet access
4. Check the Plexus logs for errors

Rate Limiting

To prevent notification spam, Plexus limits notifications to:

• Maximum 1 notification per agent per minute
• Maximum 10 notifications per hour total

You can adjust these limits in Settings > Integrations > Rate Limiting.