Connectez votre catalogue et vos règles de vente à Parcel. Intégrez la recherche et le conseil IA dans votre expérience e-commerce, avec une interface existante ou développée par vos équipes.
Vous gardez la maîtrise du front et du checkout. Les prix, les stocks et les commandes restent gérés par votre système marchand.
01 / Architecture
Le moteur Parcel, dans votre parcours.
Choisissez le niveau de contrôle adapté à votre équipe. La connexion au catalogue et la restitution de l’expérience client sont deux sujets distincts, cadrés séparément.
Avec l’interface Parcel
Intégrer les points de contact existants.
Utilisez les interfaces Parcel pour la recherche, le conseil ou les recommandations. Nous configurons leurs points d’entrée et leur connexion à votre site, selon votre front et votre panier.
Pour déployer les parcours Parcel avec un travail d’intégration front ciblé.
Avec votre propre interface
Consommer les réponses de l’API.
Votre application appelle les routes HTTP et exploite les résultats JSON ou le flux SSE. Vos équipes contrôlent les composants, l’accessibilité, les interactions et l’ajout au panier.
Pour une architecture headless ou une expérience entièrement personnalisée.
02 / Données & responsabilités
Un périmètre de données explicite.
Le catalogue alimente la recherche et le conseil. Les connexions aux commandes et au CRM s’ajoutent uniquement aux parcours qui en ont besoin.
FluxDonnées & périmètreQui fait quoi
Catalogue
Socle de l’intégration
Données et périmètre : Produits, identifiants de variantes, prix, disponibilités, visuels, URL et attributs utiles au conseil.
Qui fait quoiVous exposez la source de référence. Nous définissons le mapping, le flux d’import et sa fréquence de mise à jour avec votre équipe.
Expérience client
Selon les parcours activés
Données et périmètre : Requête ou message, identifiant de session et contexte utile : page consultée, produits sélectionnés ou besoin exprimé.
Qui fait quoiParcel renvoie les résultats. Votre interface pilote leur affichage et les interactions avec votre panier.
Commandes & SAV
Connexion optionnelle
Données et périmètre : Recherche d’une commande par sa référence exacte et l’e-mail ou le téléphone de l’achat. Retour limité à la commande identifiée.
Qui fait quoiVotre service HTTPS vérifie la signature et l’identité de la boutique. L’accès reste en lecture : les modifications de commande passent par vos processus.
Relais vers vos équipes
Connexion optionnelle
Données et périmètre : Événements de conversation et demandes nécessitant un conseiller, transmis au CRM ou au webhook retenu.
Qui fait quoiNous cadrons le destinataire et les événements utiles. Pour un webhook personnalisé, votre service gère les doublons par event_id.
03 / Contrat d’intégration
HTTP, JSON. Des échanges lisibles.
Les routes sont versionnées sous /api/v1. La recherche, l’autocomplétion et le conseil conversationnel peuvent être intégrés séparément selon votre parcours.
Exemple · réponse JSON
curl --request POST "$PARCEL_API_URL/api/v1/chat-json" \
--header 'Content-Type: application/json' \
--data '{
"shop_id": "votre-boutique.example",
"public_key": "VOTRE_CLE_PUBLIQUE",
"session_id": "session-demo-001",
"message": "Je cherche des chaussures pour débuter le trail"
}'
Renseignez l’URL d’API communiquée lors de l’intégration dans PARCEL_API_URL, puis l’identifiant de votre boutique et sa clé publique.
Les points d’entrée de votre expérience
GET/api/v1/public/search
Recherche, filtres, facettes et pagination.
GET/api/v1/public/autocomplete
Suggestions pendant la saisie.
POST/api/v1/chat-json
Conseil conversationnel, réponse JSON.
POST/api/v1/chat
Même moteur, réponse progressive en SSE.
Les accès visiteurs utilisent une clé publique rattachée à la boutique. Les secrets des connecteurs restent côté serveur ; l’administration utilise des accès authentifiés distincts.
04 / Sécurité & gouvernance
Des accès séparés. Des flux maîtrisés.
Le périmètre technique et les engagements de traitement des données se définissent avec vos équipes IT et, si nécessaire, votre DPO.
La clé publique est vérifiée pour la boutique appelée. Les identifiants des connecteurs sont chiffrés en base et liés à la boutique ainsi qu’à leur destination.
Des requêtes signées pour le SAV
Les requêtes vers votre service passent en HTTPS avec une signature HMAC-SHA256 et un horodatage. Votre endpoint contrôle la signature, une fenêtre de validité de 300 secondes et l’identifiant de boutique avant tout accès aux données.
Les rôles, les sous-traitants, l’hébergement, les durées de conservation et les traitements liés à l’IA sont détaillés dans nos engagements RGPD. Un accord de sous-traitance peut être signé avec le marchand.
05 / Mise en production
Une intégration qui se valide avant de s’ouvrir.
Nous préparons la recette technique et métier avec votre équipe. La qualité du catalogue, la cohérence des recommandations et le comportement du front sont vérifiés sur le périmètre retenu.
01
Cadrage
Architecture, sources de données, parcours à activer, volumétrie et responsabilités. Le périmètre d’intégration est défini avant le développement.
02
Connexion
Mapping du catalogue, configuration des accès et premier import. Votre équipe dispose des paramètres et des contrats d’échange nécessaires au périmètre retenu.
03
Recette
Validation des variantes, des prix, des stocks et des règles métier. Test des réponses, des quotas, des erreurs et du comportement de repli de votre interface.
04
Mise en production
Activation sur le périmètre validé, suivi des usages et ajustements. Les budgets de latence, la cadence de synchronisation et les conditions de support sont convenus ensemble.
Les points à valider avant le go-live
Une base de recette partagée, à adapter à votre architecture et à vos usages.
Variantes, prix et disponibilités conformes à la source
Clés publiques et secrets correctement séparés
Délais d’attente, quotas et replis du front testés
Événements de suivi et reprise par un conseiller vérifiés
Parlons de votre stack
Partons de votre architecture réelle.
Votre CMS ou front, la source de votre catalogue et les parcours à activer : trois éléments pour préparer un échange utile avec votre équipe technique.