# Медиалогия

Отслеживайте упоминания в СМИ и соцмедиа прямо в чате

Медиа-мониторинг — упоминания в СМИ и соцмедиа, тональность, аналитика

## Как агент работает с Медиалогия

Агент работает с SOAP-сервисом Медиалогии под логином и паролем кабинета СоцМедиа. Он выгружает публикации отчёта за выбранные даты, снимает метрики отдельных сообщений — лайки, репосты, комментарии и просмотры — и счётчики публикаций по дням и по объектам мониторинга. Аудитория, вовлечённость и тональность приходят полями самой публикации, поэтому сводка за сутки и сравнение динамики негатива собираются перебором публикаций, а не готовой агрегатой.

Данных «вообще по бренду» здесь не существует: всё живёт внутри отчётов, а границы отчёта задаёт поисковый запрос на собственном синтаксисе Медиалогии. Поэтому человеческую формулировку агент сначала прогоняет через ConvertQuery и получает корректный запрос, а не подбирает синтаксис наугад. Тональность он тоже не пересчитывает: оценки приходят от Медиалогии, и агент показывает их как есть.

Списка отчётов у сервиса нет — каждая операция чтения требует номера отчёта, который агент либо получил, создав отчёт, либо услышал от вас. Поэтому первый разговор о новой теме начинается с создания мониторинга, а не с поиска подходящего среди существующих.

На запись агент трогает только мониторинги: создаёт отчёт по поисковому запросу или по списку URL публикаций, переписывает запрос существующего и по вашей просьбе удаляет его. До создания он проверяет запрос через ConvertQuery, а ссылки на площадки прогоняет через нормализацию, чтобы отчёт не встал на битый адрес; удаление подтверждает отдельно — вместе с отчётом уходит и его история. Сами публикации и оценки тональности остаются на чтение.

Выгрузка публикаций приходит страницами, и ни общего числа, ни курсора сервис не сообщает — агент читает до страницы короче запрошенной и называет интервал, за который посчитал. Отказ Медиалогия возвращает внутри успешного ответа отдельным полем, поэтому пустую выдачу агент отличает от отказа и не выдаёт второе за отсутствие упоминаний.

## Сценарии интеграции

### Упоминания бренда в СМИ и соцмедиа
Агент выгрузит публикации отчёта за выбранные даты и покажет сообщения с самой большой аудиторией и вовлечённостью.

### Тональность против конкурентов
Агент разложит публикации по тональности и объектам мониторинга и покажет, у кого негатив растёт быстрее — у вас или у конкурента.

### Новый мониторинг из формулировки словами
Агент переведёт человеческий запрос на синтаксис Медиалогии через ConvertQuery и заведёт по нему отчёт-мониторинг.

### Ежедневная сводка по мониторингу
Агент заберёт публикации, появившиеся с прошлого запуска, посчитает их по дням и назовёт площадки и авторов, давших основной объём.

### Отчёт по своим ссылкам
Агент заведёт отчёт по списку URL публикаций — например, по подборке из пресс-клиппинга — и покажет их аудиторию, вовлечённость и тональность.

### Правка мониторинга без потери истории
Агент проверит ссылки на площадки, перепишет поисковый запрос существующего отчёта и дозаберёт публикации с прошлой даты, а удалит отчёт только по отдельному подтверждению.

## Как подключить

**Перед подключением**

- Действующий договор и доступ в кабинет СоцМедиа
- Персональный менеджер Медиалогии, включающий доступ к API
- Незакончившийся тарифный лимит тем и сообщений

### Войдите в кабинет СоцМедиа на sm.mlg.ru
Учётная запись выдаётся по договору, вход — https://sm.mlg.ru. API принимает ту же пару логин/пароль, что и кабинет: отдельного ключа у Медиалогии нет.

### Попросите менеджера включить API
Без включения на стороне Медиалогии SOAP-сервис не отвечает на запросы. Контакты персонального менеджера — в «Профиль» (значок с инициалами справа вверху).

### Заведите отдельного пользователя
Настройки → «Системные» → «Пользователи» → «Добавить», роль «Администратор» или «Редактор»: с ролью «Просмотр» отчёты не создать. Приглашение придёт письмом.

### Проверьте срок и лимиты в «Профиль»
В «Профиль» видны логин, срок действия учётной записи и остаток тем и сообщений по тарифу: просроченная учётка или выбранный лимит валят запросы.

## Частые вопросы

### Как подключить Медиалогию?
Логином и паролем кабинета СоцМедиа: API принимает ту же пару, что и вход на sm.mlg.ru, отдельного токена у сервиса нет. Заведите под интеграцию пользователя с ролью «Администратор» или «Редактор» и попросите менеджера включить API.

### Что агент видит в Медиалогии?
Отчёт-мониторинг по его номеру и публикации этого отчёта за период — с тональностью, охватом и вовлечённостью в самой публикации, — метрики отдельных сообщений и счётчики публикаций по дням и по объектам мониторинга. Списка отчётов API не отдаёт: номер отчёта агент либо получает при создании, либо узнаёт от вас.

### Пишет ли агент в Медиалогию?
Да, в части мониторингов: агент может создать отчёт по поисковому запросу или списку URL публикаций, переписать запрос существующего и удалить отчёт. Сами публикации и оценки тональности он только читает.

### Что чаще всего мешает подключению?
Просроченная учётная запись, выбранный по тарифу лимит тем и сообщений или невключённый менеджером API — тогда SOAP-сервис на запросы не отвечает. Срок и остаток лимитов видны в разделе «Профиль».

[Открыть Медиалогия](https://sm.mlg.ru)