Mostra i tuoi prodotti e acquisti Shopify.

Shopify in Social Stream Ninja

Promuovi prodotti pubblici con immagini, prezzi, link leggibili e codici QR. Ricevi notifiche firmate di ordini pagati come acquisto avvisi nel feed attività, in multi-alerts e in Event Flow. La promozione dei prodotti funziona indipendentemente dagli avvisi di pagamento.

Collega gli acquisti · Importa prodotti · Overlay OBS · Prova in sicurezza · Limiti e risoluzione dei problemi

Disponibilità: gli avvisi automatici richiedono che il ricevitore Shopify sia distribuito e abilitato sull'API SSN. Se non è disponibile, Salva configurazione segnala un errore e non abilita Shopify. L'importazione dei prodotti pubblici e la promozione manuale funzionano indipendentemente. Questa guida descrive il codice dell'integrazione; serve ancora un test con un commerciante reale prima di dichiarare il servizio live convalidato.

Collega gli acquisti pagati

1. In Shopify, apri Settings → Notifications → Webhooks. Individua il segreto di firma mostrato per i webhook creati manualmente. È diverso da un token Storefront.
2. In SSN, apri Monetizzazione → Acquisti Shopify → Configurazione. Inserisci il tuo dominio permanente your-store.myshopify.com e segreto di firma webhook. Abilita gli acquisti Shopify, poi fai clic su Salva configurazione.
3. Fai clic su Copia URL del ricevitore. In Shopify, crea un webhook con evento Pagamento ordine, formato JSON, e quell'URL del ricevitore. Seleziona una versione API webhook stabile supportata; questa integrazione è stata sviluppata sul contratto ordini 2026-07.
4. Salva il webhook Shopify. Mantieni SSN attivo per elaborare gli acquisti. Il ricevitore verifica l'HMAC del corpo grezzo e il negozio corrispondente prima di accettare i dati dell'ordine.

Il segreto di firma viene crittografato sul ricevitore SSN e cancellato dal campo dopo il salvataggio. Una chiave privata separata di lettura resta su questo dispositivo. Nessuno dei due viene incluso nei link OBS o nei codici QR per gli spettatori. Shopify usa il proprio ricevitore dedicato; la precedente opzione di controllo API remoto non serve.

Un URL generato indica che la configurazione è stata salvata, non che Shopify abbia consegnato qualcosa. Lo stato distingue attesa, test verificato, evento ignorato e acquisto ricevuto. Cambiare negozio richiede prima Disconnetti. Disattivare Shopify mette in pausa l'elaborazione locale; Disconnetti elimina il ricevitore e gli eventi in coda. Rimuovi il webhook Shopify corrispondente quando disconnetti.

Shopify: creare webhook manualmente · Shopify: verificare le consegne

Importa un prodotto pubblico

1. Inserisci il tuo myshopify.com nella configurazione Shopify. Non serve abilitare gli avvisi d'acquisto o inserire un segreto di firma per importare i prodotti.
2. Espandi Importa un prodotto, incolla un URL pubblico del prodotto e fai clic su Carica dettagli prodotto.
3. Se l'accesso senza token non espone il prodotto, fornisci un token Storefront pubblico. Il canale Headless di Shopify può crearne uno. Pubblica il prodotto in quella vetrina e nell'Online Store. Non incollare un token Admin API o un token Storefront privato.
4. SSN apre l'editor esistente Prodotti e link di supporto (Products & support links) con titolo, immagine, prezzo e link pubblico canonico restituiti da Shopify. Controllali, fai clic su Aggiungi prodotto o link, abilita il catalogo e Salva configurazione.

L'importazione legge un prodotto alla volta tramite Storefront API. Il token è facoltativo, viene usato solo per quella richiesta e poi cancellato. L'URL canonico Online Store di Shopify diventa il link pubblico, incluso un dominio personalizzato quando Shopify lo restituisce. I prodotti non disponibili e quelli privi di un link pubblico Online Store sono esclusi.

Il prezzo viene compilato solo quando il prezzo minimo e quello massimo delle varianti del prodotto coincidono. Altrimenti resta vuoto; scegli tu un prezzo specifico solo se descrive correttamente l'offerta. Le informazioni importate sono un'istantanea, non una sincronizzazione continua di scorte o prezzi. Controllale quando il negozio cambia. Puoi sempre usare invece l'inserimento manuale dei prodotti.

Autenticazione Shopify Storefront · Query prodotto · Creazione di un token pubblico con Headless

Usa gli overlay esistenti

Sotto Link overlay per, scegli Prodotti e link di supporto (Products & support links). Usa Solo vetrina prodotti per immagini, prezzi e codici QR, Solo scheda supporto per un piccolo link al negozio permanente o periodico, oppure Solo avvisi di attività per gli acquisti. Copia ogni link OBS desiderato in una sorgente browser separata, iniziando da 800 × 600.

Imposta il filtro facoltativo della sorgente avvisi su shopify per mostrare solo l'attività Shopify nell'overlay monetizzazione generico. Abilita Prodotti e link di supporto per quella vista generica. Multi-alerts e il feed attività esistenti ricevono gli acquisti Shopify indipendentemente dal catalogo prodotti.

Le schede prodotto rimandano alle pagine pubbliche dei prodotti. Usa Copia link pubblico per condividere l'indirizzo cliccabile in chat, e prova il codice QR da un telefono alle dimensioni finali della diretta. Un avviso d'acquisto non prende mai in prestito un QR o un'immagine da un prodotto in rotazione non correlato. I webhook degli ordini non forniscono URL affidabili delle immagini dei prodotti, quindi gli avvisi d'acquisto usano testo; le schede promozionali importate possono mostrare immagini.

Per Event Flow, scegli Event Type purchase e filtra sorgente/tipo su shopify. Confronta meta.commerce.orderTotal per le regole sul valore dell'ordine e controlla meta.commerce.currency prima di confrontare gli importi. Sono acquisti: nessun evento hasDonation oppure donoValue viene emesso e gli obiettivi delle donazioni non aumentano. Una scheda promozionale etichettata Regalo non cambia la classificazione degli eventi ordine. Spedire a un'altra persona non dimostra un regalo al creator.

Anteprima e test sicuri

Anteprima di esempio apre un overlay di esempio isolato senza connessione alla sessione. Non attiva mai Event Flow, non modifica totali e non verifica pagamenti.

Gli ordini Shopify contrassegnati esplicitamente test: true vengono confermati e mostrati come test nello stato del ricevitore, senza avvisi d'acquisto o azioni. Vengono ignorati anche indicatori di test mancanti, ordini non pagati/parzialmente pagati, ordini annullati, totali zero e timestamp vecchi o non validi. Usa un negozio di sviluppo per i test completi. Un esempio amministrativo senza un indicatore di test attendibile non deve essere inviato a un flusso di ricompense attivo; l'anteprima SSN è il controllo sicuro dell'aspetto.

Cosa abbiamo verificato senza un negozio

I test isolati coprono la consegna HTTP reale con JSON Unicode firmato, firme alterate, consegne duplicate, isolamento degli ordini di test, precisione delle valute, richieste troppo grandi, rimozione dei dati privati dei clienti e recupero offline tramite il runtime SSApp effettivo. Questi controlli non effettuano ordini e non richiedono un account commerciante.

Il ricevitore Shopify di produzione resta disabilitato in attesa di un test di consegna da un negozio reale. La promozione manuale dei prodotti è utilizzabile indipendentemente. I webhook di esempio di Shopify CLI possono aiutare a testare la gestione dei payload, ma non convalidano sottoscrizioni o nuovi tentativi e richiedono comunque credenziali dell'app. Vedi Limiti dei test webhook con Shopify CLI.

Limiti di consegna e risoluzione dei problemi

• Ricevitore non disponibile: l'operatore dell'API SSN deve distribuire e abilitare il ricevitore Shopify. Vedi la configurazione del server. Non usare come sostituto il vecchio URL webhook di sessione non firmato.
• In attesa di un evento: verifica Order payment, JSON, l'URL esatto del ricevitore, il dominio permanente del negozio corrispondente e il segreto di firma di quel webhook. Il webhook di un'app personalizzata usa il segreto di firma dell'app, non quello manuale di Notifications.
• Evento firmato ignorato: questa integrazione richiede un ordine positivo interamente pagato, test: false e un corpo firmato updated_at negli ultimi sette giorni (con cinque minuti di tolleranza per orologi avanti). Non deduce il pagamento dalla creazione dell'ordine, dall'evasione o dall'inventario.
• SSN era offline: gli eventi accettati restano in coda fino a sette giorni. Riavvia SSN per riprendere. Stato e lavoro in sospeso sopravvivono al riavvio del ricevitore. Il servizio ha spazio limitato e chiede a Shopify di riprovare quando non può accodare il lavoro in modo persistente.
• Duplicati: il ricevitore deduplica per negozio/ordine, anche quando gli ID di consegna Shopify differiscono. I record di deduplicazione durano sette giorni. SSN salva gli ID gestiti prima della conferma. Un arresto anomalo tra un'azione esterna e quel salvataggio può comunque ripetere l'azione; usa una tua protezione di idempotenza per automazioni con conseguenze rilevanti.
• Nome acquirente mancante: è intenzionale. SSN esclude nomi, email e indirizzi dei clienti, note degli ordini, proprietà personalizzate delle righe d'ordine, URL di checkout e ID grezzi degli ordini. I titoli pubblici dei prodotti restano testo semplice.
• Rimborsi o modifiche agli ordini: è un feed di avvisi dal vivo, non un sistema contabile o di evasione ordini. Rimborsi, annullamenti e totali modificati non annullano gli avvisi precedenti. Non sono incluse riconciliazione della cronologia ordini o rimozione automatica dei prodotti.

Consulta Contratto degli eventi Shopify e guida condivisa a prodotti e QR.