Skip to main content

Agent Integration

srvly can send installation prompts directly to your AI agent through a webhook, eliminating the need to manually copy and paste prompts.

How it works​

When you configure a webhook URL in your settings, every installation page shows a 🤖 Send to agent button next to the Copy button. Clicking it sends the installation prompt directly to your agent's chat.

srvly uses a simple JSON payload compatible with Mattermost, Discord, Slack, and any HTTP endpoint:

{
  "text": "Install Nextcloud on server Contabo...",
  "username": "srvly",
  "icon_url": "https://srvly.app/favicon.ico"
}

Setting up a webhook​

Mattermost​

  1. Go to your Mattermost instance → Main Menu → Integrations → Incoming Webhooks
  2. Click Add Incoming Webhook
  3. Set a title (e.g., "srvly Agent")
  4. Select the channel where your AI agent listens
  5. Copy the webhook URL
  6. Paste it in srvly Settings → Agent Integration

Discord​

  1. Go to your Discord server → Server Settings → Integrations → Webhooks
  2. Click Create Webhook
  3. Name it "srvly" and select the channel
  4. Copy the webhook URL
  5. Paste it in srvly Settings → Agent Integration

Slack​

  1. Go to api.slack.com/apps
  2. Create a new app or use an existing one
  3. Enable Incoming Webhooks
  4. Activate the webhook and select a channel
  5. Copy the webhook URL
  6. Paste it in srvly Settings → Agent Integration

Custom endpoint​

Any HTTP endpoint that accepts POST requests with a JSON body containing a text field will work. The endpoint should return a 2xx status code on success.

Agent @mention​

If your agent listens for @mentions in the channel (Mattermost, Discord), you can set an Agent mention in Settings. When configured, every prompt will be prefixed with @agentname so your agent is notified.

  1. Go to Settings → Agent Integration
  2. In the Agent mention field, enter your agent's username (e.g., my-hermes-agent)
  3. Click Save

Now when you click 🤖 Send to agent, the message will start with @my-hermes-agent Install Nextcloud... — your bot receives the notification.

Using the integration​

  1. Browse the App Catalog and select an application
  2. Configure the installation parameters (server, domain, port)
  3. Click 🤖 Send to agent — the prompt is sent to your agent's chat
  4. Your AI agent receives the prompt and begins the installation
  5. Monitor progress in your agent's responses and the srvly dashboard

Requirements​

  • Your AI agent must be configured to listen on the webhook channel
  • The webhook endpoint must be publicly accessible or reachable from your srvly instance
  • For self-hosted srvly, the webhook URL must be resolvable from your server