Compartilhar produtos com os clientes

Há várias formas de compartilhar produtos com seus clientes:

• Mensagens de catálogo: mensagens em formato livre com um botão que, quando tocado, exibe seu catálogo de produtos no WhatsApp.
• Mensagens de modelo de catálogo: mensagens de modelo com um botão que, quando tocado, exibe seu catálogo de produtos no WhatsApp.
• Mensagens com um link para o catálogo: mensagens em formato livre que exibem miniaturas do catálogo e um link para o inventário completo de produtos.
• Mensagens de produto: mensagens em formato livre que contêm informações sobre um único produto ou até 30 produtos do catálogo.
• Modelos de mensagem multiproduto: modelos que contêm informações sobre até 30 produtos do catálogo de comércio eletrônico (organizados em até 10 seções) em uma única mensagem.

Mensagens de catálogo

As mensagens de catálogo têm formato livre e permitem 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.

Requisitos

Você precisa ter um inventário carregado na Meta em um catálogo de comércio eletrônico conectado à sua conta do WhatsApp Business.

Sintaxe da solicitação

Use o ponto de extremidade WhatsApp Business Phone Number > Messages para enviar uma mensagem de catálogo.

POST /<WHATSAPP_BUSINESS_PHONE_NUMBER_ID>/messages

Corpo da publicação

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

Propriedades

Exemplo de solicitação

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!"
    }
  }
}'

Exemplo de resposta

{
  "messaging_product": "whatsapp",
  "contacts": [
    {
      "input": "+16505551234",
      "wa_id": "16505551234"
    }
  ],
  "messages": [
    {
      "id": "wamid.HBgLMTY1MDM4Nzk0MzkVAgARGBI0ODVEREUwQzEzQkVBRjQ1RUUA"
    }
  ]
}

Mensagens de modelo de catálogo

As mensagens de modelo de catálogo contêm um botão que, quando tocado, exibe seu catálogo de produtos no WhatsApp.

Para enviar esse tipo de mensagem, você precisa ter um modelo de catálogo. Consulte o documento Catalog Templates para saber como criar esses modelos e enviá-los em uma mensagem.

Mensagens com um link para o catálogo

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

Mensagens de produto

As mensagens de produto único e de vários produtos são do tipo interactive.

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:

Visão geral

Os clientes que recebem mensagens multiproduto ou de produto único podem realizar três ações principais:

1. Ver produtos: os clientes podem ver uma lista de itens ou apenas um produto. Quando um cliente clica em um produto específico, buscamos as informações mais recentes sobre o item e exibimos uma página de detalhes do produto (PDP). No momento, as PDPs são compatíveis apenas com imagens. Ou seja, vídeos e/ou GIFs adicionados ao produto não serão exibidos nesse tipo de página.
2. Adicionar produtos ao carrinho: sempre que um usuário adiciona um produto ao carrinho de compras, buscamos as informações mais recentes sobre o item. Caso haja uma mudança de status relacionada a um dos itens, exibiremos um diálogo com a mensagem "Um ou mais itens do seu carrinho foram atualizados". Consulte Atualizações de produtos para saber mais. Um carrinho é mantido em um tópico da conversa com o cliente até ser enviado a você. Consulte Experiência do carrinho de compras para saber mais.
3. Enviar o carrinho de compras para você: depois de adicionar todos os itens necessários, os clientes podem enviar o carrinho para você. Depois disso, você pode definir os próximos passos, como solicitar informações para a entrega ou oferecer opções de pagamento.

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:

• iOS: 2.21.100 (multiproduto) e 2.21.210 (produto único).
• Android: 2.21.9.15 (multiproduto) e 2.21.19 (produto único).
• web: o cliente web compatível com esses recursos já foi lançado.

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.

Comportamento esperado das mensagens

As mensagens multiproduto e de produto único podem ser:

• encaminhadas de um usuário para outro;
• reabertas por um usuário dentro da mesma conversa.

As mensagens multiproduto e de produto único não podem ser:

• enviadas como notificações. Elas só podem ser enviadas como parte de conversas existentes.

Limitações

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.

Atualizações de produtos

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:

Experiência do carrinho de compras

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:

• Ser exclusivo de um tópico da conversa entre o cliente e a empresa em um aparelho específico: somente um carrinho é criado por tópico de conversa entre você e o cliente. Além disso, os carrinhos não são mantidos em diferentes aparelhos. Assim que um carrinho é enviado, o cliente pode abrir outro e iniciar o processo novamente.
• Não ter data de validade: o carrinho fica disponível no tópico da conversa até ser enviado para você. Após o envio, os itens são removidos do carrinho.

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.

Exemplo de experiência de carrinho de compras e comportamento esperado na alteração de status de um item.

Por que usar

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.

Simples e eficiente

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.

Pessoal

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.

Resultados de negócios

É 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.

Sem modelos

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.

Quando usar

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:

• Comprar por meio de conversas. Por exemplo, usar a funcionalidade de pesquisa para permitir que os clientes digitem uma lista de compras e enviar uma mensagem multiproduto como resposta.
• Navegar para uma categoria específica. Por exemplo, roupas de ginástica.
• Enviar ofertas ou recomendações personalizadas.
• Repetir pedidos de itens realizados anteriormente. Por exemplo, um usuário pode repetir um pedido de menos de 30 itens feito regularmente.

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:

• Responder a um pedido específico do cliente.
• Enviar uma recomendação.
• Repetir o pedido de um item realizado anteriormente.

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.

Primeiros passos

Antes de enviar mensagens de produto, siga as orientações mais adequadas às suas necessidades:

• Get Started for people developing for themselves or their organization
• Get Started for Solution Partners

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.

Etapa 1: criar o objeto interativo

Mensagens de produto único

Para enviar uma mensagem de produto único, crie um objeto interactive do tipo product com estes componentes:

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

Mensagens multiproduto

Para enviar mensagens multiproduto, crie um objeto interactive do tipo product_list com estes componentes:

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" },
            ...
          ]
        }
      ]
    }
  }
}

Itens ausentes

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. Então:

• as mensagens serão enviadas com sucesso;
• itens sem correspondência serão descartados;
• você receberá uma mensagem de erro solicitando a atualização do catálogo.

Etapa 2: adicionar parâmetros de mensagem comuns

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/v19.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.

Etapa 3: enviar uma solicitação ao ponto de extremidade de mensagens

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

Modelos de mensagem multiproduto

É preciso ter um modelo multiproduto para enviar esse tipo de mensagem. Consulte o documento Multi-Product Message Templates para saber como criar esses modelos e enviá-los em uma mensagem.