Risoluzione dei problemi dell'integrazione con WooCommerce

Cosa imparerai

Scopri come risolvere i problemi di configurazione delle integrazioni di WooCommerce seguendo lo scenario di risoluzione dei problemi pertinente descritto di seguito. Se riscontri problemi non presenti in questo elenco, contattaci nella Community o il nostro team di assistenza.

Prima di iniziare

Se non l'hai ancora fatto, leggi la nostra guida su Primi passi con WooCommerce per le istruzioni sull'integrazione passo passo. Se vuoi aggiornare il tuo plugin, leggi il nostro articolo su come aggiornare il tuo plugin WooCommerce.

Scenari di risoluzione dei problemi

Consulta i seguenti scenari in base al messaggio di errore ricevuto nell’app per risolvere il problema.

"Per evitare interruzioni delle funzionalità, potresti dover disattivare i seguenti plugin: Nome/i del plugin"

Se hai plugin di caching attivi o plugin di reindirizzamento in WordPress, possono interferire con l'integrazione di Klaviyo e causare problemi di connessione. Ti consigliamo di disattivare questi plugin durante la procedura di configurazione delle integrazioni.

“Non possiamo completare la tua configurazione”

Questo messaggio significa che il tuo firewall sta bloccando le richieste di Klaviyo, che hai abilitato Bot Fight Mode in Cloudflare o entrambe le cose.

Per risolvere il problema, consigliamo sia di inserire in allowlist il traffico di integrazioni di Klaviyo sia di disattivare Bot Fight Mode (se lo hai attivato).

1. Scopri come aggiungere gli indirizzi IP del traffico delle integrazioni Klaviyo alla lista consentita.
2. Per disattivare la modalità Bot Fight in Cloudflare:
   1. Accedi al pannello di controllo di Cloudflare.
   2. Seleziona il tuo account e dominio.
   3. Vai a Sicurezza > Bot.
   4. Per Bot Fight Mode, seleziona Off.

"Assicurati che il tuo negozio WooCommerce abbia https e SSL abilitati"

Klaviyo si aspetta che l’URL del tuo store rispetti i protocolli HTTPS, ovvero che il sito web disponga di un certificato SSL valido. Se il tuo sito web è in HTTP anziché HTTPS, potresti riscontrare problemi.

Puoi verificare se il tuo certificato SSL è valido su SSL Server Test (Powered by Qualys SSL Labs).

Klaviyo richiede che i test vengano superati con valutazioni A.

“Impossibile accedere all'API con le credenziali fornite”

Potresti ricevere questo errore se sono presenti personalizzazioni che impediscono l'accesso all'API per chi non ha effettuato l'accesso. In genere, si tratta di una funzione nel file WordPress functions.php, che attiva una risposta con codice di stato 401.

Se hai una personalizzazione di questo tipo, eliminala o commentala per risolvere l'errore. Per maggiori informazioni su questo errore, consulta le domande frequenti sull'API REST di WooCommerce.

"Impossibile accedere all'API degli ordini, controllare le impostazioni di connessione e riprovare"

Questo errore significa che quando Klaviyo prova a convalidare l'integrazione di WooCommerce e ottenere un conteggio degli ordini, la relativa API non restituisce un valore atteso da Klaviyo oppure non restituisce alcun valore.

Poiché l'integrazione non si è ancora connessa ufficialmente a Klaviyo, significa che deve essere risolto in WooCommerce.

Per ottenere maggiori informazioni su questo errore, devi effettuare una chiamata API all'endpoint del conteggio degli ordini, che fornirà più approfondimenti su cosa viene passato a Klaviyo. Ecco un esempio di richiesta cURL. Per utilizzarla, inserisci l'URL del tuo negozio, la consumer key e la consumer secret:

curl https://STORE_URL/wp-json/wc/v3/orders \
-u CONSUMER_KEY:CONSUMER_SECRET

“Il tuo plugin Klaviyo non è aggiornato”

A volte, il webhook può subire un ritardo nel raggiungere Klaviyo, facendoti visualizzare temporaneamente la pagina delle impostazioni precedente. Il problema dovrebbe risolversi da solo dopo qualche minuto.

Errore 404 durante la connessione a Klaviyo da WordPress

Per risolvere il problema, dovresti verificare di aver abilitato i permalink per il tuo sito WordPress. L’autenticazione di WooCommerce non funzionerà a meno che i permalink non siano abilitati.

1. Vai al tuo sito WordPress e apri Impostazioni > Permalink.
2. In Impostazioni comuni, scegli una struttura del link diversa da Normale.
3. Conferma facendo clic su Salva modifiche.
   

4. Quando hai finito, integra di nuovo con Klaviyo.

Installazione non riuscita - non è stato possibile installare la tua estensione

Potresti visualizzare un errore "Installazione non riuscita" quando provi a installare l’integrazione tramite il marketplace WooCommerce.

Se non riesci a installare correttamente dal marketplace di WooCommerce, puoi anche installare il plugin dall'amministrazione dei plugin di Wordpress.

1. Vai al pannello di amministrazione di WordPress e seleziona Plugin.
2. Seleziona Aggiungi plugin.
3. Cerca Klaviyo in Cerca plugin.
4. Seleziona Installa ora.
5. Seleziona Attiva.
6. Seleziona Marketing nella navigazione a sinistra, poi clicca su Klaviyo.
7. Fai clic su Connetti account per iniziare, quindi procedi a Attivare l’integrazione WooCommerce nell’articolo Primi passi con WooCommerce.
   

Risorse aggiuntive