NouveauAugmentez votre trafic e-commerce avec Parcel ! Comment

API & architectures sur mesure

Votre commerce.
Votre interface.
L’intelligence Parcel.

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.

Un premier échange technique de 15 minutes pour situer votre projet.

Vos sources de référence

CMS · PIM · ERP · catalogue

Flux catalogue · mapping défini ensemble

Parcel

Catalogue structuré · règles métier
Recherche · conseil · comparaison

Requêtes HTTP · réponses JSON ou SSE

Votre expérience e-commerce

Recherche · fiche produit · parcours d’achat

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.

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.

Données, sous-traitants et engagements RGPD

Accès par boutique et secrets protégés

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.

Lire le contrat JSON du connecteur SAV (nouvel onglet)

Un traitement documenté

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.

  1. 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.

  2. 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.

  3. 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.

  4. 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.

Échanger avec l’équipe Parcel