Analyse des erreurs d'interface des interfaces CleverReach

Nous développons continuellement des plugins et des interfaces pour connecter un système externe (par exemple CRM, CMS ou systèmes de boutique) et notre outil de marketing par courriel CleverReach. Nos plugins vous permettent d'établir rapidement une connexion entre les deux systèmes en quelques étapes et de démarrer votre marketing par e-mail. Nos plugins sont tous gratuits (sauf pour PrestaShop) et mis à jour régulièrement.

Nous commençons ce billet par une liste de contrôle des critères les plus importants pour vous, puis nous énumérons les messages d'erreur les plus courants et répondons aux questions les plus fréquemment posées. Si notre liste ne résout pas votre problème, ou si vous avez d'autres problèmes ou questions, nous vous donnons une liste de notes et de coordonnées à la fin de l'article.

Liste de contrôle

1. Utilisez-vous la dernière version du plugin ?

Vous pouvez toujours trouver la dernière version du plugin directement dans votre gestionnaire de plugin en recherchant "CleverReach".

2. Le plugin est-il connecté et activé ?

Assurez-vous que le plugin est correctement connecté à votre compte. Naviguez jusqu'au plugin dans votre gestionnaire de plugins. Si vous recevez une note indiquant que vous devez connecter le plugin à votre compte, c'est qu'il n'est pas encore connecté. Établir une connexion avec le plugin. Vérifiez également si le plugin est activé dans votre gestionnaire de plugins.  

3. Données du compte

Avez-vous saisi toutes les données de votre compte via l'icône de profil >[Mon compte -> Paramètres -> Mes données]? 

Vous ne pouvez établir une connexion réussie qu'après avoir saisi toutes vos données.

4. Accès à l'API pour l'utilisateur

Avez-vous activé l'accès "REST API" pour l'utilisateur qui se connecte à CleverReach via le plugin ? Vous trouverez les instructions ici.

5. Restrictions d'accès

Le magasin doit être directement accessible via l'internet. Il ne doit pas y avoir de HTACCESS actif qui limite l'accès au magasin ou au plugin.

Assurez-vous que tous les fichiers du plugin disposent des autorisations générales nécessaires pour que le plugin puisse envoyer et recevoir des données. 

6. Exigences techniques

Le magasin ou le serveur doit être en mesure de traiter et d'exécuter CURL. 

Le navigateur avec lequel vous essayez de vous connecter doit être la dernière version de Chrome ou de Firefox. 

Messages d'erreur courants

"Bad Request : maximum attribute count exceeded (Mauvaise demande : le nombre maximum d'attributs a été dépassé) :

Vous avez créé trop de champs de données dans votre compte CleverReach. Vous pouvez créer un maximum de 45 champs de données. Le plugin crée automatiquement 17 champs de données lors de la synchronisation initiale, par exemple le nom et le prénom, les détails de l'adresse, etc.

Supprimez les champs de données de votre compte CleverReach qui ne sont pas remplis ou qui ne sont plus nécessaires. Le message d'erreur devrait avoir disparu après cela.

"(InitialSyncTask) failed due to extended inactivity period" :

La synchronisation prend plus de temps que prévu. Par exemple, il peut être utile d'augmenter le délai d'attente dans le magasin.

1. Ajustez la configuration de PHP (fichier php.ini) sur le serveur de la boutique.
   1. Fixez la variable max_execution_time à 300 (5 minutes),
   2. puis fixer la variable PHP max_input_vars à 10000
   3. et recommencer l'importation initiale

"Impossible de déterminer l'URL correcte. La boutique n'est pas configurée correctement ou le plugin n'est pas actif".

Ce message d'erreur signifie que l'URL de la boutique et l'URL de la configuration de la boutique ne sont pas identiques.

Allez dans les paramètres de votre boutique et comparez l'URL de la boutique à celle qui apparaît dans la barre d'adresse de votre navigateur. Les URL doivent être les mêmes.  

Si elles ne sont pas identiques, veuillez vous connecter à partir de l'URL fournie dans la configuration du magasin.

Questions fréquemment posées

Question : Tous mes destinataires ne sont pas transférés. Que puis-je faire ?

Réponse : Cela dépend de la version du plugin. La dernière version de nos plugins transfère tous vos destinataires en tant que destinataires actifs, s'ils sont abonnés à la newsletter dans votre système, y compris Double Opt in.

Tous les autres destinataires - acheteurs, etc. - sont également transférés à CleverReach en tant que destinataires actifs lorsque vous utilisez nos plugins v3.

Question : Nous avons d'énormes problèmes de performance lorsque nous utilisons le plugin CleverReach Shopware. Les performances du magasin sont extrêmement lentes. Pourquoi ?

Réponse : La raison la plus probable pour laquelle votre boutique fonctionne plus lentement que d'habitude peut être due à la vérification asynchrone de notre plugin. Toutes les 5 secondes, le système vérifie si de nouvelles données de destinataires, commandes, étiquettes, etc. doivent être transférées.

De cette manière, nous assurons la synchronisation en direct dans notre plugin. Par exemple, si vous utilisez notre automatisation du marketing et que vous souhaitez déclencher une automatisation après qu'un client se soit inscrit ou ait acheté quelque chose, la synchronisation en direct est très importante pour l'envoi immédiat d'un e-mail.

Le plugin CleverReach effectue la plupart des tâches en arrière-plan. Afin de détecter et de lancer les tâches en arrière-plan, le plugin CleverReach simule des processus de longue durée (en arrière-plan) en appelant de manière asynchrone des "demandes web de travailleur en arrière-plan" avec un délai minimum de 5 secondes entre deux appels consécutifs.

Cela signifie que le plugin s'envoie à lui-même les requêtes web (c'est-à-dire l'URL du frontend) toutes les 5 secondes. Si vous le souhaitez, nous pouvons également augmenter cette période à n'importe quel intervalle de temps, mais cela signifierait que les changements dans le magasin ont besoin d'un certain temps (intervalle de temps que le client souhaite définir) pour être transférés à CleverReach.

L'intervalle de temps de 5 secondes est la valeur par défaut pour tous nos clients (puisque nous voulons transférer les données à CleverReach dès qu'elles apparaissent dans le magasin). Si vous souhaitez personnaliser la période ou si nous pouvons le faire pour vous, n'hésitez pas à nous envoyer un e-mail ou à soumettre une demande avec toutes les informations décrites ci-dessous. Nous vous remercions d'avance.

Question : La connexion entre le plugin et CleverReach ne fonctionne pas.

Réponse possible : Si vous utilisez une autorisation supplémentaire (htaccess) sur votre serveur, il est nécessaire de rendre l'URL du plugin CleverReach accessible au public. Les URL suivantes doivent être accessibles depuis l'Internet lorsque vous utilisez Shopware 5 par exemple :

{shop_url}/CleverReachAsyncProcess/run

{shop_url}/CleverReachAuth/redirectCallback

{shop_url}/CleverReachAutomationEventsController/handle

{shop_url}/CleverReachBlogSearch/search

{shop_url}/CleverReachFormEventsController/webhookHandle

{shop_url}/CleverReachForms/form

{shop_url}/CleverReachProductSearch/search

{shop_url}/CleverReachReceiverEventsController/webhookHandle

{shop_url}/CleverReachSearch/recherche de produits

{shop_url}/CleverReachWebhooks/processWebhookRequest

Pour chaque intégration, les URL sont différents. Si vous utilisez une intégration différente, veuillez nous contacter comme indiqué ci-dessous afin que nous puissions vous envoyer les URL appropriés. Je vous remercie d'avance.

Question : L'autoconfiguration a échoué.

Réponse : L'autoconfiguration est effectuée lorsque le module est ouvert pour la première fois (après l'installation). Il vérifie les configurations existantes de la boutique et tente d'effectuer un appel interne pour définir correctement les paramètres du plugin ou de la boutique.

Ce processus permet de déterminer la configuration optimale du plugin et d'en assurer l'utilisation ultérieure.

Ces configurations sont ensuite sauvegardées et utilisées pour tous les appels de processus asynchrones du plugin.

Si le système détecte un problème au niveau des processus d'arrière-plan et de l'exécution des tâches, il doit prendre les paramètres URL par défaut du magasin et essayer d'exécuter l'appel de test asynchrone avec la configuration par défaut du système. Si l'appel échoue, le système doit répéter le test avec toutes les combinaisons des options suivantes :

1. Changez le protocole d'appel de HTTP à HTTPS et vice versa, en fonction du protocole utilisé par défaut.
2. Augmenter le délai d'attente d'un appel asynchrone, car certains systèmes n'acceptent pas un délai d'attente cURL inférieur à une seconde.
3. Définir/réinitialiser l'option de suivre les redirections 301/302.
4. Utiliser les options de résolution IPv4 ou IPv6.
5. Lorsque toutes les options ont été exécutées et sauvegardées avec succès, vous êtes redirigé vers la sélection du destinataire de l'importation.

Si le plugin ou vous-même ne parvenez pas à modifier les paramètres de la boutique, veuillez contacter notre équipe de service. Merci d'avance.

Vous continuez à recevoir des messages d'erreur ou des messages différents de ceux figurant dans notre liste ? Vous souhaitez contacter notre équipe de service ?

Pour mieux analyser votre cas, veuillez nous envoyer une description détaillée de l'erreur. Vous pouvez également nous envoyer des captures d'écran qui visualisent l'erreur.

Pour une analyse détaillée, veuillez également nous envoyer l'URL de votre backend ainsi qu'un nom d'utilisateur et un mot de passe. En outre, nous avons besoin des données d'accès FTP de votre serveur pour pouvoir effectuer l'analyse rapidement et avec succès.

Avant d'accéder au logiciel externe, nous vous demandons de confirmer la clause de non-responsabilité ci-dessous. Pour ce faire, un courriel de l'administrateur du compte CleverReach ou du titulaire du compte suffit :

Je reconnais par la présente les informations suivantes :

"Je reconnais que CleverReach® ne doit qu'une assistance par email selon les CGV. L'accès à mon système est un service volontaire qui va au-delà du contrat. Ce processus est une relation de courtoisie au sens étroit du terme, pour laquelle CleverReach n'assume aucune responsabilité.pour laquelle CleverReach n'assume aucune responsabilité".

Envoyez un courriel avec tous les détails à support@cleverreach.com. Notre service se fera un plaisir de vous aider au mieux. Merci d'avance.