Настройка вебхука

Подготовьте публичный HTTPS-адрес, на который ваш сервис принимает события. Это адрес обработчика, а не ссылка на чат с ботом. В URL нельзя указывать логин, пароль или фрагмент после #.

Создание

В списке вебхуков нажмите «Добавить». В форме вебхука:

Введите название, например «Обращения в CRM».
Укажите HTTPS-адрес получателя.
Отметьте события, которые нужно передавать.
Нажмите «Добавить».

Настройка вебхука. Отмеченные элементы: 1. название; 2. HTTPS-адрес получателя; 3. события; 4. «Добавить» — 1. название · 2. HTTPS-адрес получателя · 3. события · 4. «Добавить»

Откроется страница секрета подписи. Новый вебхук сразу включён. Если получатель ещё не готов, временно отключите отправку в списке вебхуков, пока настраиваете проверку подписи.

Включение и изменение

Откройте вкладку «Настройки» вебхука.
Включите переключатель «Включён».
Нажмите «Сохранить».

Здесь же можно изменить название, URL или выбранные события. После сохранения проверьте получателя тестовой отправкой.

Какие события выбрать

command_start: пользователь отправил /start;
message_allow: пользователь разрешил отправку сообщений;
message_new: новое сообщение пользователя;
button_clicked: нажатие кнопки в сообщении;
lead_created: создан лид;
lead_unsubscribed: пользователь отписался;
lead_blocked: пользователь заблокировал бота;
message_undelivered: сообщение не доставлено;
error: ошибка обработки события.

Можно выбрать несколько событий для одного получателя и создать несколько вебхуков с разными адресами. Отправляются события текущего проекта; для другого проекта настройте его собственный вебхук.