[POST] .../v1/chat/addbot
Adds a chatbot to a chat by connected_integration_id. Use this method to attach a bot participant from an existing connected integration to a chat so the bot can receive and send chat messages. The request body is required, chat_id must identify the chat and connected_integration_id must identify the bot integration connection. Access is checked by the persistent layer against the current request user's chat scope and integration availability and the method returns row_affected on success. Missing body, missing chat_id or connected_integration_id, inaccessible chat, invalid or disconnected integration, duplicate bot participant and database failures are returned as HTTP 200 ErrorResult business errors.
Request Parameters
| Name | Type | Required | Description |
|---|---|---|---|
| chat_id | String | Required | Chat UUID. |
| connected_integration_id | String | Required | Connected integration ID. |
Request Example
{
"chat_id": "8cdd646d-dbd0-45c0-8f5b-d90a9b000001",
"connected_integration_id": "f1c4b0e2-3a77-4a98-9f40-38ce97000001"
}
Response Parameters
| Name | Type | Description |
|---|---|---|
| ok | Boolean | Indicates whether the request completed successfully. |
| result | Update | Update operation result. |
Response Example
{
"ok": true,
"result": {
"row_affected": 1
}
}