Especificación de conversión para finalizar compras

Objetivo

Nuestro objetivo es que ChatGPT pueda invocar directamente los complementos de los socios cuando el usuario muestra una clara intención de compra, por ejemplo, al finalizar una compra.

Una vez que los socios nos proporcionan un feed de productos para la búsqueda, podemos conectar sus servidores MCP para realizar acciones de conversión en la etapa final del embudo de ventas. Para ello, los complementos de los socios deben seguir un contrato estándar que define 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 de ChatGPT para comercios.

Experiencia de usuario

Cuando los usuarios buscan productos, el panel lateral del producto puede mostrar botones Abrir para los distintos vendedores. Si un vendedor tiene un complemento, ChatGPT puede abrirlo dentro de la conversación para que el usuario finalice la compra sin tener que ir a un sitio web externo.

Contrato obligatorio vigente

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

checkout_session debe establecer el siguiente valor:

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

Toda herramienta que se invoque directamente desde un widget debe establecer el siguiente valor:

_meta["openai/widgetAccessible"] = true;

Datos de entrada de checkout_session

Para cada artículo de la compra, solo se requieren id y quantity. Tanto offerId como los metadatos de la oferta seleccionada del comercio 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 de cada artículo son opcionales:

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

La estructura de la sesión de compra anidada coincide con la que se describe en la documentación de sesiones de compra de Commerce.