> ## Documentation Index
> Fetch the complete documentation index at: https://docs.ycloud.com/llms.txt
> Use this file to discover all available pages before exploring further.
# Catálogos e comércio
> Compartilhe produtos do catálogo no WhatsApp e processe solicitações de pedidos de clientes.
Use um catálogo conectado para exibir produtos no WhatsApp e permitir que os clientes selecionem itens. Processe as solicitações de pedidos por meio dos seus sistemas de pedidos e pagamento.
## Escolha o formato da mensagem
O contrato de mensagens da YCloud inclui tipos de mensagem interativa de produto, multiproduto e catálogo. Esses são formatos de mensagem de serviço e exigem a janela de envio apropriada.
Formatos baseados em modelo para catálogo e multiproduto oferecem um ponto de entrada diferente. Eles exigem um modelo aprovado e a configuração relevante do catálogo.
Use:
* [Mensagens de serviço](/pt/documentation/whatsapp-business-platform/messaging/service-messages) para verificar a elegibilidade de envio em formato livre.
* [Componentes e formatos de modelo](/pt/documentation/whatsapp-business-platform/messaging/message-templates/template-components-and-formats) para opções de modelo.
* [Modelos de catálogo](/pt/documentation/whatsapp-business-platform/messaging/message-templates/catalog-templates) e [modelos multiproduto](/pt/documentation/whatsapp-business-platform/messaging/message-templates/multi-product-templates) para detalhes de formato.
O suporte no contrato da API não implica que todos os formatos apareçam em todos os editores do console.
Fonte: [exemplo oficial da Meta](https://developers.facebook.com/docs/whatsapp/cloud-api/guides/sell-products-and-services/share-products/).
## Prepare o catálogo e o processo de negócios
Antes de enviar mensagens de produtos:
* Confirme se o catálogo desejado está conectado aos ativos de negócios corretos.
* Mantenha os identificadores de produtos estáveis e faça a correspondência com seus próprios registros de produtos.
* Mantenha preços, disponibilidade, imagens e descrições precisos.
* Verifique a elegibilidade quanto às políticas comerciais e de produtos.
* Defina quem cuidará de dúvidas sobre pedidos, cancelamentos e reembolsos.
* Valide os itens enviados em relação ao estoque e preços atuais.
Não trate os detalhes do pedido fornecidos pelo cliente como instruções definitivas de pagamento ou atendimento sem validação prévia.
## Faça a correspondência dos identificadores de produtos antes de enviar
Use o identificador de comerciante (retailer ID) do produto no catálogo conectado da Meta — não use o nome de exibição, a URL da página do produto ou um ID de banco de dados interno não relacionado.
Por exemplo, sua loja pode usar o ID de item interno `8421`, enquanto o catálogo usa o ID de comerciante `SKU-BAG-BLUE`. Mantenha um mapeamento explícito. Uma mensagem de produto que faça referência a `8421` não encontrará `SKU-BAG-BLUE`, a menos que esse seja realmente o identificador no catálogo.
Verifique o ID do catálogo, o ID de comerciante do produto e a conexão de catálogo do remetente em conjunto. O mesmo nome de produto pode existir em vários catálogos sem que esses registros sejam intercambiáveis.
## Valide uma solicitação de pedido de cliente
Quando um cliente envia os itens selecionados:
1. Identifique o cliente e o catálogo de origem.
2. Resolva cada identificador de produto para um item vendável atual.
3. Verifique novamente a quantidade, o estoque, o preço, a moeda, o local de entrega, os impostos e o frete.
4. Apresente o total final a pagar e os termos aplicáveis por meio do checkout com suporte.
5. Confirme o pagamento usando o resultado retornado pelo sistema de pagamentos.
6. Crie ou libere o pedido de atendimento apenas no estado comercial apropriado.
Se o preço exibido mudar antes do checkout, explique a alteração e obtenha a confirmação do cliente. Não faça cobranças de valores diferentes silenciosamente.
## Solução de problemas de produtos ausentes
| Sintoma | Verificações |
| - | - |
| O botão do catálogo está ausente ou o catálogo não abre | Remetente correto, conexão do catálogo, configurações de comércio e mensagem/cliente com suporte. |
| Um produto está ausente | ID de comerciante exato, disponibilidade do produto, análise de políticas e sincronização do catálogo. |
| Imagem ou preço do produto desatualizados | O registro atual no catálogo de origem e seu status de atualização. |
| Um carrinho chega, mas nenhum pedido pago aparece | Integração de processamento de pedidos e pagamentos; um carrinho não é um evento de pagamento. |
Use um catálogo de testes pequeno e dados de clientes fictícios para verificar toda a jornada antes de uma campanha. Um modelo de mensagem aprovado não aprova automaticamente todos os produtos adicionados ao catálogo posteriormente.
## O YCloud Shop e o WhatsApp Pay são produtos separados
O [YCloud Shop](/pt/documentation/shop/overview) possui sua própria configuração de loja, produtos, frete, pagamento e gerenciamento de pedidos. Não presuma que um produto do Shop se torna automaticamente um item do catálogo do WhatsApp.
O [WhatsApp Pay](/pt/documentation/whatsapp-pay/overview) adiciona uma experiência de pagamento no app suportada. O guia atual da YCloud restringe esse recurso a empresas e usuários na Índia com provedores de pagamento suportados.
Outros recursos ou mercados de pagamento da Meta não estabelecem automaticamente a disponibilidade na YCloud. Confirme o mercado e o provedor antes de planejar um checkout dentro da conversa.
## Aplique as políticas a toda a oferta
Revise o produto, a mensagem, o catálogo e a experiência de pagamento em conjunto. A permissão para enviar uma mensagem comercial não autoriza automaticamente a venda do mesmo produto por meio dos recursos de comércio.
Consulte [Políticas comerciais e de negócios](/pt/documentation/whatsapp-business-platform/consent-policies-and-account-health/business-and-commerce-policies) para saber como funciona a análise de conformidade. Sua empresa continua responsável pelos termos de venda, suporte ao cliente e processamento das transações.
## Continuar na YCloud
* [Configurar o YCloud Shop](/pt/documentation/shop/overview)
* [Saiba mais sobre o WhatsApp Pay](/pt/documentation/whatsapp-pay/overview)
* [Enviar mensagens do WhatsApp por meio da API](/pt/api-reference/guides/whatsapp-platform/send-whatsapp-message)
* [Acompanhar a entrega de mensagens](/pt/documentation/whatsapp-business-platform/messaging/message-delivery-statuses)
## Perguntas frequentes
Verifique o catálogo da Meta conectado e o ID exato de varejista/conteúdo utilizado nele. O ID interno da sua loja ou a URL do produto podem ser diferentes. Confirme se o remetente usa esse catálogo e se o item está disponível e aprovado antes de tentar novamente.
Um carrinho apenas comunica os itens selecionados; ele não é o resultado de um pagamento. Seu fluxo de pedidos deve validar os itens, calcular o total, obter qualquer confirmação necessária e utilizar um checkout compatível. Libere o atendimento com base no status real do sistema de pagamentos/pedidos.
Não presuma isso. O Shop, o catálogo da Meta conectado e o WhatsApp Pay possuem configurações e disponibilidades distintas. Confirme a conexão do catálogo e o formato de mensagem compatível; para pagamentos na conversa, verifique a elegibilidade do mercado e do provedor de pagamento no guia da YCloud.
This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.