Há várias formas de compartilhar produtos com seus clientes.
Com as mensagens de catálogo, é possível mostrar todo o seu inventário de produtos no WhatsApp.
Essas mensagens exibem uma imagem de cabeçalho da miniatura do produto à sua escolha, um texto personalizado, um título fixo, um subtítulo fixo e um botão Ver catálogo.
Quando um cliente toca no botão Ver catálogo, seu catálogo de produtos aparece no WhatsApp.
Você precisa ter um inventário carregado na Meta em um catálogo de comércio eletrônico conectado à sua conta do WhatsApp Business.
Use o ponto de extremidade WhatsApp Business Phone Number > Messages para enviar uma mensagem de catálogo.
POST /<WHATSAPP_BUSINESS_PHONE_NUMBER_ID>/messages
{ "messaging_product": "whatsapp", "recipient_type": "individual", "to": "<TO>", "type": "interactive", "interactive" : { "type" : "catalog_message", "body" : { "text": "<BODY_TEXT>" }, "action": { "name": "catalog_message", /* Parameters object is optional */ "parameters": { "thumbnail_product_retailer_id": "<THUMBNAIL_PRODUCT_RETAILER_ID>" } }, /* Footer object is optional */ "footer": { "text": "<FOOTER_TEXT>" } }
Espaço reservado | Descrição | Exemplo de valor |
---|---|---|
String | Obrigatório. Texto a ser exibido no corpo da mensagem. Máximo de 1.024 caracteres. |
|
String | Opcional. Texto a ser exibido no rodapé da mensagem. Máximo de 60 caracteres. |
|
String | Opcional. Número SKU do item. marcado como identificação do conteúdo no Gerenciador de Comércio. A miniatura deste item será usada como a imagem de cabeçalho da mensagem. Se o objeto |
|
String | Número de telefone do cliente. |
|
curl 'https://graph.facebook.com/v17.0/106540352242922/messages' \ -H 'Content-Type: application/json' \ -H 'Authorization: Bearer EAAJB...' \ -d ' { "messaging_product": "whatsapp", "recipient_type": "individual", "to": "+16505551234", "type": "interactive", "interactive": { "type": "catalog_message", "body": { "text": "Hello! Thanks for your interest. Ordering is easy. Just visit our catalog and add items to purchase." }, "action": { "name": "catalog_message", "parameters": { "thumbnail_product_retailer_id": "2lc20305pt" } }, "footer": { "text": "Best grocery deals on WhatsApp!" } } }'
{ "messaging_product": "whatsapp", "contacts": [ { "input": "+16505551234", "wa_id": "16505551234" } ], "messages": [ { "id": "wamid.HBgLMTY1MDM4Nzk0MzkVAgARGBI0ODVEREUwQzEzQkVBRjQ1RUUA" } ] }
As mensagens de modelo de catálogo contêm um botão que, quando tocado, exibe seu catálogo de produtos no WhatsApp.
Consulte Modelos de catálogo para saber como criar e enviar esses modelos.
Você pode direcionar o usuário para o catálogo completo de produtos ao criar um link wa.me e incluí-lo em uma mensagem de texto padrão. Ao enviar uma mensagem de texto, você pode usar a preview_url
opcional definida como true
para renderizar um conjunto de miniaturas do catálogo de produtos de qualquer URL na string body
da mensagem.
Se você desabilitar o catálogo, os links wa.me e o botão Ver catálogo nas mensagens com um link para os produtos exibirão o aviso Link de catálogo inválido quando tocados.
Para criar um link wa.me, anexe o número de telefone comercial da empresa, incluindo o código do país, ao final da string a seguir:
https://wa.me/c/
Por exemplo:
https://wa.me/c/15555455657
Com os modelos de mensagem multiproduto, você pode apresentar informações sobre até 30 produtos do seu catálogo de comércio eletrônico, organizados por seções personalizáveis.
Consulte Multi-Product Message Templates para saber como criar e enviar esses modelos.
As mensagens de produto único e de multiproduto são interativas.
Exemplo de mensagem multiproduto: | Exemplo de mensagem de produto único: |
Menu exibido quando o usuário clica em Começar a comprar: | Exemplo de página de detalhes do produto: |
Os clientes que recebem mensagens multiproduto ou de produto único podem realizar três ações principais:
Se um cliente tiver diferentes aparelhos vinculados à mesma conta, as mensagens multiproduto e de produto único serão sincronizadas entre eles. No entanto, o carrinho de compras é configurado localmente para cada dispositivo específico. Consulte Experiência do carrinho de compras para saber mais.
No momento, é possível receber esses tipos de mensagem nas seguintes plataformas:
Se a versão do app do cliente não for compatível com as mensagens multiproduto e de produto único, será enviado um aviso explicando que o usuário não conseguiu receber a mensagem porque está usando uma versão desatualizada do WhatsApp. Você também receberá uma notificação de webhook para informar que a mensagem não pôde ser entregue porque o cliente está usando uma versão desatualizada do app.
As mensagens multiproduto e de produto único podem ser:
As mensagens multiproduto e de produto único não podem ser:
Ao contrário das mensagens de produto enviadas por meio do app WhatsApp Business, as enviadas com a API de Nuvem não exibem um ícone de carrinho de compras no cabeçalho do tópico da conversa.
Pode ser que você precise atualizar as propriedades de itens no seu catálogo. Veja abaixo as propriedades atualizadas e a forma como lidamos com qualquer mensagem que mencione o produto em questão:
Propriedade atualizada | Processo de atualização |
---|---|
Preço, título, descrição e imagem do produto. |
|
Alteração na disponibilidade |
|
Depois de visualizar os produtos, um cliente poderá adicioná-los ao carrinho de compras e enviar esse carrinho para você. Em atividades de comércio realizadas no WhatsApp, um carrinho de compras precisa ter as seguintes características:
Os clientes podem colocar até 99 unidades de um mesmo item do catálogo em um carrinho de compras, mas não há um limite para a inclusão de itens diferentes.
Não será possível fazer edições após o envio do carrinho. Os clientes poderão enviar um novo carrinho se precisarem de outros itens ou quiserem alterar o pedido. Não é permitido enviar carrinhos para os clientes.
As mensagens multiproduto e de produto único ajudam a oferecer experiências de usuário simples e personalizadas. Isso porque é melhor para o cliente ser direcionado a um subconjunto de itens relevantes para ele do que navegar por todo o seu inventário de produtos.
Combinar esses recursos com ferramentas de navegação (como PLN, pesquisa de texto ou lista de mensagens e botões de resposta) permite à empresa chegar rapidamente ao que o cliente está procurando.
Com um preenchimento dinâmico, as mensagens podem ser personalizadas para cada cliente ou situação. Por exemplo, você pode mostrar uma mensagem multiproduto com os itens mais pedidos por um cliente.
É um canal de alto desempenho para impulsionar os pedidos. Durante a fase de testes, as empresas tiveram uma conversão média de 7% de mensagens multiproduto enviadas para carrinhos recebidos.
Para usar as mensagens interativas, não é preciso aplicar modelos nem receber aprovações prévias. Elas são geradas em tempo real e sempre incluem os detalhes mais recentes de itens, preços e níveis de estoque do seu inventário.
As mensagens multiproduto são a melhor opção para direcionar os clientes a um subconjunto específico do seu inventário. Confira os casos de uso:
As mensagens de produto único são a melhor opção para direcionar os clientes a um item específico do seu inventário porque oferecem respostas rápidas a partir de um conjunto limitado de opções. Confira os casos de uso:
Os dois recursos também podem ser usados como parte de um fluxo de agente humano. Contudo, será preciso criar o conjunto de ferramentas para permitir que o agente humano gere uma mensagem multiproduto ou de produto único no tópico.
Antes de enviar mensagens de produto, siga as orientações mais adequadas às suas necessidades:
Todas as chamadas de API mencionadas neste guia precisam ser autenticadas com um token de acesso. Os desenvolvedores podem autenticar as chamadas de API com o token de acesso gerado em Painel de Apps > WhatsApp > Configuração da API. Os parceiros de soluções devem fazer a autenticação usando um token de acesso com a permissão whatsapp_business_messaging.
Para enviar uma mensagem de produto único, crie um objeto interactive
do tipo product
com estes componentes:
Componentes obrigatórios | Componentes opcionais |
---|---|
|
|
Consulte Messages, Interactive Object para ver mais informações. Ao final do processo, o objeto interativo deverá ter esta aparência:
{ "messaging_product": "whatsapp", "recipient_type": "individual", "to": "PHONE_NUMBER", "type": "interactive", "interactive": { "type": "product", "body": { "text": "BODY_TEXT" }, "footer": { "text": "FOOTER_TEXT" }, "action": { "catalog_id": "CATALOG_ID", "product_retailer_id": "ID_TEST_ITEM_1" } } }
Para enviar mensagens multiproduto, crie um objeto interactive
do tipo product_list
com estes componentes:
Componentes obrigatórios | Componentes opcionais |
---|---|
|
|
Consulte Messages, Interactive Object para ver mais informações. Ao final do processo, o objeto interativo deverá ter esta aparência:
{ "messaging_product": "whatsapp", "recipient_type": "individual", "to": "PHONE_NUMBER", "type": "interactive", "interactive": { "type": "product_list", "header":{ "type": "text", "text": "HEADER_CONTENT" }, "body": { "text": "BODY_CONTENT" }, "footer": { "text": "FOOTER_CONTENT" }, "action": { "catalog_id": "CATALOG_ID", "sections": [ { "title": "SECTION_TITLE", "product_items": [ { "product_retailer_id": "PRODUCT-SKU" }, { "product_retailer_id": "PRODUCT-SKU" }, ... ] }, { "title": "SECTION_TITLE", "product_items": [ { "product_retailer_id": "PRODUCT-SKU" }, { "product_retailer_id": "PRODUCT-SKU" }, ... ] } ] } } }
Se nenhum dos itens fornecidos nas chamadas de API acima corresponder a um produto do seu catálogo, encaminharemos um aviso de erro, e a mensagem multiproduto ou de produto único não será enviada ao usuário.
Em mensagens multiproduto, pelo menos um item da lista de produtos deve corresponder a um item do seu catálogo. Nesse caso:
Assim que o objeto interativo estiver pronto, anexe os outros parâmetros que compõem uma mensagem: recipient_type
, to
, messaging_product
e type
. Lembre-se de definir type
como interactive
.
curl -X POST https://graph.facebook.com/v20.0
/FROM_PHONE_NUMBER/messages \
-H 'Authorization: Bearer ACCESS_TOKEN' \
- d '{
"messaging_product": "whatsapp",
"recipient_type": "individual",
"to": "PHONE_NUMBER",
"type": "interactive",
"interactive": {
// INTERACTIVE OBJECT GOES HERE
}'
Para ver todos os parâmetros disponíveis, consulte Reference, Messages.
Envie uma chamada POST para o ponto de extremidade /PHONE_NUMBER_ID/messages
com o objeto JSON criado nas etapas 1 e 2. Caso a mensagem seja enviada com sucesso, você receberá a seguinte resposta:
{ "messaging_product": "whatsapp", "contacts": [{ "input": "PHONE_NUMBER", "wa_id": "WHATSAPP_ID", }] "messages": [{ "id": "wamid.ID", }] }