For the complete documentation index, see llms.txt. Markdown versions of documentation pages are available by appending .md to the page URL.
Navegación principal

Especificación de conversión para la finalización de compras de productos

Contrato para integrar un complemento de finalización de compras de productos en el flujo de conversión de ChatGPT.

Los complementos de conversión para la finalización de compras de productos en ChatGPT están actualmente en versión beta y se están probando con socios aprobados. Para solicitar acceso, completa este formulario

aquí

Objetivo

Nuestro objetivo es permitir que ChatGPT invoque directamente complementos de socios para casos de uso con alta intención de compra, como la finalización de compras de productos.

Una vez que los socios nos proporcionen un feed de productos para la búsqueda, podremos conectar sus servidores MCP para realizar acciones de conversión en la etapa final del embudo. Para ello, los complementos de los socios deben seguir un contrato estandarizado para el nombre del widget, el nombre de la herramienta y los datos de entrada de la herramienta.

Si quieres crear un complemento que siga esta especificación, solicita acceso mediante el formulario para comerciantes de ChatGPT.

Experiencia de usuario

Cuando los usuarios buscan productos, la barra lateral de la entidad de producto puede mostrar botones Abrir para los vendedores. Si un vendedor tiene un complemento, ChatGPT puede abrirlo dentro de la conversación para finalizar la compra en lugar de redirigir al usuario a un sitio web externo.

Contrato obligatorio (actual)

  • Nombre del widget: ui://widget/checkout-session.html
  • Nombre de la herramienta: checkout_session

checkout_session debe establecer:

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

Toda herramienta que se llame directamente desde un widget debe establecer:

_meta["openai/widgetAccessible"] = true;

Datos de entrada de checkout_session

Cada artículo de la compra requiere únicamente id y quantity. offerId y los metadatos de la oferta seleccionada del comerciante son opcionales:

{
  "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"
      }
    ]
  }
}

Los siguientes campos del artículo son opcionales:

CampoDescripción
offerIdEl identificador de la oferta seleccionada del comerciante.
nameEl nombre del producto de la oferta seleccionada.
descriptionUna descripción del propio feed del comerciante.
imagesURLs de imágenes del feed del comerciante, en orden; la primera es la principal.
urlLa URL de la oferta seleccionada del comerciante.
merchant_nameEl nombre del comerciante seleccionado.
priceEl precio mostrado de la oferta como cadena de texto.

images contiene cero o más URLs del feed del comerciante seleccionado. Si hay URLs, la primera corresponde a la imagen principal que se muestra. ChatGPT omite los campos opcionales que no están disponibles. No genera una descripción ni usa la descripción o las imágenes de otro comerciante. Declara estos campos del artículo como opcionales en el esquema de entrada de tu herramienta y usa los identificadores del artículo de la compra y de la oferta para obtener los datos oficiales de productos, inventario y precios de tu propio catálogo.

La sesión de finalización de compra anidada se ajusta a la estructura de la sesión de finalización de compra de Commerce documentada aquí.