Vai al contenuto principale

Risoluzione dei problemi di connessione di WooCommerce (WordPress)

Risolvi gli errori di connessione del plugin WooCommerce, i loop di autorizzazione, i problemi di accesso all'API e il blocco del firewall in Omnisend.

Scritto da Ira

Se non riesci a connettere il tuo negozio WooCommerce a Omnisend, vedi un errore "Omnisend non è in grado di connettersi" o rimani bloccato in un ciclo di autorizzazione, questa guida ti aiuterà a diagnosticare e risolvere il problema.

La maggior parte dei problemi di connessione deriva da conflitti tra plugin, impostazioni di firewall/sicurezza, restrizioni di accesso all'API o configurazione errata del negozio. Segui i passaggi diagnostici qui sotto per identificare e risolvere il problema.

Prima di risolvere i problemi: Assicurati di aver seguito il guida principale all'impostazione di WooCommerce e completato i passaggi di installazione.

Prima di iniziare

Verifica che questi prerequisiti siano soddisfatti. Se ne manca anche uno, la connessione fallirà indipendentemente dai passaggi di risoluzione dei problemi.

Richiesto per la connessione:

  • ✅ WooCommerce 3.6+ e WordPress 5.0+. Le versioni precedenti non supportano l'API REST v3 (richiesta da Omnisend). Vai a Plugin → Plugin installati per controllare le versioni.

  • ✅ HTTPS attivo (certificato SSL). L'URL del tuo negozio deve iniziare con https://. Omnisend non può accedere ai negozi senza certificati SSL validi.

  • ✅ WordPress installato nella radice del dominio. WordPress deve essere su yourdomain.com o subdomain.yourdomain.com, non yourdomain.com/store. Il plugin fallisce se WordPress è su un percorso a livello di pagina.

  • Accesso all'API REST abilitato. Apri yourdomain.com/wp-json/wc/v3/products nel tuo browser. Se vedi i dati del prodotto o un messaggio di errore, l'API funziona. Se vedi un errore 404, l'API REST è bloccata vedi sezione API REST bloccata.

  • ⚠️ Slot negozio vuoto (se hai già un'altra piattaforma connessa). Se hai Shopify, BigCommerce o un altro negozio collegato a Omnisend, devi creare un nuovo slot per negozio prima di collegare WooCommerce. Ogni piattaforma richiede il proprio negozio per prevenire la mescolanza dei dati.

Checklist diagnostica della connessione

Segui questi passaggi in ordine. Dopo ogni passaggio, prova a riconnetterti. Se la connessione riesce, hai trovato il problema.

Passaggio 1. Verifica i prerequisiti

Conferma che tutti i requisiti di Prima di Iniziare siano soddisfatti:

  • WooCommerce 3.6+ installato

  • HTTPS attivo (l'URL inizia con https://)

  • WordPress nella radice del dominio (non /store sottodirectory)

  • API REST accessibile (testa su yourdomain.com/wp-json/wc/v3/products)

  • Slot negozio vuoto creato (se hai altre piattaforme connesse)

Passo 2. Disabilita i plugin problematici noti

Questi plugin bloccano frequentemente le connessioni di Omnisend. Disabilitali temporaneamente uno alla volta, quindi riprova a connetterti dopo ciascuno:

Per disabilitare un plugin, vai su WordPress Admin → Plugin → Plugin installati → clicca su Disattiva.

  • WP Crontrol – Interferisce con i lavori cron di Omnisend

  • LiteSpeed Cache – Rimuove le intestazioni di autorizzazione

  • Really Simple Security – Blocca le richieste all'API REST

  • Wordfence / Cloudflare – Il firewall blocca gli IP di Omnisend

  • Perfmatters – Può disabilitare l'API REST o gli script

💡 Dopo che la connessione ha successo: Riattiva i plugin uno alla volta per identificare il colpevole.

Passaggio 3. Aggiungi gli indirizzi IP di Omnisend alla whitelist

Se utilizzi Wordfence, Cloudflare, Really Simple Security o qualsiasi plugin firewall, potrebbero bloccare le richieste di Omnisend.

→ Vai alla sezione Correzioni del Plugin Firewall & Sicurezza per autorizzare gli IP e gli user-agent di Omnisend.

Come aggiungere alla whitelist:

Passaggio 4. Svuota la cache e testa in incognito

  1. Svuota la cache del tuo browser (Ctrl+Shift+Delete su Chrome/Edge, Cmd+Shift+Delete su Safari).

  2. Apri una finestra in incognito/privata.

  3. Accedi a WordPress e prova a connetterti di nuovo.

Se il problema persiste in modalità incognito, un'estensione del browser o una sessione memorizzata nella cache sta probabilmente causando il problema. Disabilita temporaneamente le estensioni o usa un browser diverso.

Passo 5. Verifica lo stato della connessione

In WordPress: Vai alla pagina del plugin Omnisend. Lo stato dovrebbe mostrare "Connesso."

In Omnisend: Vai a Impostazioni Negozio → Informazioni di Contatto → verifica che l'URL del tuo negozio corrisponda al tuo dominio live (non localhost o staging).

Test endpoint:
Apri yourdomain.com/wp-json/omnisend-api/v1/connected nel tuo browser. Dovrebbe restituire true.

Scenari di errore specifici

Se la checklist diagnostica non ha risolto il tuo problema, trova lo scenario di errore qui sotto che corrisponde ai tuoi sintomi.

Ciclo di reindirizzamento di autorizzazione

Cosa vedi:

  • Clicchi "Approva" nella finestra di consenso di WooCommerce.

  • Sei reindirizzato a "Collega il tuo account" senza completare la configurazione

  • La connessione non termina mai.

Perché succede: Un plugin di caching, un plugin di sicurezza o WP Crontrol sta rimuovendo l'intestazione di autorizzazione durante il processo di approvazione.

Come risolvere:

  1. Disabilita WP Crontrol: Vai a Plugin → Plugin installati → Disattiva WP Crontrol.

  2. Disabilita temporaneamente i plugin di caching: Disattiva LiteSpeed Cache, WP Rocket o qualsiasi plugin di caching.

  3. Pulisci la cache del browser e apri una finestra in incognito.

  4. Prova a connetterti di nuovo.

  5. Se il loop persiste: Contatta il tuo fornitore di hosting (SiteGround, Bluehost, GoDaddy) e chiedi loro di confermare che l'intestazione Authorization non venga rimossa a livello di server.

💡 Dopo una connessione riuscita: Riattiva i plugin uno per uno per identificare il blocco.

Il plugin mostra connesso, ma Omnisend dice "Impossibile connettersi"

Cosa vedi:

  • Il plugin Omnisend in WordPress mostra "attivo" o "connesso."

  • Il pannello di controllo di Omnisend mostra un banner rosso: "Omnisend non è in grado di connettersi al tuo WooCommerce."

  • I dati non si sincronizzano tra WooCommerce e Omnisend.

Perché succede: Omnisend non può accedere alla tua API REST di WooCommerce, anche se il plugin è installato.

Come risolvere:

  1. Controlla la Chiave API: Vai su WooCommerce → Impostazioni → Avanzate → API REST e verifica che la chiave API di Omnisend esista e non sia scaduta o revocata.

  2. Test API Access: Apri yourdomain.com/wp-json/omnisend-api/v1/connected nel tuo browser.

    • Se restituisce true, la connessione funziona – attendi 10 minuti e aggiorna il tuo pannello di controllo Omnisend.

    • Se restituisce false o 404, l'API è bloccata – vedere la sezione REST API Bloccata.

  3. Aggiungi IP di Omnisend alla whitelist: Aggiungi gli indirizzi IP di Omnisend a Wordfence, Cloudflare o al tuo firewall – vedi Sezione di correzioni del plugin Firewall & Security.

  4. Verifica URL Negozio: Vai a Omnisend → Impostazioni Negozio → Informazioni di Contatto e conferma che l'URL del tuo negozio corrisponda al tuo dominio reale (non localhost o un URL di staging come staging.yourdomain.com).

"Pulsante Aggiungi Permessi" mancante

Cosa vedi: Dopo aver installato il plugin, non vedi il "pulsante Aggiungi permessi" nella pagina del plugin Omnisend.

Perché succede: Una vecchia chiave API di Omnisend è ancora attiva, impedendo la visualizzazione del nuovo prompt di autorizzazione.

Come risolvere:

  1. Vai a WooCommerce → Impostazioni → Avanzate → REST API.

  2. Trova la chiave Omnisend nella lista.

  3. Clicca Revoca per eliminarlo.

  4. Torna alla pagina del plugin Omnisend.

  5. Il pulsante "Aggiungi autorizzazioni" dovrebbe ora apparire. Cliccalo e approva.

Pagina vuota o errore "Non trovato" durante la connessione

Cosa vedi: Quando clicchi "Connetti" o "Approva," vedi:

  • Una pagina bianca.

  • "L'URL richiesto non è stato trovato su questo server" (errore 404).

  • Errore del browser invece del popup di approvazione.

Perché succede: Il tuo server sta rimuovendo l'intestazione di autorizzazione, oppure l'API REST di WooCommerce è disabilitata.

Come risolvere:

  1. Aggiungi l'intestazione di autorizzazione a .htaccess:
    Apri your .htaccess file (nella tua cartella principale di WordPress tramite FTP o cPanel File Manager) e aggiungi questa riga:

    SetEnvIf Authorization "(.*)" HTTP_AUTHORIZATION=$1

  2. Salva il file e riprova a connetterti.

  3. Controlla l'accesso all'API REST:
    Vai a yourdomain.com/wp-json/wc/v3/products nel tuo browser.

  4. Contatta il tuo host:
    Alcuni host (Bluehost, GoDaddy, WP Engine) bloccano gli endpoint dell'API REST per impostazione predefinita. Chiedi loro di abilitare /wp-json/ access.

API REST bloccata

Cosa vedi: La connessione fallisce, e yourdomain.com/wp-json/wc/v3/products restituisce un errore 404 o "L'API REST è disabilitata."

Perché succede: L'API REST è disabilitata dal tuo host, plugin di sicurezza o impostazioni del tema.

Come risolvere:

  1. Controlla i plugin di sicurezza:

    • In Wordfence: Vai su Wordfence → Firewall → Opzioni Firewall e assicurati che l'API REST non sia bloccata.

    • In Really Simple Security: Vai su Impostazioni → API REST e consenti l'accesso all'API REST.

  2. Controlla le impostazioni del tema: Alcuni temi (ad es., Divi, Avada) includono opzioni per disabilitare l'API REST. Controlla le impostazioni del tema e riattivala.

  3. Aggiungi regola .htaccess: Aggiungi the Authorization header fix from

  4. Contatta il fornitore di hosting: Chiedi loro di confermare /wp-json/ gli endpoint non sono bloccati a livello di server (comune con Bluehost, GoDaddy e WP Engine).

"Errore Negozio Già Connesso"

Cosa vedi: Appare un banner:

  • "Questo negozio Omnisend è già connesso. Seleziona un altro negozio dal tuo account e riprova."

  • "Nessuno slot negozio disponibile"

Perché succede: Hai già un negozio (Shopify, WooCommerce, BigCommerce, ecc.) collegato a Omnisend e non hai creato un nuovo slot per questo sito WooCommerce, oppure il tuo dominio WooCommerce era precedentemente collegato a un altro account Omnisend (inclusi gli account di test).

Come risolvere:

  • Se hai un'altra piattaforma connessa:

  1. Crea un nuovo slot negozio in Omnisend:
    Vai a Impostazioni Account → Negozi → Aggiungi Nuovo Negozio.

  2. Passa al nuovo negozio vuoto:
    Clicca sull'interruttore del negozio (in alto a destra del pannello di controllo di Omnisend → Cambia negozio) e seleziona il nuovo negozio.

  3. Torna a WordPress e clicca di nuovo su "Collega il tuo account".

  4. Approva la connessione nel pop-up.

💡 Perché? Ogni piattaforma (Shopify, WooCommerce, BigCommerce) deve collegarsi a un negozio separato nel tuo account Omnisend per prevenire la mescolanza dei dati.

  • Se il tuo dominio era precedentemente collegato a un altro account Omnisend:

Contatta il nostro supporto a [email protected] o tramite chat in-app per disconnettere il vecchio link.

La connessione ha funzionato prima (si è interrotta all'improvviso)

Cosa vedi:

  • Il plugin era connesso per settimane o mesi.

  • Improvvisamente mostra "impossibile connettersi" o la sincronizzazione si ferma.

  • Non sono state apportate modifiche (che tu ricordi).

Perché succede questo:

  • L'URL del tuo negozio è cambiato leggermente (aggiunto/rimosso www.).

  • Un recente aggiornamento del plugin o di WooCommerce ha revocato i permessi API.

  • Le impostazioni del firewall sono cambiate durante un aggiornamento del server.

  • Il certificato SSL è scaduto.

Come risolvere:

  1. Controlla se l'URL del tuo negozio è cambiato: Vai a Omnisend → Impostazioni Negozio → Informazioni di contatto. Se l'URL non corrisponde al tuo dominio effettivo (controlla per www. differenze), aggiornalo.

  2. Verifica che la chiave API esista: Vai a WooCommerce → Impostazioni → Avanzate → API REST. Se la chiave Omnisend è mancante, vai alla pagina del plugin Omnisend → clicca "Aggiungi permessi" → Approva.

  3. Controlla il tuo certificato SSL: Testa su Controllo SSL. Se scaduto o non valido, rinnova tramite il tuo fornitore di hosting (molti offrono certificati gratuiti Let's Encrypt).

  4. Se nessuno di questi funziona: Vai alla pagina del plugin Omnisend → clicca "Aggiungi permessi" → Approva → aspetta 10 minuti → aggiorna.

4A1 Se il negozio si connette ma i dati non si aggiornano ancora, vedere Dati non sincronizzati dopo la connessione qui sotto.

Il banner di aggiornamento del plugin non scompare

Cosa vedi: Hai aggiornato il plugin Omnisend, ma un banner dice ancora "Aggiornamento richiesto" o "Problema di connessione."

Perché succede: Tempo di attesa temporaneo nella sincronizzazione delle autorizzazioni del plugin con Omnisend.

Come risolvere:

  1. Vai alla pagina del plugin Omnisend in WordPress.

  2. Clicca Aggiungi permessi (se il pulsante appare).

  3. Clicca Approva nella finestra di consenso di WooCommerce.

  4. Aspetta 510 minuti affinché le modifiche si propaghino.

  5. Svuota la cache del tuo browser e aggiorna la pagina.

Se il banner persiste dopo 10 minuti, vedere la sezione Plugin mostra connesso, ma Omnisend dice "Impossibile connettersi".

Correzioni del plugin Firewall e Sicurezza

Se utilizzi Wordfence, Cloudflare, Really Simple Security, o qualsiasi plugin firewall, devi autorizzare gli indirizzi IP di Omnisend e gli user-agent.

Indirizzi IP di Omnisend da aggiungere alla lista bianca:

Aggiungi questi IP alla tua lista di autorizzazione del firewall:

  • 34.170.162.11

  • 34.56.62.59

  • 34.56.108.215

  • 34.133.59.36

  • 34.58.66.146

  • 35.184.130.5

  • 35.232.14.89

Wordfence

Per autorizzare gli IP di Omnisend in Wordfence:

  1. Vai a WordPress Admin → Wordfence → Firewall.

  2. Clicca Gestisci Firewall → scorri fino a "Indirizzi IP autorizzati."

  3. Incolla ogni indirizzo IP di Omnisend su una nuova riga.

  4. Clicca Salva modifiche.

  5. Torna a WordPress e riprova a connetterti.

Cloudflare

Per autorizzare Omnisend in Cloudflare:

  1. Accedi al tuo pannello di controllo Cloudflare

  2. Vai a Sicurezza → WAF (Web Application Firewall)

  3. Clicca Crea Regola

  4. Imposta Nome Regola: Consenti Omnisend (o simile)

  5. Imposta Campo: User Agent | Operatore: contains | Valore: Omnisend/1.0 (sensibile alle maiuscole)

  6. Imposta Azioni: Salta

  7. Seleziona tutti i componenti da saltare

  8. Clicca Distribuisci

Per autorizzare gli IP di Omnisend:

  1. Vai a Sicurezza → WAF → Strumenti

  2. Scorri fino a Regole di Accesso IP

  3. Aggiungi ogni IP di Omnisend (vedi lista sopra) e imposta Azioni su Consenti

  4. Clicca Aggiungi

Dopo aver salvato, reinstallare il plugin Omnisend in WordPress e riconnettersi.

Sicurezza Davvero Semplice

Per consentire le richieste di Omnisend:

  1. Vai a WordPress Admin → Really Simple Security → Impostazioni

  2. Clicca REST API

  3. Assicurati che il REST API sia non disabilitato

  4. Vai a Firewall → Elenco di autorizzazione IP

  5. Aggiungi ogni indirizzo IP di Omnisend (vedi lista sopra)

  6. Salva e riprova a connetterti

Dati non sincronizzati dopo la connessione

Se il tuo Negozio è connesso ma mancano o sembrano obsoleti contatti, ordini, Prodotti o categorie di prodotto, segui questi passaggi.

Cosa vedi:

  • Contatti, ordini, prodotti o categorie di prodotto mancano in Omnisend.

  • I dati hanno smesso di aggiornarsi dopo un aggiornamento del plugin o un cambiamento del negozio.

  • I prodotti o le categorie non appaiono anche se il negozio risulta connesso.

Perché accade: La sincronizzazione avviene interamente sul backend di Omnisend tramite l'API REST di WooCommerce e webhook. Qualsiasi cosa che impedisca a Omnisend di raggiungere l'API del tuo negozio – o che blocchi i webhook dal raggiungere Omnisend – fermerà la sincronizzazione.

Come risolvere:

  1. Consenti tempo per l'importazione iniziale. Dopo aver effettuato la connessione o l'aggiornamento alla versione del plugin 1.20.0 o successiva, Omnisend esegue un riempimento retroattivo una tantum di tutti i dati esistenti. Questo può richiedere fino a 24 ore per i negozi di grandi dimensioni.

  2. Conferma che il plugin sia aggiornato alla versione 1.20.0 o successiva. Nelle versioni precedenti, il plugin potrebbe ancora inviare alcuni dati mentre il backend di Omnisend li sincronizza. Aggiorna tramitePlugin → Aggiornamenti in WordPress.

  3. Controlla i plugin in conflitto. I plugin di sicurezza, firewall, caching o quelli che modificano l'API REST di WooCommerce possono bloccare la sincronizzazione. Disabilita temporaneamente i plugin sospetti per isolare il conflitto. Colpevoli comuni: Wordfence, LiteSpeed Cache, Really Simple Security, Perfmatters, WP Crontrol.

  4. Verifica che gli IP di Omnisend siano nella lista autorizzata. Vedi ilIndirizzi IP di Omnisend da autorizzare nella sezione Correzioni del Firewall & Sicurezza.

  5. Controlla le credenziali API di WooCommerce. Vai aWooCommerce → Impostazioni → Avanzate → API REST e conferma che la chiave API di Omnisend esista e non sia stata revocata o rigenerata. Se è mancante, vai alla pagina del plugin Omnisend → cliccaAggiungi permessi →Approva.

  6. Controlla se c'è una discrepanza tra staging e produzione. Se il tuo negozio era connesso in un ambiente di staging e l'URL del negozio live è cambiato, Omnisend potrebbe cercare di raggiungere l'ambiente sbagliato. Vai aOmnisend → Impostazioni Negozio → Informazioni di Contatto e conferma che l'URL del negozio corrisponda al tuo dominio di produzione live. In caso contrario, riconnetti il plugin.

Se nessuna delle opzioni sopra risolve il problema, contatta il nostro Team di Supporto a [email protected] o tramite chat in-app.

Conflitti dei Plugin & Soluzioni Permanenti

Se disabilitare un plugin ha risolto la tua connessione, utilizza queste soluzioni permanenti in modo da poter mantenere il plugin attivo.

WP Crontrol

Problema: Gestisce i cron job di WordPress e blocca i processi in background di Omnisend.

Correzione: Tienilo disabilitato durante la connessione. Dopo aver effettuato la connessione, riattivalo solo se ne hai bisogno per altri compiti. Se i problemi persistono, lascialo disabilitato.

LiteSpeed Cache

Problema: Rimuove le intestazioni di autorizzazione, causando errori di connessione.

Correggi:

  1. Vai a WordPress Admin → LiteSpeed Cache → Escludi

  2. Sotto URI Exclude, aggiungi: /wp-json/omnisend*

  3. Salva le impostazioni e riprova a connetterti

Cloudflare (Turnstile / Modulo Form)

Problema: Blocca le richieste del bot Omnisend.

Correzione: Aggiungi l'user-agent Omnisend/1.0 (sensibile al maiuscolo) nelle regole WAF di Cloudflare – vedi la sezione Cloudflare.

Perfmatters

Problema: Può disabilitare il REST API o JavaScript necessario per la connessione.

Correzione:

  1. Vai su Perfmatters Impostazioni Disabilita

  2. Assicurati che il REST API sia non disabilitato

  3. Riprova a connetterti

Risoluzione avanzata dei problemi

Clonare il tuo Negozio WooCommerce (Ambienti di Staging/Test)

Quando cloni il tuo Negozio WooCommerce per creare un ambiente di test o di staging, ti consente di testare in sicurezza nuove funzionalità, aggiornamenti e altre modifiche senza influire sul tuo negozio live.

Come funziona il plugin Omnisend: Il plugin Omnisend garantisce una chiara distinzione tra i tuoi ambienti di produzione e staging disconnettendo automaticamente l'ambiente di staging dall'invio di dati al tuo negozio live. Richiede anche che l'ambiente di staging sia connesso a un marchio di test.

Passi per impostare un ambiente di staging

Passo 1: Azioni nel tuo Negozio di Produzione. Clona il tuo negozio utilizzando gli strumenti del tuo provider di hosting, un plugin WordPress (WP Staging, Duplicator) o una copia manuale FTP/database. Questo crea l'ambiente desiderato per testare o altri scopi.

Passo 2: Azioni nel Tuo Negozio di Staging. Collega il plugin di staging a un marchio di test separato in Omnisend (non il tuo marchio di produzione). Questo garantisce che l'ambiente di staging sia collegato a un marchio diverso dal tuo negozio live. Il plugin visualizza il nome del marchio, rendendo più facile distinguere a quale marchio Omnisend è connesso.

Note importanti

⚠️ Disconnessione Automatica: Quando viene creata una copia di produzione, il plugin di staging si disconnetterà automaticamente dal negozio principale, impedendo l'invio di dati all'ambiente di produzione.

Il plugin Omnisend rileva quando è stato creato un ambiente di staging e si disconnette dal tuo negozio live in modo che nessun dato non di produzione venga inviato lì. Perché il plugin rilevi il cambiamento dell'ambiente, il tuo ambiente di staging clonato deve avere la variabile WordPress WP_ENVIRONMENT_TYPE impostata su "staging" o "development".

Questo dovrebbe essere impostato automaticamente dal tuo strumento di clonazione preferito oppure, se stai clonando manualmente, potrebbe essere impostato nel tuo wp-config.php file, come:

define('WP_ENVIRONMENT_TYPE', 'staging');

Come verificare la tua configurazione di staging

Se stai utilizzando uno strumento di terze parti per clonare il tuo negozio e vuoi assicurarti che la configurazione creata sia corretta, puoi farlo:

  1. Vai al pannello di controllo admin di WordPress del tuo negozio clonato

  2. Naviga su Strumenti Salute del sito Info Costanti di WordPress

  3. Verifica che WP_ENVIRONMENT_TYPE sia impostato su "staging" o "development"

Valori come "production" o "Undefined" dovrebbero apparire solo nel tuo negozio di produzione. Se appaiono nel tuo negozio clonato, ciò indica una configurazione errata, poiché il plugin Omnisend non sarebbe in grado di rilevare che deve disconnettersi.

Per i passaggi dettagliati su come clonare il tuo Negozio WooCommerce e creare un ambiente di test o di staging, ti preghiamo di seguire queste guide:

Visualizzazione del nome del marchio: Il plugin Omnisend visualizza il nome del marchio per aiutarti a identificare facilmente a quale marchio è connesso.

Problemi con la struttura dei permalink

Problema: Alcuni errori 404 si risolvono quando la struttura dei permalink viene ripristinata.

Correzione:

  1. Vai su WordPress Admin Impostazioni Permalink.

  2. Clicca Salva modifiche (anche senza apportare modifiche).

  3. Riprova a connetterti.

Problemi con il certificato SSL

Problema: Un certificato SSL non valido o scaduto impedisce l'accesso all'API.

Correzione:

  1. Controlla il tuo certificato SSL su SSL Checker.

  2. Se scaduto o non valido, rinnova tramite il tuo fornitore di hosting (molti offrono certificati gratuiti di Let's Encrypt).

  3. Dopo il rinnovo, riprova a connetterti.

Blocco dell'intestazione di autorizzazione a livello di server

Problema: Alcuni host (SiteGround, Bluehost, GoDaddy) rimuovono l'intestazione di autorizzazione per impostazione predefinita.

Correzione:

  1. Aggiungi questa riga al tuo file .htaccess (nella root di WordPress):

    SetEnvIf Authorization "(.*)" HTTP_AUTHORIZATION=$1

  2. Se il problema persiste, contatta il tuo fornitore di hosting e chiedi loro di abilitare il passaggio dell'intestazione di autorizzazione per le richieste API REST.

Come risolvere i problemi di accesso all'API

A causa di problemi di accesso all'API, i dati del tuo negozio non verranno sincronizzati con Omnisend. Questo ti impedisce di inviare messaggi al tuo Audience.Se i dati del tuo negozio non si sincronizzano, l'accesso all'API potrebbe essere bloccato da:

  • Plugin di sicurezza (di terze parti).

  • Codice PHP personalizzato che impedisce l'accesso all'API.

  • Impostazioni di sicurezza di WordPress o WooCommerce.

Si prega di contattare i propri sviluppatori per identificare e risolvere eventuali cause potenziali.

Per verificare se l'API di WooCommerce è accessibile:

  1. Vai a WooCommerce → Impostazioni → Avanzate → API REST.

  2. Clicca Aggiungi chiave.

  3. Inserisci un nome qualsiasi e fai clic su Genera Chiave API.

  4. Prendi la chiave del consumatore e il segreto, quindi inserisci questo URL nel tuo browser:

    {shopDomain}/wp-json/wc/v3/products?consumer_key={consumer_key}&consumer_secret={consumer_secret}

  5. Se appare la lista dei prodotti, l'API funziona.

  6. Elimina la chiave API di test dopo aver controllato.

Per verificare se l'API di Omnisend è accessibile:

  1. Aggiorna all'ultima versione del plugin Omnisend.

  2. Apri {shopDomain}/wp-json/omnisend-api/v1/connected nel tuo browser dovrebbe restituire true.

Verifica che la tua correzione abbia funzionato

Dopo aver applicato qualsiasi correzione, conferma che la connessione sia attiva:

  • In WordPress: Vai a Pagina del plugin Omnisend. Lo stato dovrebbe mostrare "Connesso."

  • In Omnisend: Vai a Audience → Contatti e conferma che i contatti del negozio appaiano.

  • Test Endpoint: Apriyourdomain.com/wp-json/omnisend-api/v1/connected nel tuo browser. Dovrebbe restituire true.

Domande frequenti

Il plugin mostra "connesso" in WordPress, ma Omnisend dice "impossibile connettersi." Perché?
Significa che Omnisend non può accedere alla tua API di WooCommerce, anche se il plugin è attivo. Controlla che la tua API REST di WooCommerce sia accessibile, aggiungi gli indirizzi IP di Omnisend alla lista bianca nel tuo firewall e verifica che l'URL del tuo negozio in Omnisend corrisponda al tuo dominio reale (non localhost).

Cosa significa "L'URL richiesto non è stato trovato su questo server" durante la connessione?
Questo errore significa che il tuo server sta bloccando o configurando in modo errato gli endpoint dell'API REST di WooCommerce. Aggiungi SetEnvIf Authorization "(.*)\" HTTP_AUTHORIZATION=$1 al tuo file .htaccess, oppure contatta il tuo fornitore di hosting per abilitare l'accesso all'API REST.

Perché cliccando su "Connetti" appare una pagina bianca vuota?
Una pagina vuota durante la connessione indica che il tuo server sta rimuovendo l'intestazione di autorizzazione o un plugin sta bloccando le richieste all'API. Aggiungi the Authorization header fix to .htaccess (vedi sopra), disabilita temporaneamente i plugin di caching/sicurezza e riprova.

Ho aggiornato il plugin, ma il banner dice ancora "aggiornamento richiesto." E ora?
Dopo l'aggiornamento, vai alla pagina del plugin Omnisend in WordPress e clicca "Aggiungi permessi." Aspetta 5–10 minuti, svuota la cache del tuo browser e aggiorna. Se il banner persiste, vedi Il plugin mostra connesso, ma Omnisend dice "Impossibile connettersi" sezione.

WP Crontrol sta causando problemi. Cosa fa questo plugin?
WP Crontrol gestisce i cron job di WordPress (compiti programmati). Può interferire con i processi in background di Omnisend. Disabilitalo temporaneamente, completa la connessione, poi riattivalo. Se i problemi persistono, lascialo disabilitato o contatta il supporto.

Quali indirizzi IP devo inserire nella whitelist per Omnisend?
Inserisci questi IP nella whitelist in Wordfence, Cloudflare, Really Simple Security, o in qualsiasi plugin firewall: 34.170.162.11, 34.56.62.59, 34.56.108.215, 34.133.59.36, 34.58.66.146, 35.184.130.5, 35.232.14.89.

Uso Cloudflare. Come posso autorizzare Omnisend?
Vai a Cloudflare → Security → WAF → Create a rule. Autorizza l'user-agent Omnisend/1.0 (sensibile al maiuscolo) e aggiungi gli indirizzi IP di Omnisend (vedi FAQ sopra) alla tua lista di autorizzazione. Dopo aver salvato, reinstalla il plugin Omnisend.

L'URL del mio negozio è cambiato (da localhost o staging). Come posso riconnettermi?
Vai a Omnisend → Store Settings → Contact information and update your store URL to the live domain. Aspetta 10 minuti, poi esci e accedi di nuovo. Se il problema persiste, disconnetti e riconnetti il plugin da WordPress.

Perché il mio Negozio WooCommerce è lento dopo essermi connesso a Omnisend?
Se stai utilizzando una versione del plugin precedente alla 1.20.0, il plugin potrebbe comunque inviare alcuni dati mentre il backend di Omnisend li sincronizza, creando un carico di sincronizzazione doppio su contatti, ordini, prodotti e categorie di prodotto.Update to version 1.20.0 or later to resolve this.Vai a Plugin → Aggiornamenti in WordPress.

Se hai domande o hai bisogno di assistenza, contatta il nostro Team di Supporto a [email protected] o tramite chat in-app.

Articoli correlati
Hai ricevuto la risposta alla tua domanda?