Ръководството на Мокапен

Shopify

Свържете магазина си в Shopify с Mokapen, за да пренесете клиентите (контакти), продуктите (с варианти и количества) и поръчките от магазина в CRM, както и да експортирате продукти, създадени или актуализирани в Mokapen, към Shopify, когато посоката на синхронизация го позволява. Помага да обедините електронната търговия и управлението на продажбите: основни данни, каталог и история на покупките в едно работно пространство.

Общ преглед: Интеграции. Импортираните поръчки стават поръчки за продажба в Mokapen (модул Поръчки), а не възможности в pipeline.

Изисквания

• Активен магазин Shopify (URL, завършващ на .myshopify.com).
• Право да упълномощите приложението Mokapen в Shopify (OAuth) с акаунт на администратор на магазина.
• Подходящ план Premium на Mokapen за интеграции с електронна търговия. Без план бутонът за свързване отваря екрана за надграждане; в някои потоци на 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 регистрира webhooks в магазина: така актуализациите на клиенти, продукти и поръчки могат да пристигат в реално време, в допълнение към масовата синхронизация, която стартирате сами.

Какво Mokapen иска от Shopify

По време на OAuth упълномощаването Mokapen обикновено изисква:

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

Mokapen не замества панела на Shopify за checkout, теми или плащания: подравнява данните към (и, за продуктите, от) CRM. Ако отмените приложението от Shopify или токенът изтече, прекъснете и свържете отново от Mokapen. Shopify изисква и GDPR крайни точки (data request / redact): Mokapen ги обработва чрез webhook.

Какво се синхронизира

Към Mokapen (импорт / webhook)

• Клиенти → Контакти — основните данни от Shopify влизат в адресната книга; ако има фирмени данни, може да се създаде/свърже и фирма. Webhooks при създаване/актуализация/изтриване на клиент.
• Продукти и варианти → Продукти — каталог с варианти; количеството на инвентара на варианта в Shopify се съпоставя с полето за количество на варианта в Mokapen (не отделен складов модул).
• Поръчки → Поръчки — поръчките от Shopify стават поръчки за продажба в Mokapen (с редове), не сделки в pipeline. Webhooks при актуализации на поръчки.
• Изоставени checkouts — синхронизацията може да включва път за импорт на изоставени checkouts от Shopify (като поръчки/свързани данни). Специализираните отчети за изоставени колички / аналитика за електронна търговия на страницата все още се показват като Coming soon: не ги бройте като активна функция засега.

Към Shopify (експорт)

• Продукти — с посока «към Shopify» или «и двете» Mokapen може да експортира/актуализира продукти в магазина (масова синхронизация и sync-out при запазване на свързан продукт, ако интеграцията е активна).
• Изходящи контакти и поръчки — въпреки scope-овете write_customers, автоматичният експорт «sync out», реализиран днес, на практика се прилага за продукти. Не приемайте за даденост пълен двупосочен експорт на контакти или поръчки: клиентите пристигат основно от Shopify към Mokapen (импорт + webhook). Ако маркетингов текст споменава «само двупосочни контакти», проверете в средата си какво реално прави синхронизацията след свързване.

В конфигурацията интеграцията изброява и услуги, но няма специализирана синхронизация на услуги за електронна търговия както при продуктите: използвайте Продукти за каталога на магазина.

Настройки след свързване

На страницата Shopify, при свързан магазин, обикновено конфигурирате:

Посока на синхронизация

• Само към Mokapen — данните текат от Shopify към CRM.
• И двете — импорт + експорт (където се поддържа; днес основно изходящи продукти).
• Само към Shopify — изпращане от Mokapen към магазина (продукти).

Обекти

Контакти, поръчки и продукти се появяват като обхвати на синхронизация (често вече избрани и нередактируеми от UI). Историческата синхронизация и webhooks покриват тези три блока.

Споделяне на синхронизацията

Който е свързал магазина, може да позволи на други членове да използват същата връзка (цялата организация или избрани потребители), така че не всеки да повтаря OAuth.

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

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

Автоматична срещу ръчна синхронизация

При активна автоматична синхронизация актуализациите (и webhooks) поддържат данните подравнени; все пак можете да стартирате ръчна синхронизация за първоначалното историческо зареждане. Преди синхронизация проверете упълномощаването за обработка/споделяне на данни, изисквано на страницата.

Препоръчителен поток

1. Свържете магазина и проверете Свързан акаунт.
2. Задайте посока на синхронизация (в повечето случаи: Само към Mokapen или И двете, ако искате да актуализирате продуктите в Shopify от Mokapen).
3. Конфигурирайте дубликати/конфликти и споделяне.
4. Упълномощете и стартирайте първата синхронизация (може да отнеме време при големи каталози).
5. Проверете в Mokapen: Контакти, Продукти (варианти/количество), Поръчки.
6. Дръжте webhooks активни: нови поръчки и актуализации на клиенти/продукти ще пристигат без да пускате всичко отново всеки път.

Прекъсване

От Интеграции → Shopify → прекъснете. В модала можете да изберете дали да запазите контактите, поръчките и продуктите, вече импортирани в Mokapen, или да ги обработите според предложените опции. След прекъсване webhooks спират да обновяват; данните, вече в CRM, остават, ако сте избрали да ги запазите. Можете и да отмените приложението от панела на Shopify.

Чести проблеми

• Невалидно име на магазин — използвайте поддомейна *.myshopify.com, не само персонализирания домейн на витрината.
• Бутонът е блокиран / надграждане — необходим е подходящ план Premium за електронна търговия.
• Поръчките не са във Възможности — това е правилно: отиват в Поръчки. Отворете Продажби → Поръчки.
• Количество на продукта — идва от количеството на варианта в Shopify; не е пълен WMS.
• Отчети за колички / аналитика — ако на страницата се показва «Coming soon», все още не са оперативни.
• Изтекъл токен / спряна синхронизация — прекъснете и свържете отново; проверете дали приложението не е деинсталирано от Shopify.

Често задавани въпроси

В: Къде намирам URL на магазина?

О: В адресната лента на таблото Shopify Admin: завършва на myshopify.com.

В: Стават ли поръчките от Shopify възможности?

О: Не. В Mokapen стават поръчки за продажба (с редове). Всеки текст, който говори за «възможности», е неточен спрямо текущото поведение.

В: Мога ли да актуализирам продуктите в Shopify от Mokapen?

О: Да, с посока на синхронизация, която включва експорт, и активна интеграция: продуктите (варианти) могат да се изпращат/актуализират в магазина.

В: Актуализират ли се и контактите от Mokapen към Shopify?

О: Импортът и webhooks пренасят клиентите от Shopify в CRM. Автоматичният експорт на контакти не е основният път днес (за разлика от продуктите): проверете в плана/средата си след свързване.

В: Нужен ли ми е WooCommerce заедно със Shopify?

О: Не: това са две алтернативни интеграции за електронна търговия. Използвайте Shopify, ако магазинът ви е в Shopify; вижте ръководството за WooCommerce, ако използвате WordPress/Woo.