Resumo

Deseja enviar mensagens de pedido personalizadas diretamente para o WhatsApp do seu cliente usando a API Wati? Este guia o levará através de como usar o endpoint POST /api/v1/order_details_template para enviar uma mensagem estruturada que inclui itens de pedido, precificação e opções de pagamento. Você também encontrará uma carga de exemplo para ajudá-lo a começar rapidamente.

Nota: Transmissões agora são Campanhas – mesmo recurso poderoso, nome atualizado!

Ponto de Extremidade

POST https://{seu-ponto-de-extremidade-da-conta}/api/v1/order_details_template

O endpoint order_details_template permite que você envie uma mensagem de modelo de detalhes de pedido para o WhatsApp de um cliente. Você pode incluir um ou mais itens na mensagem, especificar precificação e vinculá-la a um gateway de pagamento como PayU, Razorpay, etc.

Etapa 1: Localize seu Ponto de Extremidade da API

Você pode encontrar seu ponto de extremidade da API específico na seção /api-docs em sua conta Wati. Ele terá uma aparência semelhante a esta: https://live-server-xxxx.wati.io

Seu ponto de extremidade final para enviar o pedido será:

POST https://{seu-ponto-de-extremidade-da-conta}/api/v1/order_details_template

Etapa 2: Entenda a Importância do reference_id

Cada mensagem de pedido deve incluir um reference_id único. Você gera este valor e o usa para rastrear cada pedido. Nenhum pedido deve ter o mesmo reference_id.

Etapa 3: Estruture sua Carga

Aqui está uma carga de exemplo mostrando como formatar seu order_details_template. Você pode personalizar campos como nome do produto, preço, detalhes do importador e configuração de pagamento conforme necessário.

Carga de Exemplo

curl --location 'https://mt-dev-gke-server.watiapp.io/103128/api/v1/order_deta' \
  --header 'Authorization: Bearer <TOKEN>' \
  --header 'Content-Type: application/json' \
  --data '{
    "phone_number": "918606328257",
    "template_name": "order_details_template_yzn_1",
    "language_code": "en_US",
    "is_campaign": true,
    "custom_params": [
      {
        "name": "name",
        "value": "Madhavan"
      },
      {
        "name": "discount",
        "value": "60%"
      }
    ],
    "order_details": {
      "reference_id": "yzn-test-6",
      "type": "digital-goods",
      "payment_configuration": "razorpay_test_payment_2",
      "payment_type": "payment_gateway:razorpay",
      "currency": "INR",
      "total_amount": {
        "offset": 100,
        "value": 100
      },
      "order": {
        "discount": {
          "offset": 100,
          "value": 100
        },
        "items": [
          {
            "name": "ORDER_ITEM_NAME",
            "quantity": 1,
            "retailer_id": "ORDER_ITEM_RETAILER_ID",
            "country_of_origin": "ORIGIN_COUNTRY",
            "importer_name": "IMPORTER_NAME",
            "amount": {
              "offset": 100,
              "value": 100
            },
            "importer_address": {
              "address_line1": "IMPORTER_ADDRESS",
              "city": "CITY",
              "country_code": "COUNTRY",
              "postal_code": "ZIP_CODE"
            }
          }
        ],
        "shipping": {
          "offset": 100,
          "value": 0
        },
        "status": "pending",
        "subtotal": {
          "offset": 100,
          "value": 100
        },
        "tax": {
          "offset": 100,
          "value": 100
        }
      }
    }
  }'

Notas

Mochas e offtes: Os valores de quantia usam um sistema de offtes (por exemplo, valor: 21000 e offt: 100 = ₹210,00).
Detalhes do produto: Você pode enviar vários produtos em uma mensagem.
Cabeçalho de imagem: Forneça uma URL de mídia válida para exibir uma imagem no topo da mensagem.
Gateway de pagamento: O Gateway de Pagamento suportado pelo Facebook, por exemplo: Razorpay, Payu, Zaakpay e Billdesk.

Como Vincular sua Conta de Pagamento ao Facebook

Para receber pagamentos no WhatsApp, você precisa vincular seu gateway de pagamento à sua Conta de Negócios do WhatsApp por meio de uma configuração de pagamento.

Aqui está uma rápida visualização:

Como Criar um Modelo de Detalhes de Pedido no Wati

Deseja enviar informações de pedido rapidamente e de forma clara para seus clientes? Use o Modelo de Detalhes de Pedido no Wati para projetar e enviar mensagens estruturadas. Este guia o levará através das etapas para criar um em apenas alguns cliques.

Siga estes passos para configurar um modelo de detalhes de pedido no Wati:

1. Faça login em sua conta Wati.

2. Vá para Campanhas e selecione Mensagens de Modelo.

3. Clique em Nova Mensagem de Modelo.

4. Insira um nome para seu modelo para que você possa encontrá-lo facilmente mais tarde.

5. Em Categoria, escolha Marketing ou Utilitário

6. Selecione o idioma que você deseja que o modelo esteja em.

7. Em Selecionar Modelo de Marketing, escolha Detalhes de Pedido.

8. Escolha como você deseja que a mensagem comece:

Para adicionar um texto ou imagem como título, selecione Texto ou Imagem em Título da Campanha.
Se você preferir pular o título e começar com o corpo, escolha Nenhum em Título da Campanha.

9. Insira seu contúdo do corpo — esta é a mensagem principal que seu cliente verá.

10. Uma vez que tudo pareça bom, clique em Salvar e Enviar.

Pronto! Seu modelo de detalhes de pedido agora está pronto para ser usado em suas campanhas.

Nota: Você pode criar o modelo de detalhes de pedido sob a categoria de Marketing, bem como a categoria de utilitário.

Como enviar uma mensagem de pedido usando a API do modelo de detalhes do pedido