# Shopify

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

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

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

## Що вміє асистент [#що-вміє-асистент]

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

## Перед стартом [#перед-стартом]

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

## Підключення [#підключення]

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

HAPP отримує доступ на читання товарів, покупців і замовлень та право створювати чернетки замовлень. Змінювати товари, ціни, наявні замовлення чи покупців HAPP не може.

## Налаштування [#налаштування]

Відкрийте шестерню на картці у вкладці **Інтеграції** асистента і ввімкніть, що асистенту дозволено.

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

## Обмеження [#обмеження]

* Асистент створює **чернетки** замовлень, а не завершені замовлення. Покупець оплачує за посиланням; до оплати замовлення лишається в **Чернетках**.
* Для адреси доставки береться країна вашого магазину. Якщо країну в магазині не вказано — Україна.
* Пошук за телефоном точний: покупець має назвати телефон, вказаний у замовленні. Формати на кшталт `050 111 22 33` чи `+380501112233` підходять.

## Якщо щось не працює [#якщо-щось-не-працює]

| Проблема                                                     | Причина                                                       | Що зробити                                                                                    |
| ------------------------------------------------------------ | ------------------------------------------------------------- | --------------------------------------------------------------------------------------------- |
| «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; він з'явиться після наступної синхронізації.             |

## Відключення [#відключення]

Видаліть застосунок HAPP у Shopify (**Налаштування** > **Застосунки**) або відключіть картку в HAPP. Видалення в Shopify автоматично вимикає інтеграцію в HAPP. Замовлення й чернетки, що вже є в Shopify, лишаються без змін.

## Далі [#далі]

* [CRM](/docs/integrations/crm) — усі CRM-інтеграції
* [Інструменти](/docs/agents/tools) — що асистент викликає під час розмови
* [Інтеграції](/docs/integrations) — повний каталог