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?