> For the complete documentation index, see [llms.txt](https://docs.intellectdialog.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.intellectdialog.com/sms-provaidery/mts-marketolog.md).

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

Эта инструкция помогает подключить интеграцию\
**МТС Маркетолог → 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-уведомления приходят корректно