# Webhook

### Зачем это нужно 

Пример: пользователь попал в бота онлайн-школы.

Бот рассказал про курсы, и клиент зашел на сайт. Там купил один из курсов. Если в обучающей платформе курса настроить интеграции по webhook, после этого бот сам напишет клиенту.

То есть с помощью вебхука другой сервис может запустить нужную цепочку сценария Smartbot Pro.

### **Создание и настройка webhook**

1. **Создаем токен.** 

Создать новый токен и увидеть список всех токенов проекта можно в разделе «Интеграции».   

<figure><img src="/files/h0XrQYHktESBvJCcQuEn" alt=""><figcaption></figcaption></figure>

Для запуска бота нужно создать токен с правом выполнения блоков. Нажмите  «Создать токен» и выберите «Уровень доступа — Выполнение блоков».

<figure><img src="/files/YdIitxl7nDziQVEBTJUU" alt=""><figcaption></figcaption></figure>

<figure><img src="/files/Wk5pGgPhggAKFEiEHMwZ" alt=""><figcaption></figcaption></figure>

**2. Создаем событие "Webhook" в сценарии**

В сценарии для запуска цепочки из другого сервиса нужно настроить специальное событие Webhook, которое позволит запустить бота по API.

Переходим в нужный сценарий, в боковом меню выбираем "События" --> "Webhook".&#x20;

<figure><img src="/files/84kQvIZTD3xIlzIY4LDd" alt=""><figcaption></figcaption></figure>

**3. Указываем токен**

В  блоке Webhook выбираем созданный токен или создаем новый.

<figure><img src="/files/JRgmlaCYrqrOz6BRYTAk" alt=""><figcaption></figcaption></figure>

**4. Выбираем канал**&#x20;

Выберите канал в социальной сети, где сработает бот после того, как его «дернуть» вебхуком.

Если бот работает одновременно в ЛС и в беседе, необходимо также указать нужный ча&#x442;**:**

<figure><img src="/files/YYc7FpbANUBMDow7ZXC8" alt=""><figcaption></figcaption></figure>

**6.** **Параметры запроса:** **URL и body.**&#x20;

Скопируйте указанный URL и отправьте на него **POST-запрос** из вашего сервиса.

<figure><img src="/files/9nKuElriboOjqU7z4fBe" alt=""><figcaption></figcaption></figure>

Скопируйте следующий JSON и вставьте его в **Body** запроса:

<figure><img src="/files/z3eAQxQcTPdDB6MigEFb" alt=""><figcaption></figcaption></figure>

{% hint style="info" %}
peer\_id — это ID чата, в который будет отправлено сообщение от бота.
{% endhint %}

**Если бот должен сработать в групповом чате**, то peer\_id установится автоматически.&#x20;

**Если бот должен сработать в ЛС**, то peer\_id нужно заполнить самостоятельно в соответствии с подсказкой.&#x20;

![](/files/ZMsggI3n006iTDSSKFZn)

### **Требования к отправке сообщения через Webhook**

Чтобы пользователь получил сообщение через webhook, должно выполняться два условия:\
— разрешена отправка сообщений в лс \
— пользователь уже общался с ботом (бот не может первым написать пользователю)

### Удаление токена

Если  токен украден злоумышленником, его нужно удалить в разделе «Интеграции».

<figure><img src="/files/6G2Xn9pfG9ykn0ht6WZc" alt=""><figcaption></figcaption></figure>


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.smartbotpro.ru/scenarii/sobytiya-scenariya/webhook.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.