Документация
Что означает каждый экран и по каким правилам приложение живёт, когда на него не смотрят.
Кабинет
Он открывается внутри вашей админки Shopify, в разделе приложений. Отдельного входа нет: Shopify называет нам открытый магазин, его мы и показываем. Язык кабинета — язык вашей админки.
загрузился ли виджет на живой витрине, на каком домене и когда.
цвет, сторона экрана, кнопка или полоса.
сколько вопросов задали, на сколько ответили и сколько промахнулись — по времени.
просьбы, на которые каталог не смог ответить, — с датой, страной и контактом, если его оставили. Выгружается в CSV или PDF.
полный журнал: каждый вопрос, что пришло в ответ и почему.
подписка, её состояние и где ею управлять.
Как читается каталог
Через Admin API с правом read_products, сразу после установки: названия, описания, цены, наличие, обложки и ссылки. Это API, а не обход витрины, поэтому магазин, ещё закрытый паролем, читается целиком.
Он обновляется сам. Правки товаров намеренно не приходят событиями: одна правка запускала бы у нас перечитывание и переиндексацию этого товара, а массовая правка тысячи товаров запустила бы это тысячу раз.
Языки
Подбор говорит по-английски, по-испански, по-гречески и по-русски и выбирает опубликованный язык витрины, прочитанный по праву read_locales, если он из их числа, — намеренно не язык админки. На каком языке вы читаете свою панель, ваше дело; покупатель видит витрину.
Валюта и наличие
Цены — в валюте вашего магазина. У наличия три состояния, а не два: в наличии, предзаказ и нет. Предзаказ показывается предзаказом, с ожидаемой датой: сказать покупателю «в наличии» и привести его к кнопке «Предзаказ» хуже, чем не сказать ничего.
Адреса, по которым отвечает витрина
Витрина отвечает не по одному адресу: по вашему домену, по имени вида myshopify, которым пользуются ссылки из админки, и по разовому адресу, на котором редактор темы открывает предпросмотр. Все три открываются при установке — имена нам называет сама площадка, вписывать нечего. Вкладка «Установка» их перечисляет.
Что видит покупатель
Кнопка в углу. Её нажатие грузит рамку с нашего домена — именно она не даёт стилям вашей темы и нашим мешать друг другу в обе стороны. Ответ — один товар с ценой, наличием и одной строкой о том, почему он подходит, плюс альтернативы, если они есть.
Если магазин показывает баннер согласия, подбор читает ответ посетителя и уважает его: при отказе в маркетинге форма контакта не предлагается вовсе, при отказе в аналитике события использования не отправляются.
Ограничения
Один тариф и никакой оплаты за вопрос, но сервис защищают два ограничения: у каждого магазина есть месячный бюджет на языковую модель — когда он исчерпан, до конца месяца ответы идут из поиска по каталогу без модели, — и в каждом разговоре можно задать ограниченное число вопросов в минуту.
Снятие приложения
Выключите блок и снимите приложение в админке. Списания прекращаются со снятием. Данные стираются, когда об этом попросит Shopify, — через 48 часов; до этого повторная установка возвращает ваш же каталог и ваш же отчёт о спросе.