> For the complete documentation index, see [llms.txt](https://docs.fstrk.io/knowledge_base/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.fstrk.io/knowledge_base/channels/svoi-kanal-api/nastroika-vebkhuk-adresov.md).

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

Корректная настройка вебхук-адресов обеспечит двусторонний обмен данными между вашей системой и платформой Fasttrack.

## Ваш вебхук-адрес

Это URL-адрес вашего сервера, куда мы будем отправлять все события связанные с вашим API-каналом (сообщения операторов, контент сценариев чат-бота). 

Для получения событий от Fasttrack, необходимо подтвердить конечный адрес сервера, куда будут отправляться запросы:

1. Определите URL-адрес сервера, который будет принимать уведомления;
2. Настройте механизм подтверждения адреса (ответ на уведомление `confirmation`).

{% hint style="info" %}
Мы будем ждать ответ от вашего сервера в течении 2х секунд.
{% endhint %}

Вебхук-адрес добавляется в настройках API-канала.

<figure><img src="https://1710238474-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F15Vbfdlj1toq4QxXgBym%2Fuploads%2FzklkoqBJ6uKyvUeISN92%2F2025-04-15%20at%2015.50.05%402x.jpg?alt=media&amp;token=888db9ad-f928-45eb-a137-6e596da125b0" alt=""><figcaption></figcaption></figure>

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

Пример уведомления от Fasttrack:

```json
{
  "payload": {
    "type": "confirmation"
  }
}
```

Пример ответа (подтверждения) от вашего сервера:

```json
{
  "code": "AaAaAaAa"
}
```

Код подтверждения указан в настройках API-канала вашего проекта.

<figure><img src="https://1710238474-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F15Vbfdlj1toq4QxXgBym%2Fuploads%2FD3aQTPNeKSxrHb5SArvJ%2F2025-04-15%20at%2015.50.05%402x.jpg?alt=media&amp;token=2ad2984b-cc87-418d-826c-ff554b3cba79" alt=""><figcaption></figcaption></figure>

## Вебхук-адрес Fasttrack

Это URL-адрес платформы Fasttrack, на который ваш сервис должен передавать входящие сообщения от пользователей и другие события, связанные с выполнением бизнес-логики (например: запуск сценария для пользователя).

```
https://dashboard.fstrk.io/bots/receive_post/:bot uuid/api_messenger/
```

* `:bot uuid` – Уникальный идентификатор вашего проекта в Fattrack.

Подставьте идентификатор проекта или скопируйте адрес из настроек API-канала.

<figure><img src="https://1710238474-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F15Vbfdlj1toq4QxXgBym%2Fuploads%2FB20B09xPueMsDCyi7obk%2F2025-04-15%20at%2015.50.05%402x.jpg?alt=media&amp;token=283f93be-365f-44c7-8d73-44ec2c4abc5d" alt=""><figcaption></figcaption></figure>

{% hint style="warning" %}
**Rate limit:** 10 RPS (запросов в секунду). При превышении лимита запросы будут отклоняться с ошибкой <mark style="color:red;">`429`</mark>.
{% endhint %}