AddBot

[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
  }
}