Pular para o conteúdo principal
As leituras de catálogo podem ter como alvo a conta conectada ou outro ID de empresa compatível. As alterações se aplicam à conta do app WhatsApp Business conectada.

​
Disponibilidade no Console

O Console mostra Catálogos apenas para equipes com acesso. Se esse espaço de trabalho não aparecer na sua navegação, use as operações de API deste guia. O acesso existente à API de catálogo não muda.

​
Catálogos e produtos

  1. Get business catalog para inspecionar os produtos e o estado da paginação.
  2. Create business catalog se a conta não tiver catálogo.
  3. Create business product ou Update business product.
  4. Delete business product quando o produto não for mais vendido.
Atualizar um produto substitui o produto inteiro. Leia o produto atual e envie de novo todos os valores opcionais que quiser manter. Descrições, preços promocionais, IDs de varejista, URLs, vídeos e campos de conformidade omitidos são removidos.

​
Regras da solicitação de produto

Os valores price e salePrice de um produto são strings de dígitos em milésimos da moeda selecionada. Por exemplo, "12500" representa 12,5 unidades da moeda (12500 / 1000). Os códigos de moeda precisam ser consistentes em todo lugar onde os totais são calculados.

​
Coleções

Use List business collections e Get business collection para leituras. Create business collection, Update business collection e Reorder business collections controlam os produtos de cada coleção e a ordem das coleções.

​
Regras da solicitação de coleção

​
Visibilidade, recursos de revisão e carrinhos

Os motivos do recurso têm os espaços das extremidades removidos, não podem ficar em branco e aceitam no máximo 4096 bytes UTF-8.

​
Pedidos

Get business order exige o ID do pedido e o token criptografado do pedido que vêm na mensagem de pedido recebida. Envie o token apenas no corpo JSON da solicitação; nunca o coloque em uma URL, em um parâmetro de consulta ou em um log. O token não pode ficar em branco e aceita no máximo 8192 caracteres. Trate a moeda e os preços retornados como um único retrato atômico do pedido. Envios estruturados de order_details e order_status, incluindo instruções de pagamento Pix, não estão disponíveis pelas mensagens da Graph. Eles retornam o erro de capacidade 131026 antes de qualquer envio ao provedor. Um pedido ou callback de pagamento recebido não comprova que o dinheiro foi liquidado. Use o registro de liquidação verificado do seu provedor de pagamento como a fonte oficial do estado pago. Para números da API oficial, List linked product catalogs lê os catálogos associados à conta do WhatsApp Business (WABA) do número. Use o ID da WABA de um número do seu projeto e uma credencial com sessions:read. A Meta controla quais catálogos a conta conectada pode ver e retorna o próprio erro de permissão se a conta não tiver acesso. Envie paging.cursors.after como after para ler a próxima página; limit aceita de 1 a 100, com padrão 25. List linked catalog products lê os IDs de produto, IDs de varejista, nomes e disponibilidade de um catálogo da lista vinculada dessa WABA. Envie o ID da WABA e o ID do catálogo, com sessions:read. Quando há mais produtos, a resposta inclui paging.cursors.after; envie esse valor como after para continuar. A última página não tem o objeto paging. limit aceita de 1 a 100, com padrão 25. A Meta controla quais produtos a credencial conectada pode ler. Essa leitura não comprova que um produto pode ser enviado nem que a conta pode fazer transações. Use Send a message com um número da API oficial, uma credencial com messages:write e acesso da Meta ao catálogo vinculado dele. Defina type como interactive e interactive.type como product para um item ou product_list para seções de itens. O catalog_id precisa constar na lista de catálogos da WABA do número. A Polymorfa verifica essa associação antes do despacho; uma permissão ausente ou uma leitura de catálogo incompleta interrompe o envio. A Meta valida cada product_retailer_id e continua sendo a fonte oficial da disponibilidade do produto.
Para product_list, adicione um cabeçalho de texto e um corpo e defina action.sections com 1 a 10 seções. Cada seção precisa de um array product_items com pelo menos um item, e a mensagem aceita no máximo 30 itens somando todas as seções; cada item tem um product_retailer_id. Dê um título a cada seção quando enviar várias seções. Números com Dispositivos vinculados e números simulados não podem enviar produtos do catálogo. Em envios híbridos, concilie o status da operação depois de uma resposta incerta e reutilize a mesma chave de idempotência. Não repita um envio incerto com uma chave nova. Get commerce settings e Update commerce settings expõem as configurações compatíveis com a Meta disponíveis para números da API oficial. A leitura do catálogo não cria um catálogo nem vincula um catálogo à WABA.