Risoluzione dei problemi di integrazione con Magento 2

Cosa imparerai

Scopri come risolvere i problemi della configurazione OAuth di Magento 2 seguendo i passaggi per la risoluzione dei problemi descritti di seguito. Se riscontri ancora problemi dopo aver seguito questi passaggi, contattaci nella nostra Community o contatta il nostro team di assistenza.

Prima di iniziare

Se non l'hai ancora fatto, leggi la nostra guida su Primi passi con Magento 2 per le istruzioni passo passo per configurare la tua integrazione Magento 2.

Klaviyo utilizza il protocollo OAuth per generare un token di accesso e recuperare i dati dal tuo store Magento 2. Se hai personalizzato l’installazione di Magento 2, la procedura OAuth di Klaviyo potrebbe non andare a buon fine. Questo articolo ti guiderà attraverso una serie di passaggi per la risoluzione dei problemi per identificare dove si verifica il problema.

Passaggi generali per la risoluzione dei problemi

Assicurati che il tuo sito sia accessibile pubblicamente con un certificato SSL valido

La procedura OAuth di Klaviyo richiede che il tuo sito web sia accessibile pubblicamente; in caso contrario, le chiamate API necessarie per generare i token di accesso non andranno a buon fine.

1. Assicurati di non aver protetto il tuo negozio con password o di non averne limitato l’accesso tramite IP.
2. Assicurati che il tuo negozio sia accessibile tramite HTTPS con un certificato SSL valido. Puoi testare il tuo certificato qui.

Assicurati che il firewall non stia bloccando le richieste di Klaviyo

Tutto il traffico in uscita delle integrazioni Klaviyo passa attraverso un set di indirizzi IP statici e prevedibili, così puoi avere un elevato livello di certezza che questo traffico provenga da Klaviyo. Leggi il nostro articolo per scoprire come aggiungere gli indirizzi IP del traffico delle integrazioni Klaviyo alla lista consentita.

Controlla le versioni di Magento 2 e dell'estensione Klaviyo

1. Se utilizzi Magento v2.2.0, devi abilitare manualmente OAuth.
2. Assicurati di aver installato l'estensione Klaviyo corretta (potresti dover eseguire l'upgrade).

Assicurati che gli endpoint OAuth siano accessibili

Potresti avere regole di riscrittura in più o mancanti, che possono rendere inaccessibili gli endpoint OAuth predefiniti di Magento 2. Klaviyo deve accedere a questi endpoint per generare le credenziali necessarie per il processo di autorizzazione.

Assicurati che gli URL di seguito siano accessibili per il tuo negozio:

https://[Store URL]/oauth/token/request

https://[Store URL]/oauth/token/access

1. Puoi verificare che siano accessibili effettuando una richiesta POST come questa:

curl --location --url 'https://[Store URL]/oauth/token/request' --request 'POST' -v

curl --location --url 'https://[Store URL]/oauth/token/access' --request 'POST' -v

1. Dovresti aspettarti una risposta simile alla seguente. È normale visualizzare un errore quando effettui una richiesta in questo modo, e questo conferma che gli endpoint rispondono correttamente.
   

2. Se non ricevi una risposta relativa a OAuth, dovresti verificare che non ci siano reindirizzamenti, regole di riscrittura non valide o errori interni del server che impediscono l’accesso a questi URL.

Questo può essere causato da un sottopercorso del negozio nel tuo URL. Verifica un problema di sottopercorso del negozio accedendo agli endpoint a:

https://[Store URL]/[Store Path]/oauth/token/request

https://[Store URL]/[Store Path]/oauth/token/access

Se questi endpoint si risolvono, includi le seguenti regole di riscrittura nel tuo .htaccess file per risolvere il problema.

RewriteEngine on
RewriteRule /oauth/token/request$ https://%{HTTP_HOST}/[Store Path]/oauth/token/request [L,R=301]
RewriteRule /oauth/token/access$ https://%{HTTP_HOST}/[Store Path]/oauth/token/access [L,R=301]

Elimina l'integrazione e ricreala

Se hai apportato modifiche dopo un precedente tentativo di integrazione non riuscito, è una buona idea eliminare l'integrazione OAuth originale. Le chiavi utilizzate potrebbero non essere valide e dovranno essere rigenerate.

1. In Magento, vai a Systems
2. Select integrazioni
3. Individua il record dell'integrazione Klaviyo ed eliminalo

Una volta eliminato il record di integrazione, segui i passaggi nella nostra guida come integrare con Magento 2 per creare un nuovo record di integrazione e riprova.

Problemi specifici della versione di Magento

Errore specifico di Magento 2.4.2

Se utilizzi Magento 2.4.2, esiste un problema noto per cui le attivazioni OAuth non vanno a buon fine. Quando attivi l’integrazione, potresti visualizzare un messaggio di errore simile a quello mostrato di seguito. Anche se non ricevi l’errore, l’attivazione OAuth potrebbe non essere andata a buon fine. Normalmente, l’errore si trova nei log di Magento.

Per risolvere questo errore, dovrai:

• Esegui l’upgrade a Magento 2.4.3. Consulta la documentazione di Magento 2 per eseguire l’upgrade della tua versione.
• Applica una patch come descritto nel repository github di Klaviyo per Magento 2.

Errore di autenticazione specifico di Magento 2.4.6

Stai usando Magento 2.4.6 e riscontri un errore di autenticazione 401 dopo l’integrazione con Klaviyo? Questo potrebbe essere dovuto a un bug noto di Magento che interessa la versione 2.4.6 di Magento. Per risolvere, devi abilitare l’autenticazione tramite bearer token, così Klaviyo può effettuare richieste utilizzandola (invece di OAuth 1.0). Per abilitare l'autenticazione con token bearer:

1. Nell'area di amministrazione di Magento, vai a Stores > Configuration > Services > OAuth > Consumer Settings.
2. Per l’impostazione Consenti l’utilizzo dei token di accesso OAuth come token bearer autonomi, seleziona Sì.
3. Clicca su Save Config.
   

Dopo aver effettuato questo aggiornamento, i precedenti errori di autenticazione dovrebbero risolversi e le sincronizzazioni delle integrazioni riprenderanno.

Risorse aggiuntive