Installer Wavize sur Wix

Wix demande deux configurations : widget et boutique

Le code personnalisé Wix affiche le widget sur le site. La connexion commerce Wix permet à Wavize de lire le catalogue et les commandes via l’API avec URL de base, Site ID au format UUID et clé API. Vous pouvez installer le widget sans connecter Wix Stores, mais les réponses catalogue et suivi ne seront alors pas disponibles.

Wavize détecte si le site utilise le catalogue Wix Stores v1 ou le catalogue v3 et conserve cette version dans la connexion. Le test doit réussir avant d’interpréter une absence de produits comme un problème d’IA.

Secrets distincts
Le jeton public du widget va dans le code personnalisé. La clé API Wix reste uniquement dans le formulaire serveur Wavize et ne doit jamais être collée dans Wix Custom Code.

Publier le widget avec le code personnalisé

Votre offre Wix et votre domaine doivent autoriser l’ajout de code personnalisé.

1. Copier le bloc Wavize

   Dans Assistant > Installation, copiez le script complet lié au domaine Wix public. Ne remplacez pas le jeton par une clé API commerce.

2. Ajouter dans Wix

   Dans le tableau de bord Wix, ouvrez Paramètres > Avancé > Code personnalisé, ajoutez le bloc au corps et choisissez toutes les pages voulues. Publiez le site après enregistrement.

3. Respecter consentement et domaine

   Déclenchez le code selon votre politique cookies et testez l’URL finale. Un domaine Wix gratuit et un domaine personnalisé sont deux hôtes différents pour le contrôle Wavize.

Créer une clé API Wix dédiée

Dans le tableau de bord du compte Wix, ouvrez Paramètres du compte > Clés API puis créez une clé limitée au site et aux permissions nécessaires.

1. Nom et portée

   Nommez-la Wavize et sélectionnez le site concerné. Évitez une clé de compte globale lorsqu’une portée plus restreinte est possible.

2. Permissions lecture commerce

   Accordez la lecture du catalogue/produits et des commandes eCommerce nécessaires. Les libellés Wix peuvent évoluer entre Catalogue v1 et v3 ; recherchez les permissions Business Management / Wix Stores / eCommerce correspondantes.

3. Copie unique et rotation

   Copiez la clé lors de sa création dans un gestionnaire sécurisé. Si elle est perdue ou exposée, créez-en une nouvelle, mettez Wavize à jour, testez puis révoquez l’ancienne.

Retrouver le Site ID exact

Le Site ID n’est ni le nom du site, ni son domaine. Wavize attend un UUID.

• Depuis les outils développeur Wix

  Ouvrez le site dans le dashboard développeur ou la documentation API du compte et copiez l’identifiant du site sélectionné. Il ressemble à xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx.

• Vérifier l’association

  Le Site ID doit appartenir au site autorisé par la clé. Une clé valide d’un autre site peut produire un refus ou un catalogue vide.

• URL de base

  Saisissez le site public en HTTPS dans Wavize. Elle sert à construire les liens produit et à identifier la connexion ; ne collez pas une URL d’éditeur Wix.

Tester la version de catalogue et les commandes

Enregistrez la connexion, cliquez Tester puis Activez-la si le contrôle est valide.

1. Détection v1/v3

   Wavize interroge les API disponibles et mémorise V1_CATALOG ou V3_CATALOG. Ne changez pas manuellement cette valeur : elle dépend du site Wix.

2. Recherche produit

   Testez un produit publié avec nom précis, prix et variante. Un produit masqué ou non disponible peut être absent de la recommandation.

3. Commande et e-mail

   Utilisez une commande de test et son e-mail client. La réponse reste neutre si la référence ou l’e-mail ne correspond pas, même si la commande existe.

Diagnostic Wix rapide

Séparez toujours invisibilité du widget et échec de l’API commerce.

• Widget absent — Contrôler code personnalisé, publication, domaine et consentement.
• Test 401/403 — Contrôler clé, permissions, site autorisé et Site ID.
• Catalogue vide — Contrôler version détectée, produits publiés et portée de la clé.