Nastavení Shopify | Social Stream Ninja

Shopify v Social Stream Ninja

Propagujte veřejné produkty pomocí obrázků, cen, čitelných odkazů a QR kódů. Přijímejte podepsaná oznámení o zaplacených objednávkách jako purchase upozornění v přehledu aktivity, multi-alerts a Event Flow. Propagace produktů funguje nezávisle na upozorněních na platby.

Připojit nákupy · Importovat produkty · Překryvy OBS · Bezpečné testování · Omezení a řešení problémů

Dostupnost: automatická upozornění vyžadují nasazený a zapnutý přijímač Shopify v API SSN. Pokud není dostupný, Uložit nastavení oznámí chybu a Shopify nezapne. Import veřejných produktů i ruční propagace fungují samostatně. Tento návod popisuje kód integrace; před označením živé služby za ověřenou je stále nutný test se skutečným obchodem.

Připojení zaplacených nákupů

V Shopify otevřete Nastavení → Oznámení → Webhooky. Najděte podpisové tajemství uvedené u ručně vytvořených webhooků. Liší se od tokenu Storefront.
V SSN otevřete Monetizace → Nákupy Shopify → Nastavení. Zadejte svou trvalou your-store.myshopify.com doménu a podpisové tajemství webhooku. Zapněte nákupy Shopify a klikněte na Uložit nastavení.
Klikněte na Kopírovat URL přijímače. V Shopify vytvořte webhook s událostí Platba objednávky, formát JSON, a tuto URL přijímače. Vyberte podporovanou stabilní verzi API webhooků; tato integrace byla vyvinuta podle formátu objednávek verze 2026-07.
Uložte webhook Shopify. Nechte SSN zapnuté, aby mohlo zpracovávat nákupy. Před přijetím údajů objednávky přijímač ověří HMAC nezměněného těla požadavku a shodu obchodu.

Nastavení Shopify v SSApp s doménou obchodu, vymazaným podpisovým tajemstvím, URL přijímače a stavem — Skutečná aplikace SSApp s odděleným ukázkovým obchodem. Kliknutím snímek obrazovky zvětšíte.

Podpisové tajemství se na přijímači SSN šifruje a po uložení se ze vstupního pole vymaže. Samostatný soukromý klíč pro čtení zůstává na tomto zařízení. Ani jeden se nevkládá do odkazů OBS nebo QR kódů pro diváky. Shopify používá vlastní přijímač; starší přepínač vzdáleného ovládání API není potřeba.

Vygenerovaná URL znamená, že se konfigurace uložila, nikoli že Shopify něco doručilo. Stav rozlišuje čekání, ověřený test, přeskočenou událost a přijatý nákup. Před změnou obchodu použijte Odpojit. Vypnutí Shopify pozastaví místní zpracování; odpojení odstraní přijímač a události ve frontě. Při odpojení odstraňte také příslušný webhook v Shopify.

Shopify: ruční vytváření webhooků · Shopify: ověřování doručení

Import veřejného produktu

Zadejte svou myshopify.com doménu v nastavení Shopify. K importu produktů nemusíte zapínat upozornění na nákupy ani zadávat podpisové tajemství.
Rozbalte Importujte produkt, vložte veřejnou URL produktu a klikněte na Načíst podrobnosti produktu.
Pokud přístup bez tokenu produkt nezpřístupní, zadejte veřejný token Storefront. Můžete jej vytvořit v kanálu Headless v Shopify. Zveřejněte produkt v této výloze i v Online Store. Nevkládejte token Admin API ani soukromý token Storefront.
SSN otevře stávající Produkty a odkazy na podporu (Products & support links) editor s názvem, obrázkem, cenou a kanonickým veřejným odkazem vráceným ze Shopify. Zkontrolujte je, klikněte na Přidat produkt nebo odkaz, zapněte katalog a Uložit nastavení.

Importovaný název produktu Shopify, URL obrázku, cena a kanonický veřejný odkaz ve společném editoru produktů — Ukázkové údaje produktu načtené do společného editoru ke kontrole před uložením.

Import načítá jeden produkt najednou pomocí Storefront API. Token je volitelný, použije se pouze pro daný požadavek a poté se vymaže. Veřejným odkazem se stane kanonická URL Online Store ze Shopify, včetně vlastní domény, pokud ji Shopify vrátí. Nedostupné produkty a produkty bez veřejného odkazu na Online Store se vynechávají.

Cena se vyplní jen tehdy, když se nejnižší a nejvyšší cena variant produktu shodují. Jinak zůstane prázdná; konkrétní cenu zadejte sami pouze tehdy, pokud přesně odpovídá nabídce. Importované údaje jsou jednorázový snímek, nikoli průběžná synchronizace zásob nebo cen. Při změnách obchodu je zkontrolujte. Vždy můžete produkt zadat ručně.

Ověřování Shopify Storefront · Dotaz na produkt · Vytvoření veřejného tokenu pomocí Headless

Použití stávajících překryvů

V části Odkaz na překryv pro, zvolte Produkty a odkazy na podporu (Products & support links). Použijte Pouze přehlídka produktů pro obrázky, ceny a QR kódy, Pouze karta podpory pro malý trvalý či pravidelně zobrazovaný odkaz na obchod, nebo Pouze upozornění na aktivitu pro nákupy. Každý požadovaný odkaz OBS zkopírujte do samostatného zdroje Prohlížeč; začněte rozměry 800 × 600.

Nastavte volitelný filtr zdroje upozornění na shopify pro zobrazení pouze aktivity Shopify v obecném monetizačním překryvu. Pro toto obecné zobrazení zapněte Produkty a odkazy na podporu. Stávající multi-alerts i přehled aktivity přijímají nákupy Shopify nezávisle na katalogu produktů.

Upozornění na nákup Shopify s anonymním kupujícím a veřejným názvem produktu — Zaplacený nákup přijatý místním přijímačem s ověřováním podpisu a zobrazený v SSApp. Totožnost zákazníka zůstává soukromá.

Produktové karty odkazují na veřejné stránky produktů. Použijte Kopírovat veřejný odkaz pro sdílení klikatelné adresy v chatu a otestujte QR kód telefonem při výsledné velikosti vysílání. Upozornění na nákup nikdy nepřebírá QR kód ani obrázek z nesouvisejícího střídajícího se produktu. Webhooky objednávek neposkytují spolehlivé URL obrázků produktů, proto upozornění na nákupy používají text; importované propagační karty mohou zobrazovat obrázky.

V Event Flow zvolte typ události purchase a filtrujte zdroj/typ na shopify. Porovnejte meta.commerce.orderTotal pro pravidla podle hodnoty objednávky a zkontrolujte meta.commerce.currency před porovnáním částek. Jde o nákupy: žádná událost hasDonation nebo donoValue se neodesílá a cíle příspěvků se nezvyšují. Propagační karta označená Dárek nemění zařazení událostí objednávek. Doručení jiné osobě není důkazem dárku pro tvůrce.

Bezpečný náhled a testování

Ukázkový náhled otevře oddělený ukázkový překryv bez připojení k relaci. Nikdy nespouští Event Flow, nemění součty ani neověřuje platbu.

Objednávky Shopify výslovně označené test: true se potvrzují a ve stavu přijímače zobrazují jako testy, bez upozornění na nákup nebo spuštění akcí. Přeskakují se také chybějící příznaky testu, nezaplacené či částečně zaplacené objednávky, zrušené objednávky, nulové částky a stará nebo neplatná časová razítka. Pro testování celého průběhu použijte vývojový obchod. Ukázku z administrace bez důvěryhodného příznaku testu neposílejte do aktivního toku odměn; vzhled bezpečně ověříte náhledem SSN.

Co jsme ověřili bez obchodu

Oddělené testy ověřují skutečné doručení přes HTTP s podepsaným JSON s Unicode, pozměněné podpisy, opakovaná doručení, oddělení testovacích objednávek, přesnost měn, příliš velké požadavky, odstranění soukromých údajů zákazníků a obnovení po odpojení ve skutečné aplikaci SSApp. Tyto kontroly nevytvářejí objednávky ani nevyžadují účet obchodníka.

Produkční přijímač Shopify zůstává vypnutý do provedení testu doručení ze skutečného obchodu. Ruční propagaci produktů lze používat samostatně. Ukázkové webhooky Shopify CLI mohou pomoci otestovat zpracování dat, ale neověřují odběry ani opakované pokusy a stále vyžadují přihlašovací údaje aplikace. Viz Omezení testování webhooků pomocí Shopify CLI.

Omezení doručování a řešení problémů

Přijímač není dostupný: provozovatel API SSN musí nasadit a zapnout přijímač Shopify. Viz nastavení serveru. Nepoužívejte místo ní starší nepodepsanou URL webhooku relace.
Čekání na událost: ověřte událost Platba objednávky, JSON, přesnou URL přijímače, odpovídající trvalou doménu obchodu a podpisové tajemství daného webhooku. Webhook vlastní aplikace používá podpisové tajemství této aplikace, nikoli tajemství ručních webhooků v Oznámeních.
Podepsaná událost přeskočena: tato integrace vyžaduje plně zaplacenou objednávku s kladnou částkou, test: false a podepsané tělo updated_at z posledních sedmi dní (s tolerancí pěti minut do budoucna). Platbu neodvozuje od vytvoření objednávky, jejího vyřízení ani zásob.
SSN bylo offline: přijaté události čekají ve frontě až sedm dní. Pro obnovení zpracování spusťte SSN znovu. Stav i čekající úlohy se zachovají při restartu přijímače. Služba má omezené úložiště a pokud nemůže úlohu trvale uložit do fronty, požádá Shopify o další pokus.
Duplicity: přijímač odstraňuje duplicity podle obchodu a objednávky, i když se ID doručení Shopify liší. Záznamy pro rozpoznání duplicit se uchovávají sedm dní. SSN ukládá zpracovaná ID před potvrzením. Pád mezi provedením externí akce a tímto uložením může přesto akci zopakovat; u automatizace s významnými dopady použijte vlastní ochranu proti opakování.
Chybějící jméno kupujícího: záměrně. SSN vynechává jména zákazníků, e-maily, adresy, poznámky objednávek, vlastní vlastnosti položek, URL pokladen i původní ID objednávek. Veřejné názvy produktů zůstávají prostým textem.
Vrácení peněz nebo změny objednávek: jde o živý přehled upozornění, nikoli účetní systém nebo systém vyřizování objednávek. Vrácení peněz, zrušení a změny částek neruší předchozí upozornění. Není zahrnuto porovnávání historie objednávek ani automatické odebírání produktů.

Podívejte se na Formát událostí Shopify a společný návod k produktům a QR kódům.