> 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/messages.md).

# Обмен сообщениями

## Входящие сообщения

Все сообщения от пользователей, необходимо отправлять на URL-адрес для входящих сообщений, настроенный в Fasttrack для канала "API messenger".

URL для входящих сообщений:

{% code overflow="wrap" %}

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

{% endcode %}

{% tabs %}
{% tab title="Body" %}

```json
{
  "chat": {
    "client_id": "{{ user_id }}",
    "name": "{{ user_name }}"
  },
  "id": "{{ message_id }}",
  "payload": {
    "text": "/start",
    "type": "text",
    "deeplink_params": {
      "c": 111,
      "n": 222
    }
  }
}
```

{% endtab %}

{% tab title="Fields" %}

{% endtab %}
{% endtabs %}

Пример запроса в формате JSON:

```json
{
  "id": "1",
  "chat": {
    "client_id": "00000000-0000-0000-0000-000000000000",
    "name": "Иван"
  },
  "timestamp": 1619676736171,
  "payload": {
    "type": "text",
    "text": "Текст сообщения"
  }
}
```

* `id` - ID сообщения на вашей стороне
* `chat.client_id` - ID клиента на вашей стороне
* `chat.name` - имя клиента (не обязательно)
* `timestamp` - время отправки сообщения
* `payload.type` - тип сообщения (пока только text)
* `payload.text` - содержание сообщения (для payload.type == text)

{% hint style="info" %}
`client_id` создается на вашей стороне. \
Максимальная длина идентификатора – 36 символов.
{% endhint %}

## Исходящие сообщения

Сообщения, созданные на стороне Fasttrack, будут отправляться на указанный в настройках канала "API messenger" адрес Webhook URL.

Пример сообщения с ответом оператора из Fasttrack:

```json
{
  "id": "00000000-0000-0000-0000-000000000000",
  "chat": {
    "uuid": "00000000-0000-0000-0000-000000000000",
    "client_id": "00000000-0000-0000-0000-000000000000"
  },
  "sender": {
    "type": "operator",
    "name": "Nikolay",
    "avatar": null
  },
  "timestamp": 1619676206524,
  "payload": {
    "type": "text",
    "text": "Текст сообщения"
  }
}
```

* `id` – ID сообщения в Fasttrack;
* `chat.uuid` – ID клиента в Fasttrack;
* `chat.client_id` – ID клиента на вашей стороне
* `sender.type` – тип отправителя (operator или bot)
* `sender.name` – имя отправителя (например имя оператора)
* `sender.avatar` – аватар отправителя (может быть пустым)
* `timestamp` – время отправки сообщения
* `payload.type` – тип сообщения (пока только text)
* `payload.text` – содержание сообщения (для payload.type == text)