# Персональный канал (API)

{% hint style="warning" %}
При подключении персонального канала подразумевается наличие опыта в настройке и разработке веб-серверов.
{% endhint %}

## Подключение

{% stepper %}
{% step %}
Чтобы подключить персональный канал необходимо перейти в раздел **Каналы** внутри бота и зайти в **Персональный канал (API)**

<figure><img src="/files/QhERkpWxQZpgHumSov1D" alt=""><figcaption></figcaption></figure>
{% endstep %}

{% step %}
В открывшемся меню введите URL-адрес вашего вебхука и нажмите **Подключить**:

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

{% hint style="warning" %}
*Адрес у вас будет свой. Его необходимо уточнить у вашего отдела разработки.*
{% endhint %}

На этот адрес Савви будет отправлять сообщения.
{% endstep %}

{% step %}
Скопируйте токен от персонального канала и передайте его разработчикам

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

{% hint style="danger" %}
Сохраните токен - он покажется **только один раз**! Если вы его утратите, поддержка **не сможет** его восстановить, и вам придется его **сбросить**!
{% endhint %}
{% endstep %}

{% step %}
При включенном флаге **Передать ключ** вы можете передать **API токен** или **Секретное слово**, которое будет использоваться для авторизации запросов только от Савви *(опционально, но **крайне рекомендовано).*** Это необходимо, чтобы вы смогли проверять приходящие к вам запросы, и отсеивать запросы, отправленные **не от Савви**.

Это слово может быть любой строкой (паролем, случайным набором символов).

<figure><img src="/files/KsZ0Kb7Ga8yaJ2OHQqXw" alt=""><figcaption></figcaption></figure>
{% endstep %}

{% step %}
Выполните тестовый запрос на ваш вебхук, нажав на кнопку **Тест вебхука**

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

После нажатия на эту кнопку, Савви отправит тестовый запрос с типом `test_request` на ваш вебхук (вместе с секретом). Если ваш вебхук вернёт успешный ответ (код 200-299) и не позднее чем через 20 секунд после запроса, значит всё прошло корректно и рядом с кнопкой **Тест вебхука** соответствующий знак:

<figure><img src="/files/nYjx46JJ00coAEEYKPFH" alt=""><figcaption></figcaption></figure>
{% endstep %}
{% endstepper %}

Далее можно ознакомиться с форматом отправляемых и получаемых сообщений.

{% content-ref url="/pages/SvCetEzoDQTCa5C7dqro" %}
[Отправка сообщений](/ru/kanaly/personalnyi-kanal-api/otpravka-soobshenii.md)
{% endcontent-ref %}

{% content-ref url="/pages/w5T5izPF17etEL7umlhg" %}
[Получение сообщений](/ru/kanaly/personalnyi-kanal-api/poluchenie-soobshenii.md)
{% endcontent-ref %}


---

# 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.suvvy.ai/ru/kanaly/personalnyi-kanal-api.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.