Multi-Channel Selling

Configurer un flux produit ChatGPT : champs et formats

Configurez un flux produit ChatGPT en 7 étapes : 9 champs obligatoires, formats acceptés, SFTP, variantes, mises à jour et erreurs à éviter.

Photo de profil de Long Nguyen

Long Nguyen

Développeur fullstack · Ingénieur IA · Chercheur

• • 5 min de lecture •

Qu’est-ce qu’un flux produit ChatGPT et qui peut en envoyer un ?

Un flux produit ChatGPT est un fichier de catalogue structuré que vous envoyez à OpenAI afin que ChatGPT puisse lire vos produits, leurs prix et leur disponibilité. La transmission se fait en push : vous envoyez les fichiers selon un calendrier, au lieu d’attendre qu’ils soient explorés. La qualité de ce fichier conditionne tout le reste.

La première étape consiste à obtenir l’accès. Au , le guide Get Started d’OpenAI indique que l’intégration des flux produits est réservée aux partenaires approuvés. Les demandes passent par le formulaire marchand sur chatgpt.com/merchants. Faites d’abord votre demande, puis profitez du délai d’attente pour nettoyer vos données : la plupart des tâches de préparation concernent l’hygiène du catalogue, indispensable quel que soit le flux.

Deux modes de transmission sont proposés : l’envoi de fichiers et une API. OpenAI recommande généralement d’envoyer l’intégralité du flux une fois par jour par fichier, puis de transmettre les mises à jour au fil de la journée via l’API. Les petits flux peuvent être gérés entièrement par l’API, et les données promotionnelles ne peuvent être envoyées que par ce biais. Ce guide porte sur l’envoi de fichiers, vérifié à partir de la présentation de l’envoi de fichiers d’OpenAI.

Configurer un flux produit ChatGPT en 7 étapes

  1. Demandez l’accès via le formulaire marchand d’OpenAI et confirmez vos modalités de transmission (emplacement SFTP et, si vous les utilisez, options Ads Manager ou API) pendant l’intégration.
  2. Choisissez le mode de transmission : envoi de fichiers, API ou les deux. OpenAI recommande un instantané quotidien complet complété par des mises à jour intrajournalières via l’API.
  3. Associez votre catalogue aux neuf champs obligatoires (voir la section suivante). Prévoyez une ligne par article ou variante achetable.
  4. Exportez dans un format pris en charge : Parquet est privilégié, tandis que jsonl.gz, csv.gz et tsv.gz sont également acceptés. Encodez toutes les données en UTF-8.
  5. Envoyez un échantillon d’environ 100 articles contenant tous les champs obligatoires, puis consultez les résultats de l’envoi avant de passer à l’échelle.
  6. Contrôlez le premier instantané complet, et pas seulement l’échantillon. Les tests limités à un échantillon masquent les problèmes qui apparaissent à l’échelle du catalogue, comme les identifiants en double ou les variantes inhabituelles.
  7. Automatisez l’instantané quotidien en écrasant le même nom de fichier à chaque envoi.

Les neuf champs obligatoires d’un flux produit ChatGPT

La spécification produit d’OpenAI définit neuf champs obligatoires pour un flux de découverte exploitable. Utilisez un véritable nom de marque et de vendeur, jamais des valeurs fictives. Les détails ci-dessous suivent la spécification produits d’OpenAI.

Champ Valeur à envoyer Piège à éviter
item_id Identifiant stable et unique pour chaque article ou variante Ne le réutilisez jamais pour un autre article. OpenAI associe les produits à partir de cet identifiant, pas du nom de fichier.
title Nom du produit, variante sélectionnée comprise Visez 150 caractères maximum.
description Description factuelle en texte brut de cet article Visez 5 000 caractères maximum. Évitez les formulations marketing superflues.
url Page produit, avec la variante sélectionnée lorsque c’est possible Elle doit être accessible au public et stable.
brand Marque telle qu’elle apparaît sur la page produit Les valeurs fictives ne sont pas acceptées.
seller_name Nom du vendeur que les utilisateurs doivent voir Obligatoire sur chaque ligne au format OpenAI.
image_url URL directe vers une image JPEG ou PNG montrant cette variante Elle doit être accessible au public et pointer vers l’image, pas vers une galerie.
availability in_stock, out_of_stock, pre_order, backorder ou unknown Une valeur absente, vide ou non reconnue entraîne le rejet de la ligne.
price Prix normal au format 79.99 USD Unités principales, espace, code ISO 4217 en majuscules et aucun séparateur de milliers.

Voici à quoi ressemble un enregistrement JSONL valide sur une ligne :

{"item_id":"GRIND-HAND-BLK","title":"Hand coffee grinder, matte black","description":"Manual burr grinder with a stainless steel burr and a 30 g glass jar.","url":"https://example.com/products/hand-grinder-black","brand":"Brewline","seller_name":"Brewline Coffee Gear","image_url":"https://example.com/images/hand-grinder-black.jpg","price":"64.00 USD","availability":"in_stock"}

Un point de vigilance important : la spécification précise que les indications de format ne garantissent pas que chaque valeur invalide sera rejetée lors de l’envoi. Un fichier accepté sans erreur peut donc contenir de mauvaises données. Validez-le avant l’envoi, et non après. Un petit outil de contrôle est fourni plus bas.

Formats de fichiers, livraison SFTP et règles applicables

Sujet Recommandation d’OpenAI
Type de flux Instantané complet de l’ensemble du catalogue, utilisé comme source de référence
Fréquence Au moins une fois par jour
Transmission Envoi à OpenAI via SFTP
Formats Parquet privilégié (idéalement compressé avec zstd) ; jsonl.gz, csv.gz et tsv.gz également pris en charge
Encodage UTF-8
Noms de fichiers Conservez un nom stable et écrasez-le à chaque exécution
Fragments Jusqu’à 500 000 articles par fragment, fichiers d’environ 500 Mo maximum ; conservez le même ensemble de fragments à chaque mise à jour

Deux comportements sont importants en pratique. Premièrement, le répertoire racine SFTP représente l’intégralité de votre catalogue et il n’existe aucun marqueur de fin : OpenAI traite chaque fichier du répertoire racine lorsque les envois restent inchangés pendant un court moment. Envoyez tous les fragments à la suite, car une longue pause peut déclencher le traitement d’un catalogue incomplet (OpenAI relance ensuite le traitement lorsque les autres fragments arrivent). Deuxièmement, si plusieurs flux de marques partagent un même emplacement, préfixez les noms de fichiers avec le nom de la marque.

Certains guides tiers décrivent la transmission comme un envoi HTTPS. La propre présentation d’OpenAI indique SFTP : suivez donc cette indication et confirmez le point de terminaison exact auprès d’OpenAI pendant l’intégration.

Le plus difficile est rarement l’export lui-même. Il s’agit plutôt de maintenir un catalogue propre alimentant plusieurs canaux à la fois. C’est généralement à ce stade que confier la gestion des flux produits revient moins cher que de maintenir des scripts personnalisés pour chaque canal.

Variantes, identifiants de groupe et validation des GTIN

Envoyez une ligne par variante sélectionnable. Chaque ligne possède son propre item_id, le même group_id (qui doit être différent de tous les identifiants d’article), listing_has_variations=true et un variant_dict contenant les options sélectionnées. Chaque ligne doit également présenter son propre prix, sa disponibilité, son URL et ses images.

{"item_id":"TEE-NAVY-M","group_id":"TEE","listing_has_variations":true,"variant_dict":{"color":"Navy","size":"M"},"offer_id":"brewline-TEE-NAVY-M","title":"Cotton tee, navy, size M","description":"Midweight cotton tee.","url":"https://example.com/products/tee-navy-m","brand":"Brewline","seller_name":"Brewline Coffee Gear","image_url":"https://example.com/images/tee-navy.jpg","price":"24.00 USD","availability":"in_stock"}
{"item_id":"TEE-NAVY-L","group_id":"TEE","listing_has_variations":true,"variant_dict":{"color":"Navy","size":"L"},"offer_id":"brewline-TEE-NAVY-L","title":"Cotton tee, navy, size L","description":"Midweight cotton tee.","url":"https://example.com/products/tee-navy-l","brand":"Brewline","seller_name":"Brewline Coffee Gear","image_url":"https://example.com/images/tee-navy.jpg","price":"24.00 USD","availability":"out_of_stock"}

Voici les règles qui posent souvent problème : utilisez des noms d’options identiques au sein d’un groupe, gardez les champs de premier niveau color ou size cohérents avec variant_dict, car aucun des deux ne résout les conflits à votre place, et ne placez jamais le prix dans un offer_id. Les anciens champs Custom_variant1_category et couples d’options fonctionnent encore, mais ne les mélangez pas avec variant_dict.

Pour les identifiants, le gtin doit comporter exactement 8, 12, 13 ou 14 chiffres et posséder une clé de contrôle valide. Conservez-le sous forme de chaîne pour préserver les zéros initiaux. Envoyez mpn avec brand et n’inventez pas de MPN pour remplacer un GTIN manquant. Ce contrôle préalable vérifie les champs obligatoires, les valeurs de disponibilité, le format monétaire, les clés de contrôle GTIN et les identifiants en double, puis écrit un instantané JSONL compressé :

import gzip
import json
import re

REQUIRED = ("item_id", "title", "description", "url", "brand",
            "seller_name", "image_url", "availability", "price")
AVAILABILITY = {"in_stock", "out_of_stock", "pre_order", "backorder", "unknown"}
PRICE = re.compile(r"^\d+(\.\d+)? [A-Z]{3}$")


def gtin_ok(value):
    if not value.isdigit() or len(value) not in (8, 12, 13, 14):
        return False
    body, check = value[:-1], int(value[-1])
    total = sum(int(d) * (3 if i % 2 == 0 else 1)
                for i, d in enumerate(reversed(body)))
    return (10 - total % 10) % 10 == check


def problems(row):
    out = [f"missing {f}" for f in REQUIRED if not str(row.get(f, "")).strip()]
    if row.get("availability") not in AVAILABILITY:
        out.append("availability would reject the row")
    if not PRICE.match(str(row.get("price", ""))):
        out.append("price must look like 79.99 USD")
    if row.get("gtin") and not gtin_ok(str(row["gtin"])):
        out.append("gtin fails the check digit")
    return out


def write_snapshot(rows, path="products.jsonl.gz"):
    seen, failed = set(), 0
    with gzip.open(path, "wt", encoding="utf-8") as f:
        for row in rows:
            issues = problems(row)
            if row.get("item_id") in seen:
                issues.append("duplicate item_id")
            seen.add(row.get("item_id"))
            if issues:
                failed += 1
                print(row.get("item_id"), issues)
                continue
            f.write(json.dumps(row, ensure_ascii=False) + "\n")
    return failed

Indicateurs d’éligibilité à la recherche et au paiement

Champ Valeur par défaut Fonctionnement
is_eligible_search true s’il est omis false retire le produit des résultats de recherche et désactive également le paiement. L’éligibilité ne garantit pas l’affichage.
is_eligible_checkout désactivé s’il est omis Active le paiement uniquement si la recherche est également activée et si le paiement est disponible pour votre intégration. Nécessite les URL seller_privacy_policy et seller_tos.

Définir un indicateur de paiement ne finalise pas l’intégration du paiement, car celui-ci nécessite une intégration activée séparément. Les anciens alias tels que enable_search et enable_checkout sont encore acceptés, mais n’envoyez qu’un seul nom par valeur : la version enable_ prend le dessus sur la version is_eligible_. La présence des deux dans un ancien script d’export peut donc produire des résultats difficiles à comprendre.

Consultez également la politique relative aux produits interdits avant l’envoi. OpenAI exclut notamment les contenus pour adultes, l’alcool, la nicotine, les jeux d’argent, les armes et les médicaments délivrés uniquement sur ordonnance. La plateforme peut supprimer les produits concernés ou bannir un vendeur qui enfreint cette politique. Filtrez ces articles du flux ou définissez l’éligibilité à la recherche sur false.

Champs facultatifs utiles et ciblage par défaut limité aux États-Unis

Champ Règle Piège
sale_price Supérieur à zéro, strictement inférieur à price, dans la même devise Un prix promotionnel égal, supérieur ou exprimé dans une autre devise est ignoré.
shipping_price Supérieur ou égal à zéro, dans la même devise que le prix Une valeur omise signifie « inconnue », et non livraison gratuite.
accepts_returns, return_deadline_in_days, return_policy Booléen, nombre entier de jours, URL publique L’URL d’une politique ne définit pas accepts_returns.
review_count, star_rating Avis sur le produit uniquement, note de 0 à 5 Ne mélangez pas les avis du magasin ou du vendeur avec ceux du produit.
additional_image_urls Tableau en JSONL, valeurs séparées par des virgules en CSV Encodez les virgules présentes dans une URL sous la forme %2C.

Le marché par défaut mérite votre attention. L’envoi au format OpenAI standard cible actuellement les États-Unis, et les champs au niveau de la ligne comme target_countries ne modifient pas ce ciblage. Pour les autres marchés, OpenAI doit d’abord confirmer l’intégration. Une devise, une URL produit ou un système de tailles ne suffit pas à sélectionner une destination. Si vous vendez principalement en dehors des États-Unis, renseignez-vous sur les marchés pris en charge pendant l’intégration, avant d’investir dans des flux localisés.

À quelle fréquence mettre à jour le flux et comment fonctionne la suppression ?

Publiez des instantanés complets au moins une fois par jour. Un produit absent d’un instantané traité n’est pas supprimé immédiatement : OpenAI conserve son dernier enregistrement traité pendant 14 jours au maximum, afin de vous protéger contre l’arrivée tardive d’un fragment. Deux conséquences en découlent. Pour retirer un produit de la recherche lors du prochain traitement, définissez is_eligible_search=false. Pour le supprimer par omission, excluez-le de tous les fragments dans les instantanés complets suivants et attendez l’expiration de l’enregistrement conservé dans un délai de 14 jours.

Les champs de date ne programment aucune action. Les périodes promotionnelles, dates d’expiration et dates de disponibilité ne modifient pas automatiquement les prix ou les stocks. Mettez donc à jour le prix au début et à la fin d’une promotion, puis la disponibilité lorsqu’un article est épuisé. Comme les produits sont associés via item_id, générez les identifiants à partir de votre SKU stable ou de votre clé de base de données, jamais à partir d’un numéro de ligne ou d’un slug de titre susceptible de changer lorsqu’un nom est modifié.

Peut-on réutiliser un flux Google Merchant Center pour ChatGPT ?

Uniquement si OpenAI confirme le format compatible avec Google pour votre flux enregistré. Il s’agit d’un profil distinct avec des règles différentes. Le format OpenAI est vérifié en premier, et un seul format s’applique à l’ensemble de l’envoi.

Aspect Format OpenAI Profil compatible avec Google
Fichiers Parquet, jsonl.gz, csv.gz, tsv.gz .txt, .tsv ou .csv, éventuellement compressés avec gzip ; JSON et XML non pris en charge
Valeur de précommande pre_order preorder
Disponibilité unknown Acceptée Non acceptée
Identité du vendeur seller_name sur chaque ligne Nom du marchand enregistré ; un seller_name envoyé dans le fichier ne peut pas le remplacer
Exclusion d’un article de la recherche Prise en compte via is_eligible_search Non prise en compte ; envoyez uniquement les produits destinés à être trouvés
Identifiants GTIN et MPN facultatifs GTIN ou MPN valide requis, sauf si identifier_exists est false

En pratique, un export Google constitue un point de départ, pas une solution prête à l’emploi. L’orthographe de preorder, l’absence d’option d’exclusion et le nom du vendeur enregistré sont précisément les différences qui apparaissent souvent tardivement.

Erreurs courantes dans les flux ChatGPT et checklist avant envoi

  • Prix au mauvais format. Écrivez 79.99 USD, et non 7999 ou 79,99.
  • Valeurs de disponibilité incorrectes. Une valeur non reconnue entraîne le rejet de la ligne. Utilisez explicitement unknown plutôt que de laisser le champ vide.
  • Chaînes fictives. N’écrivez pas null, n/a ou unknown dans les champs facultatifs. Omettez le champ.
  • GTIN invalides. Vérifiez la clé de contrôle et préservez les zéros initiaux en traitant la valeur comme une chaîne.
  • Nouveaux noms de fichiers à chaque exécution. Écrasez plutôt un nom ou un ensemble de fragments stable.
  • Deux représentations des frais de livraison. N’envoyez pas simultanément shipping_price et un tuple shipping pour les mêmes frais. Notez également que le tuple nécessite une configuration propre au flux.
  • URL privées ou bloquées. Les URL des produits et des images doivent être accessibles au public.

Créer le flux et le maintenir à jour

Faire accepter un flux une première fois est la partie la plus simple. Ce qui protège vos fiches dans la durée, c’est de conserver des identifiants stables, des prix et des stocks à jour, ainsi que des variantes correctement regroupées à chaque mise à jour. Netalith crée et gère des flux produits pour Google Merchant Center, Meta, Pinterest, Microsoft et OpenAI (ChatGPT). Si vous souhaitez obtenir un deuxième avis sur votre catalogue ou faire créer votre flux, demandez un devis gratuit en indiquant votre plateforme et la taille de votre catalogue.

FAQ

Questions fréquentes

Tous les marchands peuvent-ils envoyer un flux produit à ChatGPT ?

Pas encore. Au 29 septembre 2026, OpenAI indique que l’intégration des flux produits est réservée aux partenaires approuvés. La demande se fait via le formulaire marchand sur chatgpt.com/merchants. Profitez de l’attente pour préparer et valider vos données.

Quel format de fichier utiliser pour un flux produit ChatGPT ?

OpenAI privilégie Parquet, idéalement avec une compression zstd. jsonl.gz, csv.gz et tsv.gz sont également pris en charge. Tous les fichiers doivent être encodés en UTF-8, et JSONL est généralement le format le plus simple pour les catalogues petits et moyens.

À quelle fréquence mettre à jour un flux produit ChatGPT ?

Envoyez un instantané complet au moins une fois par jour, en écrasant le même nom de fichier à chaque fois. Le guide Get Started d’OpenAI recommande également de transmettre les mises à jour au fil de la journée via l’API lorsque les prix ou les stocks évoluent rapidement.

L’envoi d’un flux garantit-il l’apparition de mes produits dans ChatGPT ?

Non. L’éligibilité ne garantit pas l’affichage. Le flux rend les produits éligibles ; leur affichage par ChatGPT dépend de la requête ainsi que de la qualité et de la pertinence de vos données.

Comment retirer un produit du flux ChatGPT ?

Définissez is_eligible_search sur false pour le rendre inéligible lors du prochain traitement d’un instantané, ou omettez-le de tous les fragments dans les instantanés complets suivants. OpenAI conserve le dernier enregistrement traité pendant 14 jours au maximum : la suppression par omission n’est donc pas immédiate.

Les GTIN sont-ils nécessaires pour configurer un flux produit ChatGPT ?

Dans le format OpenAI, le GTIN et le MPN sont facultatifs. Si vous envoyez un GTIN, il doit être valide, comporter 8, 12, 13 ou 14 chiffres et posséder une clé de contrôle correcte. N’inventez pas de MPN pour remplacer un GTIN manquant. Le profil compatible avec Google exige un GTIN ou un MPN valide, sauf si identifier_exists est false.

Puis-je utiliser mon flux Google Merchant Center pour ChatGPT ?

Uniquement si OpenAI confirme le format compatible avec Google pour votre flux enregistré. Ses règles diffèrent du format OpenAI : preorder s’écrit différemment, la disponibilité unknown est rejetée et le nom du vendeur provient du nom du marchand enregistré.

Restez informé avec Netalith

Recevez des ressources de développement, des mises à jour produit et des offres spéciales directement dans votre boîte mail.