Connecteurs e-commerce
Un connecteur e-commerce relie une plateforme boutique autonome à ShopiMind : il pousse le catalogue, les clients et les commandes, expose les rappels dont ShopiMind a besoin pour agir sur la boutique (bons de réduction nominatifs, création de compte), et injecte le script de tracking qui alimente les paniers et le comportement visiteur.
ShopiMind publie des modules officiels pour PrestaShop, WooCommerce, Shopify, Magento 1 / 2 et Thelia. Si votre plateforme n'en a pas, solution maison, front headless, ERP, SaaS e-commerce, vous pouvez construire le vôtre, avec exactement le même contrat que les modules officiels. Cette section décrit ce contrat de bout en bout.
Connecteur ou intégration ?
Deux objets différents, deux canaux différents. Ne les confondez pas : ils n'ont ni la même authentification, ni le même schéma de signature, ni le même outillage.
| Connecteur e-commerce | Intégration | |
|---|---|---|
| Ce que c'est | Une plateforme e-commerce autonome | Un produit tiers greffé sur un compte existant |
| Exemple | PrestaShop, Odoo, un front headless maison | Hiboutik POS, un CRM, un programme de fidélité |
| Données poussées | Le catalogue complet, clients, produits, catégories, commandes, bons | Un périmètre ciblé + des sources dédiées |
| Rappels entrants | Oui : canal connecteur, signature HMAC sur corps aplati | Oui, canal intégration, signature horodatée |
| Script de tracking | Oui : c'est le connecteur qui l'injecte | Non |
| Outillage | Le SDK ou l'API directement | Le kit @shopimind/integration-kit-js |
| Documentation | Cette section | Intégrations |
Les trois canaux
Un connecteur complet parle à ShopiMind par trois canaux indépendants. Ils sont activables séparément : vous pouvez livrer le premier seul, puis ajouter les autres.
┌─────────────────────┐ ┌──────────────────┐
│ │ ① PUSH, vous appelez ShopiMind │ │
│ Votre boutique │ ─────────────────────────────────► │ │
│ + votre │ POST /v1/customers, /v1/orders… │ │
│ connecteur │ │ ShopiMind │
│ │ ② RAPPELS, ShopiMind vous appelle│ │
│ │ ◄───────────────────────────────── │ │
│ │ POST {url_client}/vouchers… │ │
└─────────────────────┘ │ │
│ │ │
│ ③ TRACKING, le navigateur du client │ │
└───────────────────────────────────────────────►│ │
le tag spm.js └──────────────────┘| Canal | Sens | Ce qu'il apporte | Obligatoire ? |
|---|---|---|---|
| ① Push de données | Connecteur → ShopiMind | Clients, produits, commandes, catégories, bons… C'est la base de tout : sans données, aucun scénario ne peut cibler qui que ce soit. | Oui |
| ② Rappels entrants | ShopiMind → Connecteur | Génération de bons nominatifs depuis un scénario, création de compte et inscription à la newsletter depuis un widget. | Selon les fonctions voulues |
| ③ Tracking front | Navigateur → ShopiMind | Identité visiteur, pages vues, paniers, déclenchement des scénarios et des widgets. | Pour la relance panier et les widgets |
Les paniers passent par le canal ③, pas par le canal ①
GET /v1/carts est en lecture seule : un panier ne se crée pas par l'API de données. Il naît du tracking front (le tag spm.js) ou d'une référence cart_id portée par une commande. Si la relance de panier abandonné fait partie de votre périmètre, le canal ③ n'est pas optionnel. → Script de tracking
La synchronisation : vous poussez vos données
Pour le canal ①, c'est votre connecteur qui décide quand synchroniser et qui pousse vers l'API. Vous gardez la main sur le curseur, la fréquence, la reprise sur erreur et la charge appliquée à votre boutique. Aucune route à exposer : un backfill complet à la première connexion, puis des passes incrémentales à votre rythme (processus long, cron, file de tâches, comme vous voulez).
Ce que vous devez construire
| Brique | Qui l'écrit | Section |
|---|---|---|
| L'appel de connexion (déclare la boutique et vos URLs) | Vous | Connexion |
| Le push des entités vers l'API | Vous | Pousser les données |
Les routes /vouchers, /customers, /subscribe-customer + vérification de signature | Vous | Rappels entrants |
L'injection du tag et l'envoi des paniers, 4 lignes avec le loader spm.js | Vous | Script de tracking |
| Le transport, les relances, le découpage en lots, la signature | ShopiMind, SDK | , |
Par où commencer
- Démarrage rapide : de la clé API au premier client synchronisé.
- Connexion : le contrat de
POST /v1/shop/connection, à faire une fois. - Pousser les données : les entités, l'ordre des dépendances, l'idempotence.
- Script de tracking : paniers et visiteurs, y compris en headless.
- Rappels entrants : bons nominatifs et création de compte.
- Référence : périmètre cible, en-têtes, diagnostic.
Prérequis
- Une boutique ShopiMind et une clé API (Paramètres de la boutique → Accès API).
- L'identifiant de la boutique, affiché sur la même page. Il sert au canal ② et au canal ③.
- Un endpoint HTTPS public si vous implémentez les canaux ② ou ③ côté serveur.
- Le SDK JavaScript : facultatif. L'API REST est le contrat ; appeler les endpoints directement est pleinement supporté, quel que soit votre langage.