From d5c20d135dc54ae316ae0ad1db6045920be8f3d4 Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?Sven=20H=C3=BCster?= Date: Mon, 18 May 2026 16:08:16 +0200 Subject: [PATCH 1/2] Document AI agent activation in message attachments Added instructions for activating AI agent responses in posts. --- .../integrate/reference/message-attachments/_index.md | 10 ++++++++++ 1 file changed, 10 insertions(+) diff --git a/site/content/integrate/reference/message-attachments/_index.md b/site/content/integrate/reference/message-attachments/_index.md index 6537570866..c63a21b4f8 100644 --- a/site/content/integrate/reference/message-attachments/_index.md +++ b/site/content/integrate/reference/message-attachments/_index.md @@ -176,3 +176,13 @@ Content-Length: 192 {"text":"Test message #testing", "attachments": [{"pretext": "This is the attachment pretext.","text": "This is the attachment text."}]} ``` + +## Trigger AI agent responses + +To have Mattermost AI agents respond to a post created by an integration, set the `activate_ai` property to `"true"` in the post's `props` field. This applies to posts created via either an incoming webhook or the {{< newtabref href="https://api.mattermost.com/#operation/CreatePost" title="create post RESTful API" >}}, and works independently of `attachments` — you can use it with or without an attachment payload. + +```json + "props": { + "activate_ai": "true" + } +``` From 9e019e51a11f9f25f30c8502f71c81d9fafa4bf1 Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?Sven=20H=C3=BCster?= Date: Mon, 18 May 2026 16:10:19 +0200 Subject: [PATCH 2/2] Update _index.md --- site/content/integrate/reference/message-attachments/_index.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/site/content/integrate/reference/message-attachments/_index.md b/site/content/integrate/reference/message-attachments/_index.md index c63a21b4f8..80b3cc1527 100644 --- a/site/content/integrate/reference/message-attachments/_index.md +++ b/site/content/integrate/reference/message-attachments/_index.md @@ -179,7 +179,7 @@ Content-Length: 192 ## Trigger AI agent responses -To have Mattermost AI agents respond to a post created by an integration, set the `activate_ai` property to `"true"` in the post's `props` field. This applies to posts created via either an incoming webhook or the {{< newtabref href="https://api.mattermost.com/#operation/CreatePost" title="create post RESTful API" >}}, and works independently of `attachments` — you can use it with or without an attachment payload. +To have Mattermost AI agents respond to a post created by an integration, set the `activate_ai` property to `"true"` in the post's `props` field. ```json "props": {