Интеграция вашего магазина с keyCRM настраивается в несколько шагов и позволит:
- мгновенно получать всю информацию о заказе (товары, скидки, данные доставки и т.д.);
- сохранять публикации (товары) с WIx в keyCRM;
- получать и отправлять трекинг коды в заказах;
- получать статусы оплаты заказов с Wix;
- отправлять остатки товаров на Wix.
Шаг 1. Создание приложения интеграции на Wix
Перейдите в Wix Developers и авторизуйтесь в правом верхнем углу сайта через аккаунт владельца или совладельца веб-сайта и перейдите в раздел «Пользовательские приложения».
Если вы первый раз подключаете подобную интеграцию, перейдите по ссылке, откроется окно с кнопкой «Перейти на Wix Studio» - нажмите на нее.
Далее в блоке «Создавайте и продавайте приложения с Wix Blocks» нажмите «Начать» и выберите любой шаблон — откроется страница с его настройками, которую можно просто закрыть и перейти напрямую в раздел «Пользовательские приложения».
В разделе «Пользовательские приложения» нажмите «Создать новое приложение» и выберите «Создать с нуля»:
- Затем откроется окно для выбора фреймворка, выберите «Собственный хостинг» и нажмите «Начать с нуля»:
- Укажите название приложения «keyCRM» или любое понятное вам:
Шаг 2. Предоставление доступов для интеграции
- Перейдите в разделе «Develop» →«Permissions» и нажмите «Add Permissions»:
- В этом окне, воспользуйтесь фильтром по категории «Wix Stores» и поставьте галочки возле полей, как на скрине ниже:
Обязательно обращайте внимание на их описание, поскольку бывают одинаковые названия. После этого нажмите «Save» и ваш список доступов должен выглядеть вот так:
Шаг 3. Создание вебхуков для передачи данных
- Перейдите в разделе «Develop» → «Webhooks» и нажмите «Create Webhook»:
- С помощью поиска найдите событие «Order Approved» из категории eCommerce и нажмите «Select Event»:
- Оставьте эту вкладку открытой, а в соседней откройте сайт https://webhook.site/. Скопируйте ссылку из поля «Your unique URL»:
- Оставьте эту вкладку открытой, переключитесь обратно на предыдущую вкладку и вставьте скопированную ссылку в поле «Add callback URL», сохраните нажатием кнопки «Subscribe»:
- Перейдите на вкладку «Home», если вы видите уведомление «Apps built for Wix Stores must support both Catalog APIs» — нажмите «Confirm Compatibility», поставьте галочку и нажмите «Confirm»:
- Далее нажмите «Distribute App» → «Install on a site» → «Release Version & Continue», выберите сайт, с которым будет работать интеграция, и предоставьте разрешения. После этого страница обновится и откроется панель управления сайта с установленными приложениями:
- После этого нужно сделать тестовый заказ. Вы можете сразу перейти в меню «Продажи» → «Заказы» и добавить новый заказ с любыми данными;
- Откройте вкладку с сайтом https://webhook.site/. Там вы увидите новый запрос с данными заказами, скопируйте его:
- В соседней вкладке откройте сайт https://jwt.ms/, вставьте скопированный код в поле «Enter token below (it never leaves your browser):». Прокрутите страницу до самого низа, найдите instanceId и скопируйте его значение в кавычках без \.
Сохраните это значение, оно понадобится для следующих настроек в CRM:
- Вернитесь в раздел «Собственные приложения» и откройте созданное ранее приложение;
- Перейдите в «Develop» → «Webhooks» и измените в созданном ранее вебхуке ссылку на https://sync.keycrm.app/webhook/wix:
- Добавьте еще три вебхука на события из категории eCommerce: Order Canceled, Payment Status Updated, Order With Fulfillments Updated. Указав для них также ссылку https://sync.keycrm.app/webhook/wix.
После сохранения всех событий окно «Webhooks» должно выглядеть так:
- Если у вас в нижнем левом углу окна возле кнопки «Manage App Distribution» появился восклицательный знак — нажмите на эту кнопку. В окне нажмите «Release Version», чтобы опубликовать изменения:
- Перейдите в «Develop» → «OAuth» и сохраните значения «App ID» и «App Secret Key» или просто оставьте вкладку в браузере открытой и переходите к следующему шагу:
Шаг 4. Подключение магазина в keyCRM
Перейдите в «Настройки» → «Источники». Появится список подключенных источников.
Нажмите в конце списка на кнопку «Добавить источник» и заполните поля:
- Название — укажите произвольное название источника;
- Источник — выберите «Wix»;
- App ID — вставьте App ID, который указан в Wix Developers на вкладке «OAuth»;
- App Secret Key — вставьте App Secret Key, который указан в Wix Developers на вкладке «OAuth»;
- Instance ID — введите скопированное ранее значение instanceId;
- Авторизоваться через Wix — нажмите и пройдите авторизацию через ваш аккаунт Wix.
Обратите внимание! Авторизация происходит в сплывающем окне, поэтому они обязательно должны быть разрешены в вашем браузере! - Менеджер — укажите менеджера, на которого сразу будут назначаться все заказы из этого магазина. Если добавить несколько менеджеров, то заказы будут назначаться на каждого менеджера по очереди. Можно оставить пустым;
- Валюта — укажите валюту магазина;
- При необходимости активируйте переключатель «Отправлять трекинг-код» и в поле «Статус» выберите статусы. При переходе заказа в один из выбранных статусов, трекинг-код с заказа из keyCRM будет автоматически отправлен на Wix;
- Когда все заполните, нажмите кнопку «Добавить».
После добавления источника все новые заказы сразу после оформления будут поступать в ваш кабинет keyCRM!
Изменения статусов заказов не передаются на Wix, но получив с CRM трек-номер, Wix дальше сам закроет заказ.
