← Retour au tableau de bord
V
venlio

Guide d'onboarding & intégration

Bienvenue sur Venlio ! Suivez ces 3 étapes incontournables dans l'ordre pour rendre votre assistant IA opérationnel et commencer à booster vos conversions.

1

Renseignez vos produits (Catalogue)

Pour pouvoir conseiller efficacement vos clients et conclure des ventes, notre IA a besoin de connaître vos produits sur le bout des doigts. Plus votre catalogue est complet, plus les réponses de l'IA seront précises et persuasives !

Deux méthodes s'offrent à vous :

Format CSV attendu :

Votre fichier doit contenir précisément ces colonnes (avec séparateur virgule ou point-virgule) :

Colonne Type Description / Exemple
nom Texte (Requis) Nom complet du produit (ex: Café Sidamo Éthiopie)
prix Nombre (Requis) Prix unitaire sans devise (ex: 14.90)
devise Texte (Requis) Symbole ou code de la devise (ex: € ou EUR)
stock Nombre (Requis) Quantité en stock (ex: 45)
description Texte (Optionnel) Description marketing. Plus elle est riche, plus l'IA saura conseiller.
url URL (Optionnel) Lien direct vers la fiche produit pour rediriger le visiteur (ex: https://maboutique.com/products/cafe-sidamo).
image URL (Optionnel) Lien direct vers l'image du produit, affichée dans la fiche cliquable du chat.
MODÈLE CSV — copiez, remplacez par vos produits, importez 
nom,description,prix,devise,stock,url,image
Café Sidamo Éthiopie,Café d'altitude aux notes florales et fruitées. Torréfaction artisanale.,14.90,EUR,45,https://maboutique.com/products/cafe-sidamo,https://maboutique.com/img/sidamo.jpg
Théière en fonte 1L,Théière traditionnelle japonaise qui conserve la chaleur longtemps.,39.00,EUR,12,https://maboutique.com/products/theiere-fonte,https://maboutique.com/img/theiere.jpg
Coffret découverte 3 thés,Notre best-seller pour offrir : 3 thés d'exception dans un écrin.,29.50,EUR,30,https://maboutique.com/products/coffret-decouverte,https://maboutique.com/img/coffret.jpg
📦 Vous êtes sur Shopify ? Le plus rapide est le bouton « Synchroniser depuis Shopify » (onglet Configuration ➔ Catalogue) : collez l'adresse de votre boutique, et Venlio remplit votre catalogue tout seul. Aucun CSV nécessaire.
  • Vous préférez un CSV ? Shopify : Admin ➔ Produits ➔ bouton Exporter ➔ CSV, puis adaptez les en-têtes au modèle ci-dessus.
  • WooCommerce : Produits ➔ Exporter ➔ choisissez les colonnes nom, prix, stock, puis adaptez l'en-tête au modèle Venlio.
💡 Pourquoi cette étape est capitale ? L'IA utilise directement ces données pour répondre aux questions sur la disponibilité, le prix et les caractéristiques des produits. S'ils ne sont pas renseignés, l'IA ne pourra pas rediriger les visiteurs vers vos fiches produits pour finaliser l'achat.

Pour des réponses vraiment expertes : 3 champs à remplir

Le catalogue suffit pour démarrer, mais ces 3 champs (onglet Configuration) transforment l'IA en véritable vendeur expert de VOTRE marque. Voici des modèles à adapter.

1. FAQ — les questions que vos clients posent souvent

Chaque entrée = une question + sa réponse. Exemples :

Q : La livraison est-elle gratuite ?
R : Oui, dès 59 € d'achat en France. En dessous, comptez 4,90 € à domicile.

Q : Sous combien de temps je reçois ma commande ?
R : Préparation sous 48h, puis livraison en 2 à 3 jours ouvrés.

Q : Puis-je retourner un article ?
R : Oui, sous 14 jours, article non utilisé, dans son emballage d'origine.

2. Politiques — livraison, retours, paiement, contact

Renseignez vos vraies conditions. L'IA s'appuie dessus et n'invente jamais un délai ou un tarif. Exemple pour le champ « Livraison » :

Livraison offerte dès 59 € en France (sinon 4,90 € à domicile,
3,90 € en point relais). Préparation sous 48h, livraison 2-3 jours.
Livraison Belgique et Europe disponible (3 à 5 jours).

3. Base de connaissances — l'expertise de votre marque ✨

C'est le champ qui fait la différence : dites à l'IA comment conseiller selon le besoin du client. Exemple :

IDENTITÉ : marque artisanale, torréfaction française, produits naturels.

CONSEIL SELON LE BESOIN :
- Client débutant / veut découvrir → propose le Coffret découverte 3 thés.
- Cherche un cadeau → oriente vers un coffret, puis propose la théière en complément.
- Amateur exigeant → recommande le Café Sidamo Éthiopie (notre haut de gamme).

MÉTHODE : après avoir recommandé un produit, propose toujours
naturellement un produit complémentaire (ex : théière avec un thé).
2

Installez le widget sur votre boutique

Copiez le code d'intégration Venlio ci-dessous et insérez-le sur votre boutique pour que la bulle de chat apparaisse instantanément en bas à droite de votre site.

S Shopify

  1. Connectez-vous à votre administration Shopify (l'adresse qui finit par .myshopify.com/admin).
  2. Dans le menu de gauche : Boutique en ligne ➔ Thèmes.
  3. Sur votre thème actif, cliquez sur le bouton « … » (trois petits points) ➔ Modifier le code.
  4. Dans la colonne de gauche, dossier Layout, ouvrez le fichier theme.liquid.
  5. Tout en bas du fichier, repérez la ligne </body> et collez le snippet Venlio juste au-dessus de cette ligne.
  6. Cliquez sur Enregistrer (en haut à droite). C'est tout ✅

W WooCommerce

  1. Dans votre tableau de bord WordPress, allez dans Extensions ➔ Ajouter une extension.
  2. Cherchez et installez l'extension gratuite « WPCode – Insert Headers and Footers ».
  3. Cliquez sur Activer.
  4. Menu WordPress : Code Snippets ➔ Header & Footer.
  5. Collez le snippet Venlio dans la zone Footer (pied de page).
  6. Cliquez sur Save Changes. C'est tout ✅
✅ Domaine autorisé automatiquement : au tout premier chargement du widget sur votre boutique, votre domaine (et sa version www) est détecté et autorisé automatiquement — le chat fonctionne sans configuration.

Vous pouvez vérifier ou ajuster la liste à tout moment dans Configuration ➔ Domaines autorisés (utile si vous changez de nom de domaine ou utilisez plusieurs sites). Le format avec ou sans https:// fonctionne.

Votre code d'intégration universel

Ce snippet est unique et contient vos paramètres de connexion personnalisés.

HTML SNIPPET 
<!-- Widget Venlio IA (Support & Ventes E-commerce) -->
<script
  src="https://www.getvenlio.com/widget.js"
  data-boutique-id="VOTRE_BOUTIQUE_ID"
  data-api-url="https://www.getvenlio.com"
  defer></script>
3

Vérifiez et testez votre installation

Une fois le snippet installé sur votre site, lancez le diagnostic automatique ci-dessous pour confirmer que Venlio communique correctement avec votre serveur.

🔍

Outil de diagnostic en direct

Cet outil interroge le serveur Venlio pour s'assurer que le widget a bien été inséré et validé.

En attente de diagnostic...
🎉 Dernière étape : Une fois le diagnostic validé, rendez-vous sur votre boutique et lancez une discussion de test avec le widget (envoyez un premier message !). Cela terminera à 100% votre checklist d'onboarding sur votre tableau de bord et débloquera l'affichage complet !
+

Suivi de commande Shopify (optionnel)

Activez cette option pour que Venlio réponde aux questions « Où est ma commande ? » en vérifiant le statut directement dans votre Shopify. Il vous faut un jeton d'accès API Admin avec la permission read_orders. Comptez 2 minutes.

⚠️ Le bon endroit, c'est l'admin de VOTRE boutique (.myshopify.com/admin) — pas le « dev dashboard » des développeurs. Repère simple : si on vous demande une « App URL » ou une « Redirect URL », vous êtes au mauvais endroit. Le bon écran ne demande que des permissions (scopes) et un bouton pour révéler le jeton.

Créer le jeton, étape par étape

  1. Dans l'admin de votre boutique : Paramètres ➔ Applications et canaux de vente.
  2. Cliquez sur « Développer des applications » (puis, si demandé, autorisez le développement d'applications personnalisées).
  3. Créer une application ➔ nommez-la Venlio.
  4. Onglet Configuration ➔ « Configure Admin API scopes ». Cherchez et cochez read_orders, puis Enregistrer.
  5. Cliquez sur « Installer l'application » (en haut à droite) et confirmez.
  6. Onglet API credentials ➔ section Admin API access token ➔ « Révéler le jeton ». Copiez le code qui commence par shpat_….
🔒 Important : ce jeton ne s'affiche qu'une seule fois — copiez-le tout de suite. C'est un identifiant secret : ne le partagez avec personne et collez-le uniquement dans Venlio.

Brancher le jeton dans Venlio

  1. Dans votre tableau de bord Venlio : Configuration ➔ section Suivi de commande.
  2. Domaine : votre adresse Shopify (ex : maboutique.myshopify.com).
  3. Token : collez votre shpat_….
  4. Cliquez sur Tester : un ✅ confirme que tout est connecté.
+

Mise à jour automatique du catalogue (optionnel)

La synchronisation Shopify (étape 1) importe vos produits à la demande. Pour aller plus loin, branchez un webhook : dès que vous modifiez un produit (prix, stock, description) dans Shopify ou WooCommerce, Venlio est mis à jour en temps réel, sans rien refaire.

🔑 Comment ça marche : votre boutique « prévient » Venlio à chaque changement de produit. Pour sécuriser ces messages, on utilise un secret de webhook (HMAC) partagé entre votre boutique et Venlio — le champ se trouve dans Configuration ➔ Sécurité des Webhooks.

S Shopify

1. Admin Shopify ➔ Settings (Paramètres) ➔ Notifications ➔ descendez tout en bas jusqu'à Webhooks ➔ bouton Create webhook. La fenêtre « Add webhook » s'ouvre.

2. Remplissez les 4 champs exactement comme ceci :

  • Event (Événement) → choisissez Product update  ⚠️ par défaut Shopify met « Cart creation » — changez-le !
  • Format → JSON
  • URL → collez l'adresse ci-dessous (bouton « Copier l'URL »)
  • Webhook API version → une version datée (ex : 2026-04)  ⚠️ par défaut c'est « unstable » — ne le laissez pas !
👉 URL À COLLER DANS LE CHAMP « URL » 
…

3. Cliquez sur Save.

🔑 4. Le secret (à ne pas oublier — sinon Venlio refuse les mises à jour) : revenez sur la page Notifications, tout en bas se trouve la phrase « Your webhooks will be signed with… » suivie d'un code. Copiez ce code, puis dans Venlio : Configuration ➔ Sécurité des Webhooks ➔ collez-le dans Secret de Webhook (HMAC) ➔ Enregistrez.

💡 Astuce : refaites un 2ᵉ webhook identique avec Event = Product creation, pour que vos nouveaux produits arrivent aussi automatiquement.

W WooCommerce

Adresse à coller dans WooCommerce :

URL DU WEBHOOK — WOOCOMMERCE 
…
  1. Admin WordPress ➔ WooCommerce ➔ Réglages ➔ onglet Avancé ➔ Webhooks ➔ Ajouter un webhook.
  2. Statut : Actif — Sujet : Produit mis à jour — URL de distribution : collez l'adresse ci-dessus.
  3. Secret : choisissez un mot de passe (ex : mon-secret-venlio-123) et notez-le.
  4. Dans Venlio : Configuration ➔ Sécurité des Webhooks ➔ collez exactement le même secret dans Secret de Webhook (HMAC) ➔ Enregistrez.
💡 Différence clé sur le secret : sur Shopify, c'est Shopify qui génère le secret — vous le copiez vers Venlio. Sur WooCommerce, c'est vous qui le choisissez — mettez la même valeur des deux côtés.