Appearance
Каталог интеграций
Каталог находится в разделе Интеграции → Каталог.
В каталоге собраны готовые подключения к внешним сервисам: платформам интернет-магазинов, рекламным кабинетам и провайдерам ИИ. Интеграции сгруппированы по категориям. На карточке каждой интеграции указано, что она делает, и показан статус подключения.
Доступные интеграции
| Категория | Интеграция | Что делает |
|---|---|---|
| Электронная коммерция | InSales | Импорт товаров и заказов из магазина на InSales, передача статусов заказов |
| Shopify | Импорт товаров, категорий, заказов и клиентов из магазина на Shopify | |
| Яндекс Кит | Импорт заказов и клиентов из магазина на Яндекс Кит, передача статусов заказов | |
| Рекламные кабинеты | Яндекс Аудитории | Экспорт сегментов в рекламный кабинет для настройки таргетинга |
| VK Реклама | Экспорт сегментов в аудитории VK Рекламы. Пока недоступна: на карточке стоит метка «Скоро» | |
| Искусственный интеллект | Языковая модель | Свой ключ языковой модели для ИИ-агента на главной. Без подключения используется ключ платформы |
| Генерация картинок | Свой ключ генерации картинок для рассылок, которые готовит ИИ-агент. Без подключения используется ключ платформы |
Статусы подключения
| Статус | Что означает |
|---|---|
| Не подключена | Подключение начато, но не завершено |
| Подключена | Интеграция работает |
| Ошибка | Внешний сервис вернул ошибку. Текст ошибки показан на странице интеграции |
| Отключена | Интеграция выключена |
Как подключить интеграцию
- Откройте Интеграции → Каталог и нажмите «Подключить» на карточке интеграции. Если интеграция уже подключалась, кнопка называется «Настроить».
- На странице интеграции нажмите «Настроить» и заполните поля подключения (см. ниже). Для Яндекс Аудиторий вместо формы нажмите «Подключить»: откроется страница авторизации Яндекса, после входа вы вернётесь в ЛК.
- Нажмите «Сохранить».
- Нажмите «Проверить подключение». Проверка ставится в очередь, её результат появится в блоке «Последние синхронизации» и в журнале синхронизаций.
Поле «Название подключения» есть у всех интеграций — это подпись, под которой подключение показывается в ЛК.
Поля подключения
| Интеграция | Поля |
|---|---|
| InSales | Служебный домен магазина в InSales, Идентификатор API, Пароль API |
| Shopify | Домен магазина Shopify, Токен доступа Admin API, Ключ API, Секретный ключ API, Секрет вебхука |
| Яндекс Кит | Токен API. Токен создаётся в личном кабинете Яндекс Кит: Настройки → API |
| Языковая модель | Провайдер (Anthropic или OpenAI-совместимый), Адрес API (необязательно, по умолчанию адрес провайдера), Модель (необязательно, по умолчанию первая модель провайдера), Ключ API |
| Генерация картинок | Провайдер (openai — OpenAI Images API, yandex_art — YandexART), Адрес API, Модель, Каталог Yandex Cloud (только для YandexART), Ключ API |
Секретные поля — пароли, токены и ключи — после сохранения не показываются. Если при редактировании оставить такое поле пустым, сохранённое значение не изменится.
WARNING
Адрес API должен вести на внешний сервис. Запросы на внутренние и локальные адреса не выполняются.
Страница интеграции
На странице подключённой интеграции показаны:
- Статус и текст ошибки, если она есть;
- Последняя синхронизация — время последнего обмена данными с внешним сервисом;
- значения полей подключения, кроме секретных;
- Последние синхронизации — 10 последних запусков со ссылкой на весь журнал.
В зависимости от интеграции на странице есть дополнительные блоки.
Что включено (InSales, Яндекс Кит). Переключатели функций во внешнем сервисе: кнопки «Включить» и «Выключить».
| Интеграция | Переключатель | Описание |
|---|---|---|
| InSales | Сбор отзывов | Отзывы, оставленные клиентами, передаются в InSales |
| InSales | Сбор статусов заказов | InSales присылает изменения статусов заказов через вебхук. При включении в проекте заводятся статусы delivered, declined и returned |
| InSales | Поддержка вариантов товаров | Товары с вариантами импортируются как отдельные позиции |
| Яндекс Кит | Сбор статусов заказов | Яндекс Кит присылает изменения статусов заказов через вебхук. При включении в проекте заводятся статусы заказов Кита |
Импорт данных (Shopify, Яндекс Кит). Импорт запускается автоматически раз в сутки. Чтобы запустить его сразу, нажмите «Импортировать» напротив нужной операции, для каталога Shopify — «Запустить полный импорт». Shopify импортирует каталог, заказы и клиентов, Яндекс Кит — заказы и клиентов.
Права доступа Shopify и Вебхуки Shopify. Показывают, какие права выданы приложению в Shopify и настроены ли вебхуки на создание, изменение и удаление товаров и категорий. Для импорта нужны права на чтение товаров и коллекций, заказов (в том числе старше 60 дней для первого полного импорта) и клиентов. Чтобы перепроверить права и вебхуки, нажмите «Обновить вебхуки».
Выгрузка сегментов в рекламный кабинет
Для Яндекс Аудиторий на странице интеграции есть блок «Что синхронизируется» — список выгруженных сегментов.
- Подключите Яндекс Аудитории.
- Откройте сегмент в разделе CDP → Сегменты (статичный или динамический) и в меню действий выберите «Выгрузить в …» с названием подключения.
- Выгрузка ставится в очередь. Её статус виден в блоке «Что синхронизируется» и в журнале синхронизаций.
В блоке «Что синхронизируется» можно повторить выгрузку кнопкой «Синхронизировать» или удалить связь кнопкой «Удалить». При удалении связи аудитория в рекламном кабинете остаётся.
INFO
Сегмент выгружается файлом с хешированными email и телефонами. Яндекс не принимает аудитории меньше 100 записей.
Как отключить интеграцию
На странице интеграции нажмите «Отключить» и подтвердите действие. Настройки подключения и связи будут удалены.
Права доступа
В настройках роли за интеграции отвечают три группы прав: Каталог интеграций, Подключения (просмотр, подключение и настройка) и Журнал синхронизаций. Подключать, настраивать и запускать синхронизации может только пользователь с правом «Подключение и настройка». См. Роли.