Sincronizzazione del commercio esterno

Panoramica

Canali e integrazioni → Commercio esterno (/it/integrations/commerce) mantiene il checkout su Shopify o WooCommerce mentre rispecchia i dati supportati in OrderInChat. Il widget, WhatsApp e Instagram AI, automazioni e etichette di spedizione opzionali utilizzano i dati rispecchiati.

Questa integrazione non clona il tema sorgente e non sostituisce il checkout esterno.

Connessione Shopify

OrderInChat utilizza Shopify OAuth in modo da non dover copiare i token manualmente.

1. Nel dashboard Partner di Shopify crea un'app chiamata Order in Chat.
2. Aggiungi l'URL di callback https://app.orderinchat.com/api/store/commerce/shopify/oauth/callback a URL di reindirizzamento consentiti.
3. Concedi questi ambiti API Admin: read_products, write_products, read_inventory, write_inventory, read_orders, read_customers, read_content, read_legal_policies, read_discounts, read_shipping, read_files, read_locales, read_locations, read_script_tags, write_script_tags.
4. In OrderInChat vai su Canali e integrazioni → Commercio esterno, scegli Shopify, inserisci l'URL del negozio HTTPS (ad esempio https://your-store.myshopify.com) e fai clic su Connetti con Shopify.
5. Approva i permessi in Shopify. Tornerai automaticamente a OrderInChat. Poi fai clic su Testa connessione, Registra webhook e Sincronizza ora.

Se non puoi utilizzare OAuth, espandi la sezione Impostazione manuale del token e incolla il token di accesso API Admin e la chiave segreta API dell'app personalizzata. La chiave segreta API è necessaria per verificare le firme HMAC dei webhook di Shopify. OrderInChat cripta le credenziali e non le visualizza mai più.

Guide ufficiali: App personalizzate di Shopify e Token di accesso API Admin.

Connessione WooCommerce

In WordPress apri WooCommerce → Impostazioni → Avanzate → REST API, crea una chiave con permesso di lettura per la sincronizzazione solo in mirror, o permesso di lettura/scrittura se le modifiche dell'Editor in blocco devono essere scritte nuovamente in WooCommerce, e inserisci l'URL del negozio HTTPS, la chiave del consumatore e il segreto del consumatore. Per sincronizzare le pagine e i post di WordPress, inserisci anche un nome utente di WordPress e una Password dell'applicazione da Utenti → Profilo.

Guida ufficiale: API REST di WooCommerce.

Alcuni host rifiutano l'autenticazione HTTP Basic. Il connettore può riprovare le richieste di WooCommerce con l'autenticazione tramite query string; le credenziali vengono oscurate dai log.

Comportamento di sincronizzazione

1. Salva e testa la connessione.
2. Registra webhook — crea abbonamenti sul negozio esterno in modo che le modifiche a prodotti, ordini e clienti notifichino OrderInChat quasi in tempo reale. OrderInChat controlla anche regolarmente le modifiche nel caso in cui un webhook venga perso.
3. Seleziona le risorse da rispecchiare.
4. Esegui la sincronizzazione iniziale.

Per sicurezza, OrderInChat verifica ogni webhook e ricontrolla i dati con Shopify o WooCommerce prima di salvarli. I controlli regolari recuperano i webhook persi solo mentre l'uso come fonte di commercio è abilitato. Se lo stato del webhook mostra un errore e la connessione è inattiva, utilizza Registra webhook e Sincronizza ora dopo le modifiche sul negozio sorgente; Testa connessione da solo non aggiorna i prodotti. Gli aggiornamenti ripetuti non creano record duplicati.

Il peso di spedizione delle varianti di Shopify viene importato dal peso della variante in Shopify; l'editor di prodotto lo mostra nell'unità di peso configurata nel negozio. I metafield delle dimensioni chiamati length, width o height vengono convertiti in centimetri. Le descrizioni dei prodotti di Shopify provengono dalla descrizione del prodotto stesso, non da sezioni o banner di tema condivisi; il testo del tema non diventa una descrizione specifica del prodotto. I prodotti in bozza e archiviati non vengono mostrati ai clienti.

Quando il tuo negozio utilizza il commercio esterno, i clienti acquistano tramite l'URL del prodotto sorgente. Il checkout del carrello di OrderInChat e i flussi di checkout di WhatsApp sono disattivati per quel negozio.

Località di inventario

Le località di Shopify e i livelli di inventario per variante vengono rispecchiati in record di magazzino/località di OrderInChat. Le scorte di prodotto e variante mostrano il totale di tutte le località per chat e checkout. Il core di WooCommerce espone un valore totale di stock, quindi viene rispecchiato in una posizione virtuale predefinita; lo stock su più località dei plugin WooCommerce richiede un plugin supportato.

Puoi aggiungere le tue località OrderInChat sotto Catalogo → Inventario. Le celle di stock dell'Editor in blocco si espandono per località. L'invio dell'inventario a Shopify aggiorna solo la località selezionata e richiede l'ambito write_inventory. I campi di stock bloccati non vengono sovrascritti da una successiva sincronizzazione dell'inventario.

Etichette di spedizione

Le etichette di spedizione OrderInChat sono disattivate per impostazione predefinita. Abilitale solo se OrderInChat deve essere l'unico posto in cui vengono create le etichette. Anche quando abilitate, OrderInChat non acquista un'etichetta quando l'ordine esterno ha già informazioni di evasione o tracciamento.

Snippet del widget

Shopify: La registrazione dei webhook prova anche a installare automaticamente il widget di chat sul tuo negozio Shopify. Puoi comunque incollare lo snippet in Custom Liquid se necessario. Concedi write_script_tags all'app personalizzata se l'installazione automatica fallisce.

WooCommerce: L'API REST non può iniettare script di tema. Copia lo snippet JavaScript o PHP dalla pagina di integrazione nel footer del tema o in functions.php.

Pagine → Knowledge Base

Quando Pagine e post è abilitato, le pagine/articoli/politiche di Shopify e le pagine/post di WooCommerce vengono aggiunti (o aggiornati) nella Knowledge Base di OrderInChat per risposte AI. I titoli delle politiche di Shopify corrispondenti riempiono anche i campi di ritorno/termini del negozio. Questo non è un clone completo del tema/CMS.

Limitazioni API

L'integrazione riporta dati non supportati o non disponibili invece di inventare valori. Le limitazioni comuni includono:

• Shopify non espone tutte le impostazioni di pagamento tramite l'API Admin.
• I prezzi di spedizione calcolati dal corriere rimangono calcolati al checkout esterno.
• L'API REST di WooCommerce non include le pagine di WordPress senza una Password dell'applicazione di WordPress.
• Le recensioni e le prenotazioni richiedono un'API di piattaforma o app che esponga quelle risorse.
• Gli add-on dei prodotti vengono rispecchiati solo quando l'API sorgente ha un equivalente reale.