Zernio integra la gestione del blog Shopify｜Crea e programma articoli tramite API

Ciao, sono Hoda.

Zernio, noto soprattutto per la gestione delle pubblicazioni su più social network, ora supporta anche l’integrazione con i negozi Shopify.

Questa nuova integrazione, però, non è pensata per pubblicare contenuti sui social media. Permette invece di creare, aggiornare, eliminare e programmare gli articoli del sistema di blogging integrato in Shopify, come notizie, aggiornamenti e altri contenuti del negozio online, tramite le API di Zernio.

Come funziona l’integrazione con Shopify: una piattaforma connect-only

La prima cosa da sapere è che Shopify funziona in modo diverso rispetto alle altre integrazioni social di Zernio.

Shopify è classificato come una piattaforma connect-only, ovvero disponibile esclusivamente per la connessione. Ciò significa che non è incluso nelle funzionalità di pubblicazione simultanea sui social network o nei report analitici di Zernio.

L’integrazione fornisce invece l’accesso API necessario per gestire i blog e gli articoli presenti nella sezione Negozio online di Shopify.

Cosa puoi e non puoi fare

Funzionalità	Dettagli
Contenuti gestibili	Blog e articoli di Shopify
Metodo di autenticazione	OAuth 2.0 tramite il dominio del negozio oppure token Admin API generato da un’app personalizzata
Autorizzazioni richieste	read_content e write_content
Pubblicazione sui social media	Non supportata
Analisi e report	Non supportati
Immagini	Utilizzabili solo tramite URL; il caricamento diretto non è supportato
Pubblicazione programmata	Supportata tramite la funzione nativa publishDate di Shopify; Zernio non utilizza una coda di pubblicazione separata
Bozze	Supportate tramite isPublished: false
Contenuto dell’articolo	HTML tramite bodyHtml
Campi SEO	Supportati tramite seo.title e seo.description
Paginazione	Basata su cursore, con un numero di risultati compreso tra 1 e 50 per richiesta; il valore predefinito è 20

Se colleghi Shopify aspettandoti di pubblicare sui social network o consultare dati analitici, l’integrazione potrebbe sembrarti limitata. È più corretto considerarla un’integrazione dedicata alla gestione dei blog Shopify.

Come collegare un negozio Shopify

Sono disponibili due metodi di connessione.

Metodo 1: integrazione OAuth (consigliata)

Quando richiami l’endpoint di Zernio per collegare Shopify, il sistema restituisce un URL di autenticazione chiamato authUrl, invece di reindirizzare automaticamente l’utente.

Devi quindi indirizzare il proprietario del negozio verso questo URL. Dopo l’autorizzazione dell’installazione, Shopify elaborerà il callback e collegherà il negozio a Zernio.

Un requisito importante è conoscere in anticipo il dominio myshopify.com del negozio.

Durante questo processo di autenticazione, Shopify non mette a disposizione una schermata per selezionare il negozio e non consente di cercarlo tramite un indirizzo email. Senza il dominio, Zernio non può generare l’URL di autenticazione corretto.

Prima di avviare la connessione dovrai quindi chiedere al proprietario del negozio il relativo dominio myshopify.com.

Questo passaggio non è necessario quando l’app viene installata tramite Shopify App Store, perché Shopify comunica automaticamente il dominio del negozio a Zernio.

Metodo 2: token Admin API di un’app personalizzata

Se preferisci evitare il flusso di autenticazione tramite browser, il proprietario può creare un’app personalizzata dal pannello di amministrazione di Shopify:

Impostazioni → App e canali di vendita → Sviluppa app

Il proprietario deve assegnare all’app le autorizzazioni read_content e write_content, generare un token di accesso Admin API e fornirlo a Zernio.

Anche in questo caso è necessario indicare separatamente il dominio Shopify, perché il token non contiene informazioni che permettano di identificare il negozio a cui appartiene.

Gestione di blog e articoli Shopify

Dopo aver collegato il negozio, puoi ottenere l’elenco dei blog disponibili. In genere, i negozi Shopify includono per impostazione predefinita un blog chiamato “News”.

Una volta ottenuto l’ID del blog, puoi eseguire le normali operazioni CRUD sui suoi articoli:

• Visualizzare l’elenco degli articoli
• Creare un articolo
• Recuperare un articolo specifico
• Aggiornare un articolo
• Eliminare un articolo

Zernio permette anche di creare, aggiornare ed eliminare i blog stessi.

Quando crei un nuovo articolo, puoi specificarne il titolo, il contenuto HTML, i tag, il nome dell’autore, l’estratto e lo stato di pubblicazione.

• isPublished: true → Pubblica immediatamente
• isPublished: false → Salva come bozza
• Imposta una data futura tramite publishDate → Shopify pubblicherà automaticamente l’articolo nella data e nell’ora indicate

Gli articoli programmati utilizzano la funzione di pubblicazione nativa di Shopify. Non è quindi necessario attendere che Zernio elabori una coda di programmazione separata.

I valori di seo.title e seo.description vengono applicati direttamente ai campi title_tag e description_tag di Shopify, generalmente utilizzati dal tema come titolo della pagina e meta description.

Comportamenti importanti da conoscere

• L’URL non cambia automaticamente quando modifichi il titolo: l’handle dell’articolo viene generato quando il contenuto viene creato per la prima volta. Modificando successivamente il titolo, l’URL rimane invariato. Questa caratteristica è utile per conservare l’indirizzo di un articolo già pubblicato, ma può anche creare una differenza tra il titolo e l’URL. Se hai bisogno di controllare con precisione l’indirizzo, specifica manualmente il valore di handle.

• I tag vengono restituiti in ordine alfabetico: Shopify ordina i tag prima di restituirli, quindi il loro ordine potrebbe essere diverso da quello utilizzato durante l’inserimento.

• I contenuti eliminati non possono essere ripristinati: quando elimini un articolo, l’API restituisce una risposta 204. Le richieste successive per recuperarlo restituiranno un errore 404. Eliminando un intero blog verranno eliminati anche tutti gli articoli contenuti al suo interno. Zernio non conserva un backup per il ripristino.

• Il valore blogId deve essere numerico: se inserisci un valore non numerico, Zernio rifiuta la richiesta con un errore 400 prima ancora di contattare Shopify.

Funzionalità non supportate dall’integrazione Shopify

L’integrazione con Shopify è limitata alla gestione dei blog.

Non supporta le seguenti funzionalità:

• Pubblicazione simultanea su più social network
• Statistiche, analisi o insight
• Posta in arrivo o funzioni di messaggistica
• Caricamento diretto delle immagini
• Accesso ai prodotti
• Accesso agli ordini
• Accesso ai dati dei clienti

L’integrazione richiede esclusivamente le autorizzazioni relative ai contenuti: read_content e write_content. Non richiede l’accesso ai pagamenti o alle informazioni dei clienti.

Conclusioni

Con questo aggiornamento, Zernio amplia il proprio raggio d’azione oltre la gestione dei social media e consente di amministrare i blog Shopify attraverso lo stesso ecosistema API.

Sebbene si tratti di una funzione piuttosto specifica, può essere utile per sviluppatori e agenzie che desiderano automatizzare la gestione dei contenuti su più negozi e canali di pubblicazione.