Social Stream Ninja
Українська
EnglishEspañolPortuguês (Brasil)РусскийFrançaisDeutsch日本語简体中文繁體中文ItalianoPolski한국어УкраїнськаالعربيةTürkçeČeštinaไทย

Показуйте свої товари й покупки Shopify.

Показуйте товари з QR-кодом. Отримуйте сповіщення про покупки.

Покажіть товар Shopify за 5 кроків

  1. У Social Stream Ninja відкрийте Monetization → Shopify purchases → Setup.
  2. Уведіть адресу магазину, наприклад your-store.myshopify.com. Секрет не потрібен.
  3. Відкрити Імпортувати товар, вставте загальнодоступне посилання товару й натисніть Завантажити дані товару.
  4. Перевірте назву, зображення, ціну й посилання. Потім натисніть Додати товар або посилання.
  5. Увімкніть Товари та посилання підтримки і натисніть Зберегти налаштування.
Імпортовані назва товару Shopify, URL зображення, ціна й канонічне публічне посилання у спільному редакторі товарів
Відомості про товар завантажуються в редактор для попередньої перевірки.
Товар не завантажується? Додайте Публічний токен Storefront (створіть його через канал Headless Shopify й опублікуйте товар там і в Online Store). Ніколи не вставляйте токен Admin API або приватний токен.
Що заповнює імпорт
  • За раз завантажується один товар.
  • Токен використовується лише для цього запиту, а потім видаляється.
  • Це загальнодоступне посилання магазину Shopify, зокрема власний домен, якщо Shopify його надає.
  • Ціна заповнюється лише за однакової вартості всіх варіантів. Інакше поле залишається порожнім. Указуйте ціну лише тоді, коли вона точна.
  • Це знімок даних. Ціни й наявність не оновлюються автоматично, тож перевіряйте їх у разі змін у магазині.
  • Не можна імпортувати недоступні товари й товари без загальнодоступного посилання Online Store.
  • Натомість товар завжди можна ввести вручну.

Автентифікація Shopify Storefront · Запит товару · Створення публічного токена через Headless

Отримуйте сповіщення про покупку

Ще не ввімкнено. Для сповіщень про покупки потрібен приймач Shopify на сервері SSN. Він залишається вимкненим до успішної перевірки зі справжнім магазином. До того часу Зберегти налаштування показує помилку. Показ товарів продовжує працювати.
  1. У Shopify перейдіть до Settings → Notifications → Webhooks. Знайдіть для вебхука секрет підпису. (Це не токен Storefront.)
  2. У Social Stream Ninja відкрийте Monetization → Shopify purchases → Setup.
  3. Введіть свій myshopify.com адресу й секрет підпису.
  4. Увімкніть Покупки Shopify і натисніть Зберегти налаштування.
  5. Натисніть Скопіювати URL приймача.
  6. Створіть вебхук у Shopify. Подія: Оплата замовлення (Order payment). Формат: JSON. URL: адреса приймача.
  7. Виберіть стабільну версію API та збережіть. (SSN розроблено для версії 2026-07.)
  8. Не закривайте Social Stream Ninja.
Налаштування Shopify у SSApp з доменом магазину, очищеним секретом підпису, URL приймача та станом
Налаштування Shopify в застосунку на прикладі магазину. Натисніть для збільшення.
Чи працює підключення? Стежте за рядком стану: очікування, тест отримано, подію пропущено або покупку отримано. URL приймача означає лише, що налаштування збережено.
Я хочу…Що зробити
Призупинити сповіщенняВимкніть Покупки Shopify.
Вимкнути остаточно або змінити магазинНатисніть Відключити Shopify (видаляє приймач і події в очікуванні). Видаліть також вебхук у Shopify.
Де зберігається ваш секрет
  • Секрет підпису зберігається зашифрованим на приймачі SSN. Після збереження поле очищується.
  • Окремий приватний ключ читання залишається на цьому комп'ютері.
  • Жоден із них не потрапляє в посилання OBS або QR-коди для глядачів.
  • Перед прийняттям замовлення приймач перевіряє підпис Shopify й назву магазину.
  • У Shopify є власний приймач, тож старий перемикач дистанційного керування API не потрібен.

Shopify: ручне створення вебхуків · Shopify: перевірка доставок

Додайте в OBS

  1. У розділі Накладка OBS для, виберіть Товари та посилання підтримки.
  2. Відкрити Параметри посилання оверлею і виберіть Вигляд накладки: Лише вітрина товарів (зображення, ціни, QR-коди), Лише картка підтримки (невелике посилання на магазин) або Лише сповіщення про активність (покупки).
  3. Натисніть Копіювати посилання OBS. Додайте його в OBS як Джерело браузера (Browser Source), почавши з 800 × 600. Використовуйте окреме джерело для кожного вигляду.
  4. Відскануйте QR-код телефоном за остаточного розміру зображення в ефірі.
Сповіщення про покупку Shopify з Anonymous buyer і публічною назвою товару
Сповіщення про покупку. Ім'я покупця залишається прихованим.
Я хочу…Що зробити
Поділіться посиланням товару в чатіНатисніть Копіювати публічне посилання поруч із товаром.
Показувати лише сповіщення Shopify у накладці монетизаціїУстановіть Фільтр джерела сповіщень до shopify. Товари й посилання для підтримки мають бути ввімкнені.
Показувати покупки в multi-alerts або стрічці активностіНічого додатково. Вони отримують покупки Shopify навіть без списку товарів.
Чому в сповіщеннях про покупку немає зображення? У замовленнях Shopify немає надійного зображення, тож сповіщення містять лише текст. Вони ніколи не беруть зображення або QR-код із картки товару.
Event Flow та цілі пожертв
  • В Event Flow виберіть тип події purchase та відфільтруйте джерело/тип до shopify.
  • Для правил за сумою замовлення порівнюйте meta.commerce.orderTotal. Перевірте meta.commerce.currency спочатку.
  • Покупки не є пожертвами. У них немає hasDonation або donoValue, і цілі пожертв не зростають.
  • Позначка «Подарунок» на картці не змінює підрахунок замовлень. Доставка іншій людині не робить замовлення подарунком вам.

Перевіряйте безпечно

Натисніть Переглянути приклад для перегляду оформлення. Попередній перегляд не підключений до вашого сеансу, тож не запускає Event Flow, не змінює суми й не перевіряє оплату. Для повної перевірки використовуйте магазин розробки Shopify. Замовлення з позначкою test: true відображаються лише в стані, без сповіщень.

Будьте обережні з прикладами з панелі адміністратора Shopify. Якщо приклад явно не позначений як тест, не надсилайте його до системи, що видає винагороди.
Що перевірено без справжнього магазину

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

Приклади вебхуків Shopify CLI дають змогу перевірити обробку повідомлень, але не підписки на події чи повторні спроби, і потребують облікових даних застосунку. Див. Обмеження перевірки вебхуків Shopify CLI.

Усунення несправностей

ПроблемаЩо спробувати
Під час збереження налаштувань з'являється помилкаПриймач ще не ввімкнено на сервері. Не замінюйте його старим URL вебхука сеансу.
Стан залишається «очікування»Перевірте вебхук: Оплата замовлення (Order payment), JSON, точний URL приймача, myshopify.com адресу й секрет. Вебхуки власних застосунків використовують секрет самого застосунку.
Подію пропущеноЛише повністю оплачені замовлення із сумою більше нуля, позначені test: falseі оновлені за останні 7 днів враховуються. Неоплачені, частково оплачені та скасовані замовлення пропускаються.
SSN було вимкнено під час продажуЗамовлення очікують до 7 днів. Запустіть SSN, і вони надійдуть.
Дія виконалася двічіПовтори блокуються на 7 днів, але збій під час дії може призвести до повтору. Для важливих автоматизацій додайте власну перевірку.
Немає імені покупцяТак задумано. Імена, email, адреси, нотатки, додаткові поля, посилання оформлення замовлення та ID замовлень ніколи не показуються.
Повернення коштів не видалило сповіщенняПовернення, скасування та зміни не скасовують сповіщення. Це не бухгалтерський облік.
Як обробляються замовлення в очікуванні й повторні замовлення
  • Час замовлення може випереджати поточний до п'яти хвилин через розбіжність годинників.
  • Оплата ніколи не визначається за створенням замовлення, відправленням або зміною запасів. За відсутності тестового прапорця подія пропускається.
  • Стан і замовлення в очікуванні зберігаються після перезапуску приймача.
  • Обсяг сховища обмежений. Якщо приймач не може безпечно зберегти замовлення, він просить Shopify надіслати його пізніше.
  • Повтори визначаються за магазином і замовленням, навіть якщо ID доставлення Shopify відрізняються.
  • SSN зберігає відомості про оброблені замовлення перед підтвердженням.

Дивіться Відомості про події Shopify і посібник із товарів і QR-кодів.