# МТС Маркетолог

Эта инструкция помогает подключить интеграцию\
**МТС Маркетолог → IntellectDialog**.

После настройки вы сможете:

* отправлять SMS от зарегистрированного имени,
* получать статусы доставки через webhook,
* использовать несколько имён через отдельные провайдеры.

#### Важно:

* Имя отправителя **обязательно** должно быть зарегистрировано:\
  <https://marketolog.mts.ru/cabinet/namings-list>
* Токен действует **365 дней** — обновлять заранее, чтобы не пропустить.

## Получение API-токена в МТС Маркетолог

#### Шаги

1. Перейдите в кабинет МТС Маркетолог:\
   [**https://marketolog.mts.ru/cabinet**](https://marketolog.mts.ru/cabinet)
2. Откройте левое меню\
   → **Интеграции**
3. На странице Интеграций откройте блок **API**

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

1. Создайте новое подключение, выбрав тип авторизации:\
   **Токен**
2. Скопируйте созданный токен

> ❗ Токен действителен **1 год**.\
> По истечении срока его нужно **обновить** и заменить в IntellectDialog.

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

## Создание провайдера МТС Маркетолог в IntellectDialog

#### Шаги

1. Перейдите:\
   **IntellectDialog → Организация → Провайдеры**
2. Нажмите **Создать провайдера**
3. Выберите тип: **МТС Маркетолог**
4. Вставьте параметр:

* API-токен

5. Заполните поле **NAMING** — имя отправителя

> ❗ Поле **NAMING обязательно**.\
> Оно не может быть пустым даже для тестовой рассылки.

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

6. Сохраните провайдера.

#### Несколько имён отправителя?

Создавайте отдельный провайдер под каждое имя.

## Настройка вебхука МТС Маркетолог

После создания провайдера в IntellectDialog необходимо:

1. Вернуться на страницу **API** в ЛК МТС Маркетолог
2. Указать URL вебхука:

```
https://connect.intellectdialog.com/api/mtsmarketologwh/webhook/{provider_id}
```

Где `{provider_id}` — ID вашего провайдера из IntellectDialog.

3. Сохранить изменения.

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

## Проверка интеграции

1. Отправьте тестовую SMS через IntellectDialog
2. Убедитесь, что webhook-уведомления приходят корректно


---

# 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.intellectdialog.com/sms-provaidery/mts-marketolog.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.