Руководство Mokapen

Shopify

Подключите магазин Shopify к Mokapen, чтобы перенести в CRM клиентов (контакты), товары (с вариантами и количествами) и заказы магазина, а также экспортировать в Shopify товары, созданные или обновлённые в Mokapen, когда направление синхронизации это позволяет. Цель — объединить e-commerce и коммерческое управление: мастер-данные, каталог и историю покупок в одном рабочем пространстве.

Общий обзор: Интеграции. Импортированные заказы становятся в Mokapen заказами продажи (модуль Заказы), а не сделками в воронке.

Требования

• Активный магазин Shopify (URL, заканчивающийся на .myshopify.com).
• Разрешение на авторизацию приложения Mokapen в Shopify (OAuth) с учётной записью администратора магазина.
• Тариф Mokapen подходящий Premium для e-commerce интеграций. Без тарифа кнопка подключения открывает экран апгрейда; в некоторых сценариях Shopify может также предложить регулярное списание, связанное с приложением.
• Права Mokapen на контакты, товары и заказы в вашей организации (см. Роли и права).
• Доступ к Интеграциям (участник/админ в зависимости от white-label и роли в org).

Подключение магазина Shopify

1. Меню пользователя → Интеграции → Shopify.
2. Введите название магазина (как в Shopify Admin; полный URL заканчивается на myshopify.com). Если не уверены, откройте панель Shopify и посмотрите адресную строку браузера.
3. Запустите авторизацию: вас перенаправит в Shopify для принятия разрешений.
4. Примите запрошенные scope (чтение/запись клиентов и товаров, чтение заказов — см. ниже).
5. Вернитесь в Mokapen: магазин отображается как подключённый. Если вы пришли из Shopify App Store, возможно, потребуется выбрать организацию Mokapen, на которую устанавливается подключение.

Если не примете в Shopify, данные не синхронизируются. После подключения Mokapen регистрирует webhook в магазине: обновления клиентов, товаров и заказов могут поступать в реальном времени, помимо bulk sync, которую запускаете вы.

Что запрашивает Mokapen у Shopify

При OAuth-авторизации Mokapen обычно запрашивает:

• read_customers / write_customers — чтение (и потенциальная запись) клиентов Shopify.
• read_products / write_products — чтение и обновление товаров/вариантов.
• read_orders — чтение заказов магазина.

Mokapen не заменяет панель Shopify для checkout, тем или платежей: выравнивает данные в CRM (и для товаров — из CRM). Если отозвать приложение в Shopify или истечёт токен, отключите и подключите снова из Mokapen. Shopify также требует GDPR endpoint (запрос данных / redact): Mokapen обрабатывает их через webhook.

Что синхронизируется

В Mokapen (импорт / webhook)

• Клиенты → Контакты — мастер-данные Shopify попадают в адресную книгу; при наличии данных компании может создаваться/связываться и компания. Webhook при create/update/delete клиентов.
• Товары и варианты → Товары — каталог с вариантами; количество инвентаря Shopify на варианте маппится на поле количества варианта Mokapen (это не отдельный складской модуль).
• Заказы → Заказы — заказы Shopify становятся в Mokapen заказами продажи (со строками), а не сделками в воронке. Webhook при обновлениях заказов.
• Брошенные checkout — при sync может быть путь импорта брошенных checkout Shopify (как заказы/связанные данные). Отчёты, посвящённые брошенным корзинам / e-commerce аналитике на странице, по-прежнему помечены как Скоро: не считайте их уже активной функцией.

В Shopify (экспорт)

• Товары — при направлении sync «в Shopify» или «оба», Mokapen может экспортировать/обновлять товары в магазине (bulk sync и sync-out при сохранении связанного товара, если интеграция активна).
• Контакты и заказы на выход — несмотря на scope write_customers, автоматический «sync out» экспорт сегодня на практике касается в основном товаров. Не предполагайте полный двусторонний экспорт контактов или заказов: клиенты поступают прежде всего из Shopify в Mokapen (импорт + webhook). Если маркетинговый текст говорит о «двусторонности только контактов», проверьте в своей среде, что sync реально делает после подключения.

В конфиге интеграция также перечисляет услуги, но отдельной sync e-commerce услуг, как для товаров, нет: для каталога магазина используйте Товары.

Настройки после подключения

На странице Shopify, с подключённым магазином, обычно настраивают:

Направление sync

• Только в Mokapen — данные идут из Shopify в CRM.
• Оба — импорт + экспорт (где поддерживается; сегодня в основном товары на выход).
• Только в Shopify — push из Mokapen в магазин (товары).

Сущности

Контакты, заказы и товары отображаются как области sync (часто уже выбраны и не изменяются в UI). Историческая sync и webhook покрывают эти три блока.

Общий доступ к sync

Тот, кто подключил магазин, может разрешить другим участникам использовать то же подключение (вся организация или выбранные пользователи), чтобы не всем повторять OAuth.

Дубликаты и конфликты

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

Автоматическая vs ручная sync

При активной автоматической sync обновления (и webhook) поддерживают данные согласованными; вы всё равно можете запустить ручную синхронизацию для начальной исторической загрузки. Перед sync отметьте авторизацию на обработку/передачу данных, требуемую на странице.

Рекомендуемый поток

1. Подключите магазин и проверьте Подключённый аккаунт.
2. Задайте направление sync (в большинстве случаев: Только в Mokapen или Оба, если хотите обновлять товары Shopify из Mokapen).
3. Настройте дубликаты/конфликты и общий доступ.
4. Авторизуйте и запустите первую sync (на больших каталогах может занять время).
5. Проверьте в Mokapen: Контакты, Товары (варианты/кол-во), Заказы.
6. Оставьте webhook активными: новые заказы и обновления клиентов/товаров будут поступать без повторного запуска всего.

Отключение

Из Интеграции → Shopify → отключить. В модальном окне можно выбрать, сохранить ли в Mokapen уже импортированные контакты, заказы и товары, или управлять ими по предложенным опциям. После отключения webhook перестают обновлять; данные в CRM остаются, если вы выбрали сохранение. Приложение можно также отозвать в панели Shopify.

Частые проблемы

• Недействительное имя магазина — используйте поддомен *.myshopify.com, а не только кастомный домен витрины.
• Заблокированная кнопка / апгрейд — нужен подходящий Premium тариф для e-commerce.
• Заказы не в Сделках — это правильно: они идут в Заказы. Откройте Продажи → Заказы.
• Количество товара — приходит из количества варианта Shopify; это не полноценный WMS.
• Отчёты корзин / аналитика — если на странице «Скоро», они ещё не работают.
• Истёкший токен / sync остановилась — отключите и подключите снова; проверьте, что приложение не удалено в Shopify.

Частые вопросы

В: Где найти URL магазина?

О: В адресной строке панели Shopify Admin: заканчивается на myshopify.com.

В: Заказы Shopify становятся сделками?

О: Нет. В Mokapen они становятся заказами продажи (со строками). Любые тексты про «сделки» неточны относительно текущего поведения.

В: Можно обновлять товары Shopify из Mokapen?

О: Да, при направлении sync с экспортом и активной интеграцией: товары (варианты) можно отправлять/обновлять в магазине.

В: Контакты обновляются и из Mokapen в Shopify?

О: Импорт и webhook приносят клиентов Shopify в CRM. Автоматический экспорт контактов сегодня не основной путь (в отличие от товаров): проверьте на своём тарифе/в среде после подключения.

В: Нужен ли WooCommerce вместе с Shopify?

О: Нет: это две альтернативные e-commerce интеграции. Используйте Shopify, если магазин на Shopify; см. руководство WooCommerce, если используете WordPress/Woo.