Skip to main content

assistant_app_thread message

The message sent is an app assistant thread

Facts

Compatible APIs

Usage info

The assistant_app_thread subtype is the subtype of the root message of an assistant thread started by the end user.

This subtype is used with the root messages that are created when a user clicks the assistant entry point (triggering an assistant_thread_started event) or starts a new chat with the app. This subtype is included in other message subtype payloads too, such that filtering it in a message listener would look like this:

message.message.subtype === 'assistant_app_thread'

This example includes both the event wrapper and the event structure for the assistant_app_thread message subtype event.

{
"token": "XXYYZZ",
"team_id": "T123ABC456",
"api_app_id": "A123ABC456",
"event": {
"type": "message",
"subtype": "message_changed",
"message": {
"text": "Chats from 2024-09-28T00:41:31.923Z",
"subtype": "assistant_app_thread",
"user": "U123456ABCD",
"type": "message",
"edited": {
"user": "U123456ABCD",
"ts": "1727484103.000000"
},
"team": "T123456ABCD",
"thread_ts": "1727484091.821349",
"reply_count": 1,
"reply_users_count": 1,
"latest_reply": "1727484101.719749",
"reply_users": [
"U123456ABCD"
],
"is_locked": false,
"blocks": [
{}
],
"assistant_app_thread": {
"title": "Chats from 2024-09-28T00:41:31.923Z",
"title_blocks": [],
"artifacts": []
},
"ts": "1727484091.821349"
},
"previous_message": {
"text": "Chats from 2024-09-28T00:41:31.923Z",
"subtype": "assistant_app_thread",
"user": "U123456ABCD",
"type": "message",
"ts": "1727484091.821349",
"team": "T123456ABCD",
"thread_ts": "1727484091.821349",
"reply_count": 1,
"reply_users_count": 1,
"latest_reply": "1727484101.719749",
"reply_users": [
"U123456ABCD"
],
"is_locked": false,
"blocks": [
{}
],
"assistant_app_thread": {
"title": "Chats from 2024-09-28T00:41:31.923Z",
"title_blocks": [],
"artifacts": []
}
},
"channel": "D987654ABCD",
"hidden": true,
"ts": "1727484103.018100",
"event_ts": "1727484103.018100",
"channel_type": "im"
},
"type": "event_callback",
"authed_users": [
"U123ABC456",
"U222222222"
],
"event_id": "Ev123ABC456",
"event_time": 123456789
}

The assistant_app_thread subtype message can also be useful for storing metadata about the conversation itself, like an external session ID or pointers to artifacts created during the conversation. Read more about sending message metadata in the Using message metadata guide.