Resumo

Deseja enviar mensagens de pedido personalizadas diretamente para o WhatsApp do seu cliente usando a API do Wati? Este guia mostra como usar o endpoint POST /api/v1/order_details_template para enviar uma mensagem estruturada que inclui itens do pedido, preços e opções de pagamento. Você também encontrará um payload de exemplo para começar rapidamente.

Instruções

Endpoint

POST https://{your-account-endpoint}/api/v1/order_details_template

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

Nota: Este endpoint da API está disponível atualmente em Beta Privado e é acessível apenas para clientes selecionados. Entre em contato com a equipe de suporte do Wati se precisar de acesso.

O Wati também fornece endpoints de API que não utilizam modelos para operações de pedidos com WhatsApp Pay, incluindo order_status e order_details. Esses endpoints estão disponíveis separadamente das APIs baseadas em modelos. Para obter mais informações sobre esses endpoints, consulte a Documentação do Desenvolvedor do Wati.

Passo 1: Localize seu endpoint de API

Você pode encontrar seu endpoint de API específico em sua conta Wati. Vá para Connectors > API Tokens. Ele será parecido com isto: https://live-mt-server.wati.io

Seu endpoint final para enviar o pedido será:

POST https://{your-account-endpoint}/api/v1/order_details_template

Passo 2: Entenda a importância do reference_id

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

Passo 3: Estruture seu payload

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

Payload de exemplo

curl --request POST \
--url https://live-mt-server.wati.io/{tenantId}/api/v1/order_details_template
--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

  • Moeda e offsets: Os valores monetários usam um sistema de offset (ex: value: 21000 e offset: 100 = ₹210.00).

  • Detalhes do produto: Você pode enviar vários produtos em uma única 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: Os gateways de pagamento suportados 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 Comercial do WhatsApp por meio de uma configuração de pagamento.

Aqui está um breve passo a passo visual:

Como criar um modelo de Detalhes do Pedido no Wati

Deseja enviar informações de pedido de forma rápida e clara para seus clientes? Use o modelo de Detalhes do Pedido no Wati para criar e enviar mensagens estruturadas. Este guia mostra como criar um em apenas alguns cliques.

Siga estas etapas para configurar um modelo de Detalhes do Pedido no Wati:

1. Faça login na sua conta Wati.

2. Vá para Campaigns e selecione Template Messages.

3. Clique em New Template Message.

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

5. Em Category, escolha Marketing ou Utility.

6. Selecione o idioma que você deseja para o modelo.

7. Em Select Marketing Template, escolha Order Details.

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

  • Para adicionar um texto ou imagem como título, selecione Text ou Image em Campaign title.

  • Se preferir pular o título e começar com o corpo da mensagem, escolha None em Campaign title.

9. Digite o conteúdo do corpo da mensagem — esta é a mensagem principal que seu cliente verá.

10. Quando tudo estiver pronto, clique em Save and Submit.

É isso! Seu modelo de Detalhes do Pedido já está pronto para ser usado em suas campanhas.

Nota: Você pode criar o modelo de Detalhes do Pedido tanto na categoria Marketing quanto na categoria Utility.

Did this answer your question?