For the complete documentation index, see llms.txt. Markdown versions of documentation pages are available by appending .md to the page URL.
Navigation principale

Spécification de conversion pour la finalisation d’achat de produits

Contrat d’intégration d’un plugin de finalisation d’achat de produits au parcours de conversion de ChatGPT.

Les plugins de conversion pour la finalisation d’achat de produits dans ChatGPT sont actuellement en bêta et sont testés avec des partenaires approuvés. Pour demander l’accès, remplissez ce formulaire

ici

Objectif

Notre objectif est de permettre à ChatGPT d’appeler directement les plugins de partenaires pour des cas d’utilisation à forte intention d’achat, comme la finalisation d’achat de produits.

Une fois que les partenaires nous ont fourni un flux de produits pour la recherche, nous pouvons connecter leurs serveurs MCP pour effectuer des actions de conversion en fin de parcours d’achat. Pour cela, les plugins des partenaires doivent respecter un contrat standardisé qui définit le nom du widget, le nom de l’outil et les données d’entrée de l’outil.

Si vous souhaitez créer un plugin conforme à cette spécification, demandez l’accès via le formulaire ChatGPT pour les commerçants.

Expérience utilisateur

Lorsque les utilisateurs recherchent des produits, le panneau latéral du produit peut afficher des boutons Ouvrir pour les vendeurs. Si un vendeur dispose d’un plugin, ChatGPT peut ouvrir ce plugin directement dans l’interface pour finaliser l’achat, au lieu de rediriger l’utilisateur vers un site web externe.

Contrat requis (actuellement)

  • Nom du widget : ui://widget/checkout-session.html
  • Nom de l’outil : checkout_session

checkout_session doit définir :

_meta.ui.resourceUri = "ui://widget/checkout-session.html";

Tout outil appelé directement depuis un widget doit définir :

_meta["openai/widgetAccessible"] = true;

Données d’entrée de checkout_session

Pour chaque article à acheter, seuls id et quantity sont requis. offerId et les métadonnées de l’offre du commerçant sélectionnée sont facultatifs :

{
  "checkout_session": {
    "items": [
      {
        "id": "string",
        "quantity": 1,
        "offerId": "string",
        "name": "Wireless headphones",
        "description": "Wireless headphones with noise cancellation.",
        "images": [
          "https://merchant.example.com/images/headphones.jpg",
          "https://merchant.example.com/images/headphones-side.jpg"
        ],
        "url": "https://merchant.example.com/products/headphones",
        "merchant_name": "Example Merchant",
        "price": "$24.99"
      }
    ]
  }
}

Les champs suivants sont facultatifs pour chaque article :

ChampDescription
offerIdL’identifiant de l’offre du commerçant sélectionnée.
nameLe nom du produit de l’offre sélectionnée.
descriptionUne description issue du propre flux du commerçant.
imagesLes URL des images du flux du commerçant, dans l’ordre ; la première correspond à l’image principale.
urlL’URL de l’offre du commerçant sélectionnée.
merchant_nameLe nom du commerçant sélectionné.
priceLe prix affiché de l’offre, sous forme de chaîne de caractères.

images contient zéro, une ou plusieurs URL issues du flux du commerçant sélectionné. Si des URL sont présentes, la première correspond à l’image principale affichée. ChatGPT omet les champs facultatifs dont les données ne sont pas disponibles. Il ne génère pas de description et n’utilise ni la description ni les images d’un autre commerçant. Déclarez ces champs d’article comme facultatifs dans le schéma d’entrée de votre outil et utilisez les identifiants des articles à acheter et des offres pour récupérer les données de référence sur les produits, les stocks et les prix dans votre propre catalogue.

La session de finalisation d’achat imbriquée suit la structure de session de finalisation d’achat Commerce décrite ici.