Especificação de conversão para finalização de compras de produtos

Objetivo

Nosso objetivo é permitir que o ChatGPT invoque diretamente plug-ins de parceiros em casos de uso com alta intenção de compra, como a finalização de compras de produtos.

Depois que os parceiros nos fornecerem um feed de produtos para pesquisa, poderemos conectar seus servidores MCP para ações de conversão no fundo do funil. Para isso, os plug-ins dos parceiros devem seguir um contrato padronizado para o nome do widget, o nome da ferramenta e os dados de entrada da ferramenta.

Se você quiser criar um plug-in que siga esta especificação, solicite acesso pelo formulário de lojistas do ChatGPT.

Experiência do usuário

Quando os usuários pesquisam produtos, a barra lateral de detalhes do produto pode mostrar botões Abrir para os vendedores. Se um vendedor tiver um plug-in, o ChatGPT poderá abrir esse plug-in na própria interface para finalizar a compra, em vez de redirecionar o usuário para um site externo.

Contrato obrigatório (atual)

• Nome do widget: ui://widget/checkout-session.html
• Nome da ferramenta: checkout_session

checkout_session deve definir:

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

Qualquer ferramenta chamada diretamente de um widget deve definir:

_meta["openai/widgetAccessible"] = true;

Dados de entrada de checkout_session

Cada item da finalização de compra exige apenas id e quantity. offerId e os metadados da oferta selecionada do lojista são opcionais:

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

Os seguintes campos do item são opcionais:

images contém zero ou mais URLs do feed do lojista selecionado. Quando houver URLs, a primeira corresponde à imagem principal exibida. O ChatGPT omite os campos opcionais indisponíveis. Ele não gera uma descrição nem usa a descrição ou as imagens de outro lojista. Declare esses campos do item como opcionais no esquema de entrada da sua ferramenta e use os IDs do item da finalização de compra e da oferta para obter os dados oficiais de produto, estoque e preços do seu próprio catálogo.

A sessão de finalização de compra aninhada segue a estrutura da sessão de finalização de compra do Commerce documentada aqui.