# Интеграция Shopping Assistant

Выберите способ отображения чата. Во всех вариантах сначала подготовьте [секцию ассистента и данные](../shopping_assistant.md#условия-запуска), затем проверьте ответы в [«Превью»](../setup/preview.md).

| Вариант | Когда подходит | Что реализует ваша команда |
| --- | --- | --- |
| [Web через кампанию](./web.md) | Нужен готовый чат на сайте с Web-интеграцией Gravity Field. | Настраивает кампанию, добавляет точку входа, оформляет чат и вставляет товарный шаблон. Виджет отправляет сообщения и отображает переписку. |
| [API](./api.md) | Нужен собственный интерфейс или другой клиентский канал. | Хранит состояние чата, отправляет запросы, отображает ответы и карточки, обрабатывает действия и события. |
| [Android / iOS SDK](/Integration/SDK/assistant.md) | Ассистент нужен в мобильном приложении. | Добавляет кнопку входа и товарную карусель, обрабатывает переходы. SDK обеспечивает экран чата и обмен сообщениями. |

## Где искать инструкции

- **Источники данных** — каталог, собственный поиск, наличие в магазинах и отзывы. Начните с [подготовки данных](./data/overview.md).
- **Web-интеграция** — готовый виджет и кампания. [Параметры виджета](./web_widget.md) пригодятся при настройке внешнего вида и поведения интерфейса.
- **API-интеграция** — последовательность реализации собственного чата. Точные поля запросов и ответов находятся в [API-справочнике](./reference/overview.md).
- **Трекинг событий** — передача показов, кликов и действий покупателя. Проверьте его [после реализации интерфейса](./tracking.md).

## До начала разработки

1. Получите ID секции и подтвердите, что для неё подключён Shopping Assistant.
2. Проверьте товары, доступные сценарии и контекст страниц.
3. Согласуйте место показа и контрольную группу кампании.
4. Определите, кто отвечает за кнопку, товарные карточки, поддержку и события.

Для API V2 нужны [API-ключ и базовая интеграция](/Integration/api_integration/v2/getting_started.md). Установка [Web-скрипта](/Integration/web_integration/script.md) описана отдельно. Не размещайте серверные API-ключи в публичном коде кампании.

## После интеграции

Проверьте чат на целевых страницах, в контрольной группе и при ошибках сети. Убедитесь, что события отправляются один раз: [трекинг](./tracking.md). Завершите [проверку запуска](../troubleshooting.md#чеклист-запуска).

Если вы меняете канал или используете новую функцию API, проверьте поддержку в выбранном интерфейсе. Серверная возможность не добавляет автоматически кнопку или обработчик в Web-виджет.