Create Bot

POST

/v1/bots

curl --request POST \
  --url https://api.cloud.agentums.ru/v1/bots \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '{ "agent_slug": "assistant", "title": "", "token": "example" }'

• Прод

Создаёт бота по токену @BotFather и пресету. Валидирует токен, ставит вебхук.

Authorizations

• bearerAuth

Request Body^required

Media typeapplication/json

BotCreateIn

Создание бота: токен @BotFather + выбранный пресет.

object

agent_slug

Agent Slug

string

default: assistant <= 64 characters

title

Title

string

"" <= 120 characters

token

required

Token

string

>= 20 characters <= 200 characters

Responses

201

Successful Response

Media typeapplication/json

BotCreatedOut

Ответ на создание: карточка + подсказка, если вебхук не зарегистрировался.

object

agent_slug

required

Agent Slug

string

allowlist_count

Allowlist Count

integer

0

can_read_all_messages

Can Read All Messages

boolean

created_at

Created At

string

""

deep_link

Deep Link

string

""

enabled

required

Enabled

boolean

id

required

Id

string

owner_bound

required

Owner Bound

boolean

provider

required

Provider

string

title

required

Title

string

username

required

Username

string

webhook_note

Webhook Note

string

""

webhook_set

required

Webhook Set

boolean

Example

{
  "allowlist_count": 0,
  "can_read_all_messages": false,
  "created_at": "",
  "deep_link": "",
  "webhook_note": ""
}

422

Validation Error

Media typeapplication/json

HTTPValidationError

object

detail

Detail

Array<object>

ValidationError

object

ctx

Context

object

input

Input

loc

required

Location

Array

msg

required

Message

string

type

required

Error Type

string

Example^generated

{
  "detail": [
    {
      "ctx": {},
      "input": "example",
      "loc": [
        "example"
      ],
      "msg": "example",
      "type": "example"
    }
  ]
}