Prérequis
- Un workspace Webflow avec au moins un site Ecommerce activé (plan Webflow Ecommerce Standard, Plus ou Advanced)
- Le rôle Owner ou Admin dans le workspace Webflow
- Un compte Actero, au minimum sur le plan Free pour tester, Starter ou supérieur pour la production
Connexion (OAuth officiel)
1
Ouvre Intégrations
Intégrations → Plateforme e-commerce → Webflow → Connecter.
2
Choisis ton workspace
Tu es redirigé vers
webflow.com/oauth/authorize. Connecte-toi avec ton compte Webflow et choisis le workspace + le site que tu veux connecter à Actero.3
Autorise les scopes
Webflow affiche les permissions demandées :
sites:read et ecommerce:read. Clique Authorize pour confirmer.4
Retour dans Actero
Tu reviens automatiquement avec le badge Connecté. L’indexation initiale (catalogue + commandes 12 derniers mois) prend de 30 secondes à 5 minutes selon la taille du site.
Scopes demandés
Quelles données circulent
- Commandes : statut, items, total, méthode d’expédition, tracking si renseigné
- Clients : email, nom, adresses, historique d’achat
- Produits : titre, description, variantes, prix, stock, catégorie
Limites côté Webflow
L’API Ecommerce de Webflow est plus jeune que celle de Shopify ou WooCommerce, donc certaines fonctionnalités ne sont pas encore disponibles :Pas de webhook `cart.abandoned`
Pas de webhook `cart.abandoned`
Webflow n’expose pas (encore) les paniers abandonnés via API. Le playbook Panier abandonné d’Actero est donc inactif sur Webflow. Si tu as besoin de relances panier, utilise un outil tiers (par exemple Klaviyo connecté à Webflow) ou migre sur Shopify / WooCommerce.
Données de tracking limitées
Données de tracking limitées
Webflow ne stocke pas nativement le numéro de tracking transporteur. Si tu utilises un plugin tiers de fulfillment (ShipStation, Easyship), Actero peut le récupérer via webhook custom — contacte le support pour activer.
Multi-langue
Multi-langue
Webflow Localization est supporté en lecture, mais l’agent répond dans la langue détectée par la conversation client (pas par la locale produit).
Webhooks
Actero enregistre les webhooks suivants à l’installation, signés HMAC :ecomm_new_order→ indexation commandeecomm_order_changed→ mise à jour statutcollection_item_changed→ réindexation produit (utile pour catalogues qui changent souvent)
Déconnexion
Intégrations → Webflow → Déconnecter révoque le token OAuth, supprime les webhooks et coupe l’accès. Tu peux aussi révoquer Actero depuis Webflow → Workspace Settings → Apps & Integrations.Problèmes fréquents
L'OAuth me renvoie sur la page d'accueil sans message
L'OAuth me renvoie sur la page d'accueil sans message
Vérifie que tu es bien connecté avec un compte qui a le rôle Owner ou Admin sur le workspace. Les rôles
Editor et Designer ne peuvent pas autoriser une app.Aucune commande n'apparaît après connexion
Aucune commande n'apparaît après connexion
Webflow indexe les commandes en asynchrone via webhook. Passe une commande de test depuis ton site et vérifie qu’elle apparaît dans Actero dans la minute. Sinon, va dans Webflow → Site Settings → Apps & Integrations → Webhooks et confirme que les hooks vers
actero.fr sont en statut Delivered.L'agent ne reconnaît pas mes variantes produit
L'agent ne reconnaît pas mes variantes produit
Webflow stocke les variantes en sous-collections. L’indexation peut prendre quelques minutes après l’installation. Lance manuellement une réindexation depuis Intégrations → Webflow → Réindexer si besoin.
FAQ
Webflow CMS (sans Ecommerce) est-il supporté ?
Webflow CMS (sans Ecommerce) est-il supporté ?
Non, pas encore. Webflow CMS pur (sans Ecommerce) n’est pas connectable via cette intégration. Si tu veux que ton agent connaisse le contenu CMS (articles, FAQ), importe-le manuellement dans la base de connaissances ou utilise Notion.
Plusieurs sites Webflow dans un même workspace ?
Plusieurs sites Webflow dans un même workspace ?
L’OAuth te demande de choisir un seul site par connexion Actero. Pour gérer plusieurs sites, plan Entreprise requis (multi-store).