# Shopify

Подключите магазин Shopify, чтобы агент проверял статус заказа по телефону, оформлял заказы со ссылкой на оплату и отвечал по вашему каталогу

> Full REST + WebSocket API reference: https://api.happ.tools/reference

Shopify подключается через отдельное приложение, которое HAPP настраивает для вашего магазина. После подключения агент находит последние заказы покупателя по номеру телефона, оформляет новые заказы со ссылкой на оплату и отвечает на вопросы о товарах по вашему каталогу — в том числе «а такое есть?» по фото.

## Что умеет агент [#what-the-assistant-can-do]

* **Статус заказа по телефону** — находит покупателя по телефону из заказа и сообщает номер заказа, статус оплаты и доставки, товары, сумму и трек-номер, если у посылки он есть.
* **Оформление заказа** — создаёт в Shopify черновик заказа с выбранными вариантами (размер, цвет), именем, телефоном и адресом доставки покупателя и отправляет покупателю ссылку на оплату. Черновик помечается тегом `happ`, поэтому его легко найти в разделе **Заказы > Черновики**.
* **Ответы по каталогу** — знает ваши активные товары с ценами, вариантами и наличием и находит товар по фото, которое прислал покупатель.

## Перед началом [#before-you-start]

* **Магазин Shopify** на любом тарифе. Basic достаточно.
* **Аккаунт владельца или сотрудника**, который может устанавливать приложения в админке магазина.
* **Воркспейс HAPP** хотя бы с одним агентом, настроенным для общения с клиентами.
* **Shopify включён для вашего воркспейса** — интеграция включается отдельно для каждой компании. Попросите поддержку HAPP включить её и настроить приложение магазина; отправьте им адрес магазина (`your-store.myshopify.com`).

## Подключение [#connect]

1. В HAPP откройте **Интеграции** и найдите Shopify в разделе **Добавить CRM**.
2. Нажмите **Подключить** и введите адрес магазина — подойдёт `your-store`, `your-store.myshopify.com` или ссылка из админки магазина.
3. Откроется Shopify со списком того, что будет видеть HAPP: товары, покупатели и заказы. Нажмите **Установить**.
4. Вы вернётесь в **Интеграции**, а Shopify появится в разделе **Мои интеграции**.

HAPP запрашивает доступ на чтение товаров, покупателей и заказов и право создавать черновики заказов. Менять товары, цены, существующие заказы или покупателей HAPP не может.

## Настройки [#settings]

Нажмите на шестерёнку на карточке во вкладке **Интеграции** агента и включите то, что агенту разрешено делать.

* **Поиск** — статус заказа по телефону покупателя.
* **Создание** — черновики заказов со ссылкой на оплату.
* **Каталог** — поиск товаров по тексту и по фото. Первая синхронизация занимает несколько минут, затем каталог обновляется каждые 6 часов. Синхронизируются только активные товары.

## Ограничения [#limits]

* Агент создаёт **черновики заказов**, а не завершённые заказы. Покупатель оплачивает по ссылке; до оплаты заказ остаётся в **Черновиках**.
* Для адреса доставки берётся страна вашего магазина. Если страна в магазине не указана, используется Украина.
* Поиск по телефону точный: покупатель должен назвать телефон, указанный в заказе. Подходят оба формата — и `050 111 22 33`, и `+380501112233`.

## Решение проблем [#troubleshooting]

| Проблема                                                     | Причина                                                        | Что делать                                                                                   |
| ------------------------------------------------------------ | -------------------------------------------------------------- | -------------------------------------------------------------------------------------------- |
| «Shopify app for … is not set up yet»                        | HAPP ещё не создал приложение для вашего магазина              | [Напишите в поддержку](https://happ.tools/contacts) с адресом магазина.                      |
| «This Shopify store is already connected to another company» | Магазин подключён к другому воркспейсу HAPP                    | Сначала отключите его там или попросите поддержку перенести магазин.                         |
| «Shopify refused access — reconnect the store» (401)         | Приложение удалено или доступ отозван                          | Откройте **Интеграции** > **Shopify** и снова нажмите **Подключить**.                        |
| «Shopify blocks customer and order data for this app»        | Для приложения магазина не включён доступ к данным покупателей | [Напишите в поддержку](https://happ.tools/contacts) — это разовая настройка на стороне HAPP. |
| Товара нет в каталоге                                        | Товар в Shopify в статусе черновика или в архиве               | Сделайте его **Активным** в Shopify; он появится после следующей синхронизации.              |

## Отключение [#disconnect]

Удалите приложение HAPP в Shopify (**Настройки** > **Приложения**) или отключите карточку в HAPP. Удаление в Shopify автоматически выключает интеграцию в HAPP. Заказы и черновики, которые уже есть в Shopify, остаются без изменений.

## Дальше [#next]

* [CRM](/docs/integrations/crm) — все CRM-интеграции
* [Инструменты](/docs/agents/tools) — что агент вызывает во время разговора
* [Интеграции](/docs/integrations) — полный каталог