HIKO Wish Keeper

Нужны два действия: включить app embed в теме и включить список желаний в настройках приложения.

Шаг 1 — включить app embed

1. Откройте HIKO Wish Keeper в админке Shopify
2. Нажмите «Включить в теме» в верхней части страницы — редактор темы откроется с уже выбранным app embed
3. Убедитесь, что переключатель включён, и сохраните в редакторе темы

Шаг 2 — включить список желаний в настройках

1. Вернитесь на страницу Настройки в HIKO Wish Keeper
2. В разделе Страницы товара включите «Список желаний на страницах товара»
3. В разделе Страницы коллекций включите «Список желаний в сетке товаров»
4. Нажмите Сохранить

После этого кнопки появятся в магазине автоматически. Код темы менять не нужно.

App embed — самая частая причина того, что «ничего не появляется». Всё, что это приложение рисует в магазине — кнопки, страница аккаунта, страницы общих списков — загружается этим единственным app embed.

Да. В Настройках HIKO Wish Keeper включите «Требовать вход». Пока эта опция включена, для неавторизованных посетителей список желаний вообще не загружается и кнопки не появляются.

Оставьте её выключенной, если хотите, чтобы сохранять товары могли и гости. Их списки живут в их собственном браузере и объединяются с аккаунтом при первом входе, так что ничего не теряется.

Страница аналитики собирает всё, что нужно для понимания поведения покупателей.

• Все покупатели со списками желаний и сохранённые ими товары
• Самые часто сохраняемые товары магазина
• Доставляемость, открытия и переходы по уведомлениям
• Активность публикаций по платформам (Facebook, Twitter, Pinterest, WhatsApp, LINE)
• Характер просмотров товаров и динамика популярности
• Конверсия и статус оплаты черновиков заказов
• Сравнение активности по дням и неделям
• Экспорт адресов покупателей и данных списков в CSV

Страница аккаунта — это страница вашего магазина, которая собирает всё, что приложение ведёт для покупателя. Она находится по адресу /apps/hwl/account и устроена из вкладок: список желаний, а после входа — заказы, адреса, профиль, настройки уведомлений и черновики заказов.

По умолчанию она включена. Отключить её можно в Страница аккаунта > Страница аккаунта; тогда этот адрес перестаёт работать, а ссылки на него исчезают из магазина.

Страницу аккаунта рисует app embed — так же, как кнопки. Если embed выключен, покупатель дойдёт до страницы, но вместо своего аккаунта увидит короткое сообщение о загрузке.

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

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

Вход тоже работает в обоих случаях. Ссылка для входа, которую выдаёт приложение, ведёт на /customer_authentication/login: Shopify направляет клиента на нужный экран входа в зависимости от версии вашего магазина, а затем возвращает его туда, где он был.

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

Откройте Страница аккаунта > Вкладки. У каждой вкладки есть переключатель и значок, а стрелки меняют порядок. Заданный вами порядок — именно тот, который увидят покупатели.

Вкладки: Профиль, Адреса, Список желаний, Заказы, Черновики заказов и Настройки уведомлений. Последние две требуют платного тарифа; все остальные включены сразу.

Два правила стоит знать:

• Кроме списка желаний, все вкладки требуют входа. Неавторизованный посетитель увидит только список желаний, что бы вы ни включили.
• Выключение вкладки лишь скрывает её и ничего не удаляет. Включите снова — данные на месте.

Всё находится в разделе Страница аккаунта, а живой предпросмотр рядом следует за каждым изменением.

1. Оформление — четыре варианта: боковая панель, вкладки, панель плиток и аккордеон
2. Цвета — светлая, тёмная, тёплая или автоматическая (автоматическая следует системной настройке посетителя)
3. Цвет бренда — для кнопок, ссылок и активной вкладки. В тёмной теме он автоматически осветляется, чтобы тёмный цвет бренда не исчез
4. Свой CSS — для того, что не покрывают настройки; действует только внутри страницы аккаунта

Да, на платном тарифе. В Страница аккаунта > Вкладки раскройте Профиль и добавьте поля: текст, список с вашими вариантами, дата или флажок.

Ответы сохраняются как метаполя покупателя Shopify, поэтому доступны в Shopify Flow, в сегментах и в теме. Панель Где хранятся поля на той же странице показывает точный namespace и ключ каждого поля.

Три вещи, которые стоит знать заранее:

• Тип поля нельзя изменить позже. Это ограничение Shopify. Выбирайте его сразу правильно: смена типа означает новое поле.
• Удаление поля убирает его только из формы. Уже собранные ответы и само определение остаются в Shopify. Так задумано: один неудачный щелчок не должен стирать данные покупателей всего магазина.
• На бесплатном тарифе существующие поля по-прежнему можно изменять и убирать. Закрыто только добавление новых.

Сердце в шапке магазина ведёт туда, где этот покупатель действительно может увидеть свой список.

• Без входа — на отдельную страницу списка желаний
• После входа, вкладка списка включена — на вкладку списка желаний страницы аккаунта
• После входа, вкладка списка выключена — на отдельную страницу списка желаний

Если список открывается всплывающим окном или боковой панелью, сердце сохраняет это поведение и никуда не ведёт.

В разделе Страница аккаунта > После входа выберите один из трёх вариантов: страница аккаунта (по умолчанию), главная страница или страница на ваш выбор.

Для своего варианта укажите путь, начинающийся со слэша, например /pages/members. Полные URL отклоняются: перенаправление принимает только пути внутри вашего магазина, а отклонённое значение молча возвращается к странице аккаунта.

Эта настройка действует для любого входа, включая значок аккаунта в шапке вашей темы.

У HIKO Wish Keeper один платный тариф с оплатой по месяцам или по годам.

• Бесплатный — полный список желаний без ограничений на число списков и сохранённых товаров, а также аналитика на странице аналитики и публикация в соцсетях
• Professional — 6,99 $ в месяц или 62 $ в год. Добавляет уведомления по email, доступ к API, черновики заказов со счетами и свои поля профиля на странице аккаунта

Платный тариф включает 7 дней бесплатного пробного периода. Сменить тариф можно в любой момент на странице перехода на платный тариф.

Нет. Shopify автоматически считает пропорционально и зачитывает неиспользованную часть текущего тарифа. Вы платите только разницу.

При переходе с месячной оплаты на годовую оставшиеся дни месячного периода зачитываются в счёт годовой цены. Например, при смене в середине месяца неиспользованная половина месяца вычитается.

Всем этим занимается система оплаты Shopify — от вас ничего не требуется.

Через 7 дней Shopify пришлёт письмо с просьбой подтвердить регулярную подписку. Деньги не списываются автоматически: Shopify всегда требует явного подтверждения.

Если вы подтвердите, подписка продолжится как обычно. Без подтверждения в течение 2 дней магазин вернётся на бесплатный тариф, и платные функции будут недоступны до новой подписки.

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

Вид кнопки настраивается подробно — всё на странице настроек.

1. Измените форму, цвет и размер значка в Настройки > Общий стиль
2. Отдельно задайте активный цвет (сохранено) и неактивный
3. Выберите анимацию: пульсация, подпрыгивание или без анимации
4. Настройте размер значка и толщину линии
5. Следите за изменениями в живом предпросмотре

Да, отдельно для страниц коллекций и страниц товара.

1. Страницы коллекций: положение (сверху справа, сверху слева, снизу справа, снизу слева) и отступы
2. Страницы товара: показывать «поверх изображения» или «обычной кнопкой»
3. Размещение: рядом с «Добавить в корзину», под ценой или в выбранном вами месте
4. Стиль кнопки: «значок + текст» или «только значок»

Приложение поставляется с переводами на 15 языков: английский, традиционный китайский, упрощённый китайский, японский, корейский, немецкий, французский, испанский, итальянский, португальский, русский, вьетнамский, тайский, арабский и иврит. Покупатель видит язык своего браузера — настраивать ничего не нужно.

Страница Переводы нужна не для добавления языков, а для изменения формулировок.

1. Откройте страницу «Переводы» из меню
2. Выберите основной язык в списке
3. Измените подписи кнопок, сообщения и названия списков, которые хотите сформулировать иначе
4. Сохраните

Любой язык можно добавить своим переводом.

1. Откройте страницу Переводы
2. Нажмите «Добавить язык»
3. Введите код языка (ko для корейского, de для немецкого)
4. Переведите все тексты: подписи кнопок, всплывающие сообщения, названия списков, текст в окнах
5. Нажмите Сохранить

Если язык браузера покупателя совпадает с вашим кодом, используется ваш перевод. Все тексты, которые видят покупатели, остаются в ваших руках.

Покупатели могут поделиться любым своим списком с друзьями и близкими по отдельной ссылке.

1. Открыть страницу списка желаний и выбрать свой список
2. Нажать «Поделиться» и скопировать ссылку
3. Отправить её кому угодно — получателю не нужен аккаунт
4. Общая страница показывает все позиции со сведениями о товарах и ценами

Каждый свой список автоматически получает уникальный токен для обмена. Списками по умолчанию — «Избранное» и «Посмотреть позже» — тоже можно поделиться.

Да. Любой, кто откроет ссылку, может подписаться на этот список.

1. Открыть ссылку, присланную другом
2. Нажать «Подписаться», чтобы добавить список на свою страницу списков желаний
3. Списки, на которые есть подписка, отображаются рядом со своими
4. Изменения владельца списка приходят подписчикам автоматически

Покупатели могут публиковать сохранённые товары в соцсетях.

• Facebook — поделиться товаром с изображением и описанием
• Twitter / X — опубликовать запись со ссылкой на товар
• Pinterest — сохранить изображение товара
• WhatsApp — отправить ссылку сообщением
• LINE — поделиться через LINE
• Email — отправить ссылку на товар письмом
• Копировать ссылку — скопировать URL товара в буфер обмена

Включается в Настройки > Публикация в соцсетях. Вы выбираете показываемые платформы и можете изменить шаблон сообщения.

Покупатели автоматически получают уведомление, когда цена сохранённого товара снижается.

1. Откройте Уведомления > Настройки
2. Включите «Уведомления о снижении цены»
3. Задайте порог (любое снижение, процент или сумма)
4. Задайте частоту проверок (каждый час, ежедневно…)
5. Покупатели, давшие согласие, получают письма автоматически

Уведомления о поступлении отправляются только когда товар переходит из «нет в наличии» в «есть в наличии». При первом считывании остатков ничего не отправляется — это сделано намеренно: иначе все покупатели получили бы письмо в день установки.

Чтобы отправлять уведомления, нужно настроить поставщика email.

1. Откройте Уведомления > Настройки
2. Выберите поставщика: Resend, SendGrid, Brevo или собственный SMTP
3. Введите API-ключ и данные отправителя
4. Проверьте настройку кнопкой «Отправить тестовое письмо»
5. Включите нужные типы уведомлений
6. Задайте расписание автоматических проверок

Проще всего Resend — бесплатный API-ключ можно получить на resend.com.

Да. Письма можно оформить в стиле вашего магазина.

1. Откройте Уведомления > Шаблоны
2. Выберите тип уведомления (снижение цены, поступление…)
3. Выберите язык шаблона
4. Измените тему письма
5. Приведите HTML-текст к стилю вашего бренда
6. Добавьте текстовую версию для программ без поддержки HTML
7. Используйте переменные {{product_title}}, {{new_price}}, {{product_url}} для динамического содержимого
8. Посмотрите предпросмотр перед сохранением

Помощь ИИ позволяет быстро получить аккуратный шаблон.

Черновик заказа позволяет вам собрать заказ за покупателя из сохранённых им товаров. Это функция платных тарифов.

• Создание черновика прямо из сохранённых товаров покупателя
• Отправка счёта, чтобы покупатель завершил покупку
• Отслеживание статуса: черновик, отправлен, открыт, переход, завершён
• Отмена или удаление черновика в любой момент
• Все черновики и их статусы — на отдельной странице

На вкладке Черновики заказов страницы аккаунта. Включите её в Страница аккаунта > Вкладки — по умолчанию она выключена, поскольку требует платного тарифа.

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

В прежних версиях для этого был блок темы, который нужно было вставлять вручную в редакторе темы. Эти блоки убраны: вкладка страницы аккаунта их заменяет, и добавлять в тему больше нечего.

Всё делается на странице Черновики заказов в HIKO Wish Keeper.

1. На странице Черновики заказов найдите покупателя
2. Нажмите на покупателя, чтобы увидеть сохранённые им товары
3. Отметьте флажками позиции, которые нужно включить
4. Нажмите «Создать черновик заказа (N)», где N — число выбранных позиций
5. В окне при необходимости задайте скидку (процент или сумму), срок резерва и примечание
6. «Создать» покажет сводку с разбивкой цен
7. «Подтвердить» создаёт черновик, «Подтвердить и отправить» создаёт его и сразу отправляет счёт

Покупатель получит письмо со ссылкой на оплату. Все статусы — черновик, отправлен, открыт, переход, завершён — отслеживаются на странице «Черновики заказов».

Черновики заказов требуют тарифа Professional (6,99 $ в месяц или 62 $ в год).

Если кнопок не видно, проверьте по порядку.

• Включена ли функция в Настройки > Страницы товара или Страницы коллекций?
• Включён ли app embed этого приложения в редакторе темы, раздел «App embeds»?
• Не включена ли в настройках опция «Требовать вход»? Тогда список не загружается для неавторизованных посетителей
• Очистите кэш браузера и перезагрузите страницу
• Поддерживает ли тема блоки приложений (тема Online Store 2.0)?
• Проверьте в режиме инкогнито
• Если ничего не помогло, напишите в поддержку

Страницу аккаунта рисует app embed. Если сообщение о загрузке остаётся, значит embed выключен.

1. Нажмите «Включить в теме» в верхней части страницы приложения
2. Убедитесь, что переключатель включён, и сохраните в редакторе темы

Если адрес отвечает «не найдено», значит выключена сама страница аккаунта — включите её снова в Страница аккаунта > Страница аккаунта.

Если письма не приходят, проверьте обычные причины.

• Верен ли API-ключ поставщика в Уведомления > Настройки?
• Подтверждён ли адрес отправителя у поставщика?
• Дал ли покупатель согласие на уведомления?
• Нет ли ошибок в истории отправок в Аналитика > Уведомления?
• Отправьте тестовое письмо, чтобы проверить настройку
• Посмотрите возвраты и проблемы доставки в панели вашего поставщика

Мы рады помочь.

• По техническим вопросам: [email protected]
• Отправьте сообщение прямо кнопкой поддержки в приложении
• Частые вопросы собраны в этом FAQ

Передавайте API-ключ как Bearer-токен в заголовке Authorization: Authorization: Bearer your_api_key. Ключи создаются на странице интеграции с API.

Подходят оба: числовой ID (например 1234567890) и полный Shopify GID (например gid://shopify/Customer/1234567890). Все эндпоинты принимают обе формы.

API использует обычные коды состояния HTTP.

• 200 — успех: запрос обработан
• 400 — неверный запрос: параметры некорректны или отсутствуют
• 401 — не авторизован: API-ключ отсутствует или недействителен
• 404 — не найдено: ресурса не существует
• 429 — слишком много запросов: превышен лимит
• 500 — ошибка сервера: проблема на нашей стороне

Эндпоинты списков принимают параметры запроса page и limit. В ответе есть объект pagination с текущей страницей, общим числом страниц и общим числом записей — так можно пройти по большим наборам результатов.

Да. Настройте URL вебхука на странице интеграции с API — приложение будет отправлять туда POST при каждом событии списка желаний. Опрашивать ничего не нужно.