Для разработчиков

Создание бота

POST/bots
bots:write

Метод для создания бота и получения его access_token.

При создании вы получите access_token бота — сразу сохраните его. Повторно получить токен вы сможете только через интерфейс (вкладка «API» настроек бота).

Тело запроса

application/json
bot
object
*
Собранный объект параметров создаваемого бота
webhook
object
*
Объект параметров вебхука бота
name
string
*
Имя бота
Пример:Бот задач
nickname
string
Никнейм бота. Должен заканчиваться на _bot.
Пример:tasks_bot
outgoing_url
string
URL исходящего вебхука
Пример:https://www.website.com/tasks/new
events[]
array of strings
События, на которые подписан бот
Возможные значения
Пример:["message_new"]
trigger_on
string
Условие срабатывания исходящего вебхука
Возможные значения
Пример:commands
commands[]
array of strings
Команды бота (триггер-слова), на которые он реагирует при trigger_on = commands
Пример:["/task","/help"]

Ответ

201Created
The request has succeeded and a new resource has been created as a result.
data
object
*
Параметры созданного бота
id
integer, (int32)
*
Идентификатор бота (совпадает с user_id бота)
Пример:1738816
webhook
object
*
Объект параметров вебхука
name
string
*
Имя бота
Пример:Бот задач
nickname
string
*
Никнейм бота
Пример:tasks_bot
outgoing_url
nullablestring
*
URL исходящего вебхука
Пример:https://www.website.com/tasks/new
events[]
array of strings
*
События, на которые подписан бот
Возможные значения
Пример:["message_new"]
trigger_on
string
*
Условие срабатывания исходящего вебхука
Возможные значения
Пример:commands
commands[]
array of strings
*
Команды бота (триггер-слова)
Пример:["/task"]
access_token
string
*
Токен доступа бота. Выдаётся только при создании. Повторно получить токен можно только через интерфейс (вкладка «API» настроек бота).
Пример:bm90X2FfcmVhbF90b2tlbg
Создание бота
pachca bots create \  --webhook='{"name":"Бот задач","nickname":"tasks_bot","outgoing_url":"https://www.website.com/tasks/new","events":["message_new"],"trigger_on":"commands","commands":["/task","/help"]}' \  --json \  --token YOUR_ACCESS_TOKEN
Ответ 201
{  "data": {    "id": 1738816,    "webhook": {      "name": "Бот задач",      "nickname": "tasks_bot",      "outgoing_url": "https://www.website.com/tasks/new",      "events": [        "message_new"      ],      "trigger_on": "commands",      "commands": [        "/task"      ]    },    "access_token": "bm90X2FfcmVhbF90b2tlbg"  }}