Zeige deine Shopify-Produkte und -Käufe.

Shopify in Social Stream Ninja

Bewirb öffentliche Produkte mit Bildern, Preisen, lesbaren Links und QR-Codes. Empfange signierte Meldungen zu bezahlten Bestellungen als purchase Meldungen im Aktivitätsfeed, multi-alerts und Event Flow. Produktwerbung funktioniert unabhängig von Zahlungsmeldungen.

Käufe verbinden · Produkte importieren · OBS-Overlays · Sicher testen · Grenzen und Fehlerbehebung

Verfügbarkeit: automatische Meldungen benötigen einen bereitgestellten und aktivierten Shopify-Empfänger auf der SSN-API. Ist er nicht verfügbar, meldet Save setup einen Fehler und aktiviert Shopify nicht. Öffentlicher Produktimport und manuelle Werbung funktionieren unabhängig. Dieser Leitfaden beschreibt den Integrationscode; ein echter Händlertest ist weiterhin nötig, bevor eine Prüfung des Livedienstes behauptet werden kann.

Bezahlte Käufe verbinden

1. Öffne in Shopify Settings → Notifications → Webhooks. Suche den für manuell erstellte Webhooks angezeigten Signaturschlüssel. Dieser unterscheidet sich von einem Storefront-Token.
2. Öffne in SSN Monetarisierung → Shopify-Käufe → Einrichtung. Gib deine dauerhafte your-store.myshopify.com Domain und Webhook-Signaturschlüssel ein. Aktiviere Shopify purchases und klicke dann auf Einrichtung speichern.
3. Klicke auf Empfänger-URL kopieren. Erstelle in Shopify einen Webhook mit dem Ereignis Bestellzahlung (Order payment), Format JSON, und dieser Empfänger-URL. Wähle eine unterstützte stabile Webhook-API-Version; diese Integration wurde anhand des Bestellvertrags 2026-07 entwickelt.
4. Speichere den Shopify-Webhook. Lass SSN eingeschaltet, um Käufe zu verarbeiten. Der Empfänger prüft den HMAC des unveränderten Anfrageinhalts und den passenden Shop, bevor er Bestelldaten annimmt.

Der Signaturschlüssel wird auf dem SSN-Empfänger verschlüsselt und nach dem Speichern aus dem Eingabefeld gelöscht. Ein separater privater Leseschlüssel bleibt auf diesem Gerät. Keiner davon wird in OBS-Links oder Zuschauer-QR-Codes aufgenommen. Shopify verwendet seinen eigenen Empfänger; der ältere Schalter für Remote-API-Steuerung ist nicht nötig.

Eine erzeugte URL bedeutet, dass die Konfiguration gespeichert wurde, nicht dass Shopify etwas zugestellt hat. Der Status unterscheidet Warten, verifizierten Test, übersprungenes Ereignis und empfangenen Kauf. Ein Shopwechsel erfordert zuerst Disconnect. Shopify auszuschalten pausiert die lokale Verarbeitung; Disconnect löscht Empfänger und wartende Ereignisse. Entferne beim Trennen auch den entsprechenden Shopify-Webhook.

Shopify: Webhooks manuell erstellen · Shopify: Zustellungen prüfen

Ein öffentliches Produkt importieren

1. Gib deine myshopify.com Domain in der Shopify-Einrichtung ein. Für Produktimport musst du weder Kaufmeldungen aktivieren noch einen Signaturschlüssel eingeben.
2. Öffne den Abschnitt Ein Produkt importieren, füge eine öffentliche Produkt-URL ein und klicke auf Produktdetails laden.
3. Wenn Zugriff ohne Token das Produkt nicht bereitstellt, gib ein öffentliches Storefront-Token. Shopifys Headless-Kanal kann eines erstellen. Veröffentliche das Produkt in diesem Storefront und im Online Store. Füge kein Admin-API-Token oder privates Storefront-Token ein.
4. SSN öffnet den vorhandenen Produkte & Unterstützungslinks Editor mit dem von Shopify gelieferten Titel, Bild, Preis und kanonischen öffentlichen Link. Prüfe die Angaben und klicke auf Produkt oder Link hinzufügen, aktiviere den Katalog und Einrichtung speichern.

Der Import liest jeweils ein Produkt über die Storefront API. Das Token ist optional, wird nur für diese Anfrage verwendet und danach gelöscht. Shopifys kanonische Online-Store-URL wird zum öffentlichen Link, einschließlich einer eigenen Domain, wenn Shopify eine zurückgibt. Nicht verfügbare Produkte und Produkte ohne öffentlichen Online-Store-Link werden ausgeschlossen.

Ein Preis wird nur ausgefüllt, wenn minimaler und maximaler Variantenpreis des Produkts übereinstimmen. Andernfalls bleibt er leer; wähle selbst nur einen konkreten Preis, wenn er das Angebot korrekt beschreibt. Importierte Angaben sind eine Momentaufnahme, keine laufende Bestands- oder Preissynchronisierung. Prüfe sie bei Shopänderungen. Alternativ kannst du Produkte jederzeit manuell eingeben.

Shopify-Storefront-Authentifizierung · Produktabfrage · Öffentliches Token mit Headless erstellen

Bestehende Overlays verwenden

Unter Overlay-Link für, wähle Produkte & Unterstützungslinks. Verwende Nur Produktpräsentation für Bilder, Preise und QR-Codes, Nur Unterstützungskarte für einen kleinen dauerhaften oder zeitweise eingeblendeten Shoplink oder Nur Aktivitätsmeldungen für Käufe. Kopiere jeden gewünschten OBS-Link in eine eigene Browserquelle, zunächst mit 800 × 600.

Setze den optionalen Quellfilter für Meldungen auf shopify um im allgemeinen Monetarisierungs-Overlay nur Shopify-Aktivität anzuzeigen. Aktiviere für diese allgemeine Ansicht Products & support links. Bestehende multi-alerts und der Aktivitätsfeed empfangen Shopify-Käufe unabhängig vom Produktkatalog.

Produktkarten verlinken öffentliche Produktseiten. Verwende Öffentlichen Link kopieren um die anklickbare Adresse im Chat zu teilen, und teste den QR-Code mit einem Handy bei der endgültigen Streamgröße. Eine Kaufmeldung übernimmt nie QR-Code oder Bild eines unzugehörigen rotierenden Produkts. Bestell-Webhooks liefern keine zuverlässigen Produktbild-URLs, daher verwenden Kaufmeldungen Text; importierte Werbekarten können Bilder zeigen.

Wähle für Event Flow Event Type purchase und filtere Quelle/Typ auf shopify. Vergleiche meta.commerce.orderTotal für Regeln zum Bestellwert und prüfe meta.commerce.currency vor dem Betragsvergleich. Dies sind Käufe: Es wird kein hasDonation oder donoValue ausgegeben und Spendenziele steigen nicht. Eine Werbekarte mit der Beschriftung Gift ändert nicht die Klassifizierung von Bestellereignissen. Der Versand an eine andere Person belegt kein Geschenk an den Creator.

Sicher ansehen und testen

Beispielvorschau öffnet ein isoliertes Beispieloverlay ohne Sitzungsverbindung. Es löst nie Event Flow aus, ändert keine Summen und prüft keine Zahlung.

Shopify-Bestellungen mit ausdrücklicher Kennzeichnung test: true werden bestätigt und im Empfängerstatus als Tests angezeigt, ohne Kaufmeldungen oder Aktionen. Fehlende Testkennzeichen, unbezahlte/teilbezahlte Bestellungen, stornierte Bestellungen, Nullsummen sowie veraltete oder ungültige Zeitstempel werden ebenfalls übersprungen. Verwende für Tests des gesamten Ablaufs einen Entwicklungsshop. Ein Admin-Beispiel ohne vertrauenswürdiges Testkennzeichen sollte nicht an einen aktiven Belohnungsablauf gesendet werden; die SSN-Vorschau ist die sichere Darstellungsprüfung.

Was wir ohne Shop geprüft haben

Isolierte Tests prüfen echte HTTP-Zustellung mit signiertem Unicode-JSON, manipulierte Signaturen, doppelte Zustellungen, Trennung von Testbestellungen, Währungsgenauigkeit, übergroße Anfragen, Entfernung privater Kundendaten und Offline-Wiederherstellung über die tatsächliche SSApp-Laufzeit. Diese Prüfungen geben keine Bestellungen auf und benötigen kein Händlerkonto.

Der produktive Shopify-Empfänger bleibt deaktiviert, bis eine echte Shopzustellung getestet wurde. Manuelle Produktwerbung ist unabhängig nutzbar. Shopify-CLI-Beispielwebhooks können die Nutzdatenverarbeitung testen, prüfen aber weder Abonnements noch Wiederholungen und benötigen weiterhin App-Zugangsdaten. Siehe Grenzen von Webhook-Tests mit Shopify CLI.

Zustellgrenzen und Fehlerbehebung

• Empfänger nicht verfügbar: der Betreiber der SSN-API muss den Shopify-Empfänger bereitstellen und aktivieren. Siehe die Servereinrichtung. Verwende die alte unsignierte Sitzungs-Webhook-URL nicht als Ersatz.
• Warten auf ein Ereignis: prüfe Order payment, JSON, die genaue Empfänger-URL, passende dauerhafte Shopdomain und den Signaturschlüssel dieses Webhooks. Ein Webhook einer eigenen App verwendet deren Signaturschlüssel, nicht den manuellen Notifications-Schlüssel.
• Signiertes Ereignis übersprungen: diese Integration erfordert eine positive vollständig bezahlte Bestellung, test: false und einen signierten Inhalt updated_at innerhalb der letzten sieben Tage (mit fünf Minuten Toleranz für zukünftige Uhrzeiten). Sie leitet keine Zahlung aus Bestellerstellung, Erfüllung oder Bestand ab.
• SSN war offline: angenommene Ereignisse bleiben bis zu sieben Tage in der Warteschlange. Starte SSN erneut, um fortzufahren. Status und ausstehende Aufgaben überstehen einen Empfängerneustart. Der Dienst hat begrenzten Speicher und fordert Shopify zur Wiederholung auf, wenn er Aufgaben nicht dauerhaft einreihen kann.
• Doppelte Einträge: der Empfänger dedupliziert nach Shop/Bestellung, selbst bei unterschiedlichen Shopify-Zustellungs-IDs. Duplikatdatensätze bleiben sieben Tage erhalten. SSN speichert verarbeitete IDs dauerhaft vor der Bestätigung. Ein Absturz zwischen einer externen Aktion und dieser Speicherung kann die Aktion dennoch wiederholen; verwende für folgenreiche Automatisierung eine eigene Idempotenzprüfung.
• Käufername fehlt: beabsichtigt. SSN schließt Kundennamen, E-Mail-Adressen, Anschriften, Bestellnotizen, eigene Positionseigenschaften, Checkout-URLs und rohe Bestell-IDs aus. Öffentliche Produkttitel bleiben Klartext.
• Erstattungen oder Bestelländerungen: dies ist ein Live-Meldungsfeed, kein Buchhaltungs- oder Bestellabwicklungssystem. Erstattungen, Stornierungen und geänderte Summen machen frühere Meldungen nicht rückgängig. Es gibt weder einen Abgleich des Bestellverlaufs noch automatische Produktentfernung.

Siehe Shopify-Ereignisvertrag und gemeinsamen Produkt- und QR-Leitfaden.