WordPress · WooCommerce · Shopware

Intégrer askVela à WordPress

Voici comment ajouter le chat en direct et le support IA askVela à ta boutique WordPress ou WooCommerce – avec notre plugin en moins de 2 minutes ou via un snippet de code. Pour Shopware, l'intégration manuelle est plus bas.

Ce qu'il te faut : ta clé de widget

Tu la trouves dans le tableau de bord askVela sous Paramètres → Widget. Elle ressemble à wk_…. Pas encore de compte ? En créer un gratuitement · Se connecter

Recommandé

Méthode 1 : avec notre plugin

Le plugin askVela intègre le widget automatiquement sur toutes les pages de ta boutique – tu n'as qu'à saisir ta clé de widget.

  1. 1
    Télécharger le plugin
    Télécharge le fichier ZIP : askvela-widget.zip (ne pas le décompresser).
  2. 2
    Téléverser dans WordPress
    Dans l'espace d'admin WordPress : Extensions → Ajouter → Téléverser une extension, sélectionne le ZIP et clique sur Installer maintenant.
  3. 3
    Activer le plugin
    Après l'installation, clique sur Activer l'extension.
  4. 4
    Connecter à askVela
    Sous askVela (menu de gauche), clique sur « Connecter à askVela » et confirme dans ton compte askVela – la clé de widget et (pour WooCommerce) la recherche de commande sont configurées automatiquement. Sinon, saisis la clé de widget manuellement.
  5. 5
    Terminé
    Le widget de chat apparaît immédiatement dans ta boutique. Si tu utilises un plugin de cache (WP Rocket, LiteSpeed, W3 Total Cache …), vide le cache une fois.
Sans plugin

Méthode 2 : via un snippet de code

Fonctionne avec n'importe quel thème WordPress. Remplace wk_dein_widget_key par ta vraie clé et ajoute le snippet pour qu'il se charge sur toutes les pages :

<script>
  (function (w, d) {
    w.VelaConfig = {
      appUrl: "https://askvela.pro",
      widgetKey: "wk_dein_widget_key"
    };
    var s = d.createElement("script");
    s.src = w.VelaConfig.appUrl + "/widget.js";
    s.async = true;
    d.head.appendChild(s);
  })(window, document);
</script>
Option A · via un plugin (le plus simple)

Installe un plugin de snippet gratuit comme WPCode ou « Insert Headers and Footers » et ajoute le snippet dans la section Footer.

Option B · dans le thème

Apparence → Éditeur de fichiers du thème → footer.php, ajoute le snippet juste avant </body>. De préférence dans un thème enfant, pour que les mises à jour ne l'écrasent pas.

Boutique

WooCommerce

Dès que le plugin ou le snippet est actif, le widget s'exécute automatiquement sur toutes les pages – y compris les fiches produits, le panier et la caisse. Avec notre plugin, deux choses s'ajoutent automatiquement :

  • Produits – intégrés : La connexion en un clic configure aussi la synchro produits – askVela importe ton catalogue (nom, description, attributs, prix, stock) directement depuis WooCommerce. Tu lances l'import dans le tableau de bord sous Produits. (Sinon, Produits → Scanner lit l'URL publique de la boutique.)
  • Commandes & données clients – intégrées : À partir de la version 1.1 du plugin, celui-ci fournit une recherche de commande sécurisée et signée par HMAC. Le support IA trouve ainsi le statut des commandes et les données clients – sans aucun code de ta part.

Activer la recherche de commande

Le plus simple est via « Connecter à askVela » (voir Méthode 1) – la recherche est alors configurée automatiquement. Manuellement, ça se passe comme ça :

  1. 1
    Récupérer les valeurs dans le plugin
    Dans WordPress, sous askVela (menu de gauche), tu trouves l'URL de recherche et le secret (tous deux générés automatiquement).
  2. 2
    Les saisir dans askVela
    Dans le tableau de bord askVela, sous Paramètres, colle-les dans « URL de recherche de ta boutique » et « Secret de signature », puis enregistre.
  3. 3
    Terminé
    Quand un client demande des nouvelles de sa commande, askVela récupère les données signées depuis ta boutique. Pour des actions comme les annulations (par ex. « annule ma commande »), il y a aussi la doc développeur.
Autre plateforme

Shopware (& autres systèmes)

Pour Shopware, il n'existe pas (encore) de plugin en 1 clic de notre part – mais l'intégration fonctionne tout aussi bien avec le snippet ci-dessus. Deux méthodes fiables :

Google Tag Manager (toute plateforme)

Dans GTM, crée une balise de type HTML personnalisé avec le snippet et déclenche-la sur toutes les pages. Fonctionne pour Shopware, TYPO3, Webflow et bien d'autres.

Shopware 6 · Thème

Dans le thème de la boutique, ajoute le snippet dans Resources/views/storefront/base.html.twig avant la balise fermante </body> (bloc base_body_inner).

Dépannage

Le widget n'apparaît pas ?

  • Clé de widget vérifiée ? Elle doit être reprise exactement depuis le tableau de bord (sans espaces).
  • Vide le cache. Les plugins de cache/optimisation (WP Rocket, LiteSpeed, Cloudflare) affichent souvent encore l'ancienne page – vide le cache une fois.
  • N'intègre qu'une seule fois. Le plugin et le snippet en même temps entraînent un widget en double – n'utilise qu'une seule méthode.
  • Thème & bloqueur de pub. De très rares thèmes n'appellent pas wp_footer ; un bloqueur de pub dans le navigateur peut aussi masquer le widget.

L'apparence, la couleur et le message d'accueil du widget se règlent à tout moment dans le tableau de bord sous Paramètres → Widget.

Pas encore d'espace askVela ?

Prêt en quelques minutes – clé de widget, support IA et chat en direct inclus.

Commencer gratuitement