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

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

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

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

<figure><img src="https://1280958077-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FCfQs1g1wTlkieX5CuhTI%2Fuploads%2FgrSXmNeg3btmHfqO4UT1%2Fimage.png?alt=media&#x26;token=c8d2aa60-9931-4822-95d3-a6972e258102" alt=""><figcaption></figcaption></figure>
{% endstep %}

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

<figure><img src="https://1280958077-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FCfQs1g1wTlkieX5CuhTI%2Fuploads%2FKfXuCwOvAfL7S7oLfia9%2Fimage.png?alt=media&#x26;token=d28303e1-4140-4009-8542-433cf11dfc46" alt=""><figcaption></figcaption></figure>

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

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

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

<figure><img src="https://1280958077-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FCfQs1g1wTlkieX5CuhTI%2Fuploads%2FcKC4yXiNNRzZyR6cjtQa%2Fimage.png?alt=media&#x26;token=eb45cf99-2207-41ef-9550-94cd682023c2" alt=""><figcaption></figcaption></figure>

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

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

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

<figure><img src="https://1280958077-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FCfQs1g1wTlkieX5CuhTI%2Fuploads%2FmwLW6GPbICwIHC4Fc7ha%2Fimage.png?alt=media&#x26;token=e61bc2c5-90ef-49c1-ae9b-cb3de29f8de0" alt=""><figcaption></figcaption></figure>
{% endstep %}

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

<figure><img src="https://1280958077-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FCfQs1g1wTlkieX5CuhTI%2Fuploads%2FbVVsd0JIfMAUtJ7nz6KN%2Fimage.png?alt=media&#x26;token=1d65b9f9-a25f-469e-97af-d715ed74e9f5" alt=""><figcaption></figcaption></figure>

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

<figure><img src="https://1280958077-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FCfQs1g1wTlkieX5CuhTI%2Fuploads%2FZq1MLuBnaNPmC8dTWxYy%2Fimage.png?alt=media&#x26;token=a5d3339e-3cc5-4397-a871-4a01475d73be" alt=""><figcaption></figcaption></figure>
{% endstep %}
{% endstepper %}

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

{% content-ref url="personalnyi-kanal-api/otpravka-soobshenii" %}
[otpravka-soobshenii](https://docs.suvvy.ai/ru/kanaly/personalnyi-kanal-api/otpravka-soobshenii)
{% endcontent-ref %}

{% content-ref url="personalnyi-kanal-api/poluchenie-soobshenii" %}
[poluchenie-soobshenii](https://docs.suvvy.ai/ru/kanaly/personalnyi-kanal-api/poluchenie-soobshenii)
{% endcontent-ref %}