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

Саморегистрация вебхука бота

PUT/bot/webhook
bot_self:webhook:write

Метод позволяет боту самостоятельно изменить URL своего исходящего вебхука своим же токеном — без участия администратора и без знания собственного user_id. Меняется вебхук того бота, которому принадлежит токен. Чтобы отключить вебхук, передайте пустую строку в outgoing_url.

Тело запроса

application/json
webhook
object
*
Объект параметров вебхука
outgoing_url
string
*
URL исходящего вебхука. Пустая строка отключает вебхук.
Пример:https://www.website.com/tasks/new

Ответ

200OK
The request has succeeded.
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"]
scopes[]
array of strings
*
Скоупы (права доступа) токена бота
Пример:["messages:create"]
Саморегистрация вебхука бота
pachca bots update-webhook \  --outgoing-url=https://www.website.com/tasks/new \  --json \  --token YOUR_ACCESS_TOKEN
Ответ 200
{  "data": {    "id": 1738816,    "webhook": {      "name": "Бот задач",      "nickname": "tasks_bot",      "outgoing_url": "https://www.website.com/tasks/new",      "events": [        "message_new"      ],      "trigger_on": "commands",      "commands": [        "/task"      ],      "scopes": [        "messages:create"      ]    }  }}