Mensagens interativas do WhatsApp para produtos únicos ou multiprodutos

O que é uma mensagem de produto?

As mensagens de produto permitem ao negócio exibir produtos e serviços a seus clientes sem sair do aplicativo WhatsApp.

Vamos entender em mais detalhe os tipos de mensagens de produto:

• Mensagens de multiprodutos: Mensagens contendo uma seleção de até 30 itens de um inventário da loja.
• Mensagens de produto único: Mensagens com um só produto do inventário da loja. O produto é exibido no formato Página de detalhes do produto (PDP).

Tanto as mensagens de multiprodutos quanto as de produto único são mensagens do tipo sessão interativa. Isso quer dizer que, diferentemente das mensagens de template, elas não precisam ser aprovadas pelo WhatsApp. Elas podem ser enviadas como notificação, mas apenas como parte de uma conversa já existente.

Ao receber mensagens de multiprodutos ou produtos únicos, o usuário pode realizar três ações principais:

• Ver produtos: O consumidor pode ver uma lista de produtos ou um só produto. Sempre que o usuário clica em um item específico, o WhatsApp obtém as informações mais recentes daquele produto e o exibem em formato de Página de detalhes do produto (PDP). No momento, as PDPs só permitem imagens dos produtos — vídeos e/ou GIFs adicionados ao produto não aparecem na PDP.
• Adicionar produtos ao carrinho: Sempre que o usuário adiciona um produto ao carrinho de compras, o WhatsApp obtém as informações mais recentes do item. Se tiver ocorrido uma mudança de status em qualquer dos itens, o WhatsApp mostra um diálogo dizendo “Um ou mais dos itens no seu carrinho foram atualizados”. Veja a seção Atualizações de produto abaixo para mais informações. O carrinho continua no bate-papo entre a loja e o cliente até que o carrinho seja enviado à loja. Veja a seção Experiência de carrinho abaixo para mais detalhes.
• Enviar carrinho para a loja: Depois de adicionar todos os itens desejados, o cliente pode enviar um carrinho para a loja com a qual está trocando mensagens. A essa altura, a loja pode definir os próximos passos — por exemplo, solicitar informações para frete ou dar opções de pagamento.

Se um cliente tem vários dispositivos ligados à mesma conta de WhatsApp, as mensagens de multiprodutos e produtos únicos são sincronizadas nos dispositivos. No entanto, o carrinho de compras é local para cada dispositivo específico. Veja a seção Experiência de carrinho abaixo para mais detalhes.

No momento, estes tipos de mensagens podem ser recebidos nas seguintes plataformas:

• iOS: 2.21.100 (mensagens de multiprodutos) e 2.21.210 (mensagens de produto único).
• Android: 2.21.9.15 (mensagens de multiprodutos) e 2.21.19 (mensagens de produto único).
• Web: O cliente web compatível com estes recursos já foi lançado.

Se a versão do aplicativo do destinatário não for compatível com mensagens de multiprodutos ou produtos únicos, a loja recebe uma notificação de webhook mostrando erro e descrevendo por que a mensagem não pôde ser enviada.

Atualizações de produtos

Pode ser necessário para a loja atualizar as propriedades dos itens em seu catálogo. Dependendo da propriedade atualizada, é assim que lidamos com mensagens mencionando o produto:

Experiência de carrinho

Depois de ver os produtos, o cliente pode adicioná-los ao seu carrinho de compras e enviar o carrinho para a loja. Para fins de comércio no WhatsApp, um carrinho de compras:

• É exclusivo do bate-papo entre loja e cliente em um dispositivo específico: Só é criado um carrinho por bate-papo entre cliente e loja, e os carrinhos não ficam disponíveis em vários dispositivos. Após o carrinho ser enviado, o cliente pode abrir outro carrinho com a loja e começar o processo novamente.
• Não tem data de expiração: O carrinho fica no bate-papo até ser enviado à loja. Após ser enviado, o carrinho é esvaziado.

O cliente pode adicionar até 99 unidades de cada item individual num catálogo a seu carrinho, mas não há limite para a quantidade de itens diferentes que podem ser adicionados a um carrinho.

Uma vez que o carrinho é enviado, não é mais possível fazer edições. O cliente pode enviar um novo carrinho caso precise de novos itens ou queira mudar algo em seu pedido. A loja não pode enviar carrinhos a seus clientes.

Pré-requisitos para enviar uma mensagem de produto

1.    Crie um catálogo e adicione itens a ele

1. Siga este guia caso ainda não tenha criado um catálogo. Caso contrário, passe para a segunda etapa.

2.    Atribua ao catálogo um negócio associado

A. Dado que as contas de WhatsApp Business são criadas pelo BSP (provedor) e o catálogo é criado por comerciantes/ISVs/lojas, é necessário adicionar o BSP ao catálogo como negócio associado. Para isso, siga os seguintes passos:

1. 1. 1. 1. Abra as configurações do negócio e selecione o seu negócio.
         2. Selecione Fontes de dados.
         3. Selecione Catálogos e a seguir o nome do seu catálogo.
         4. Selecione Atribuir parceiros.
         5. Selecione ID do negócio
         6. Insira um ID de negócio como 1900820339959633 e, sob a seção de permissões Controle total, selecione a opção Gerenciar catálogo. Após terminar, clique em Próximo e depois em Fechar.

B. Após a solicitação ter sido enviada, escreva para devsupport@gupshup.io com o assunto: Approve Catalog request: <<Nome do aplicativo>>. O corpo do e-mail deve conter o nome do catálogo e o ID. Nós aprovaremos a solicitação de parceiro e também conectaremos o catálogo ao aplicativo no ar mencionado no assunto do e-mail. : Somente 1 catálogo pode ser associado a uma conta de WhatsApp Business.

3. Se a conta WABA for indiana (prefixo telefônico +91), é necessário o consentimento do e-commerce: Compartilhe os detalhes abaixo com a Gupshup no mesmo e-mail registrado com a sua WABA:

Entidade/negócio Detalhes:

Cliente Atenção Detalhes:

Reclamação Encarregado Detalhes:

Obs.: Para mais informações, clique aqui. Por exemplo, como cumprir com as leis para vendas online na Índia usando a API do WhatsApp Business.

Especificação da API para envio de mensagens de produto

Endpoint da API:

POST https://api.gupshup.io/sm/api/v1/msg

Cabeçalhos

Payload de solicitação comum

Objeto payload da mensagem

Exemplo de mensagem de produto único:

{
    "type": "product_details",
    "subType": "product",
    "catalogId": "558215241949699",
    "destination": "9184********",
    "productId": "2v3fh1axoq",
    "body": {
        "text": "body content!"
    },
    "footer": {
        "text": "footer content!"
    }
}

Exemplo de mensagem de multiprodutos:

CURL

curl --location --request POST 'https://api.gupshup.io/sm/api/v1/msg' \
--header 'apikey: xxxxxxxxxxxx' \

--header 'content-type: application/x-www-form-urlencoded' \
--data-urlencode 'channel=whatsapp' \
--data-urlencode 'source=553598XXXX29' \
--data-urlencode 'destination=91996XXXX68' \
--data-urlencode 'message={
  "type": "product_details",
  "subType": "product_list",
  "catalogId": "1598140273855917",
  "productId": "",
  "destination": "919964XXX68",
  "body": {
    "text": "body content!"
  },
  "header": {
    "type": "text",
    "text": "header content!"
  },
  "footer": {
    "text": "footer content!"
  },
  "sections": [
    {
      "title": "",
      "productList": [
        {
          "productId": "559iac23i3"
        },
        {
          "productId": "c358j92ic3"
        }
      ]
    }
  ]
}' \
--data-urlencode 'src.name=Gersjdn'

Mensagem recebida:

A consulta por um produto:

{
    "app": "Extra9",
    "timestamp": 1637840344966,
    "version": 2,
    "type": "message",
    "payload": {
        "id": "ABEGkZlpNARoAgo-sKGeURk3EWXT",
        "source": "919969340468",
        "type": "text",
        "payload": {
            "text": "Hello"
        },
        "sender": {
            "phone": "919969340468",
            "name": "Omkar Mestry",
            "country_code": "91",
            "dial_code": "9969340468"
        }
    }
}

Pedido realizado:

{
    "app": "DemoApp",
    "timestamp": 1590854464792,
    "version": 2,
    "type": "order",
    "payload": {
        "id": "ABEGkYaYVSEEAgo-sMx1DoUoQJRW",
        "source": "918x98xx21x4",
        "type": "text",
        "payload": {
            "text": "hi"
        },
        "sender": {
            "phone": "918x98xx21x4",
            "name": "Smit",
            "country_code": "91",
            "dial_code": "8x98xx21x4"
        },
        "context": {
            "catalog": {
                "id": "",
                "order": {
                    "items": [
                        {
                            "id": "",
                            "currency": "",
                            "amount": "",
                            "quantity": ""
                        },
                        {
                            "id": "",
                            "currency": "",
                            "amount": "",
                            "quantity": ""
                        }
                    ]
                }
            }
        }
    }

Objeto payload de mensagem recebida: