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 inclua itens do pedido, preços e opções de pagamento. Você também encontrará uma carga de exemplo para ajudá-lo a começar rapidamente.
Endpoint
POST https://{your-account-endpoint}/api/v1/order_details_template
O endpoint order_details_template permite enviar 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 vincular a um gateway de pagamento como PayU, Razorpay, etc.
Passo 1: Localize seu endpoint da API
Você pode encontrar seu endpoint da API específico na seção /api-docs da sua conta no Wati. Parecerá algo assim: https://live-server-xxxx.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 único reference_id. Você gera este valor e o usa para rastrear cada pedido. Dois pedidos não devem ter o mesmo reference_id.
Passo 3: Estruture sua carga útil
Aqui está uma carga útil 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.
Exemplo de carga útil
curl --location 'https://mt-dev-gke-server.watiapp.io/103128/api/v1/order_deta
--header 'Authorization: Bearer eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJqd
--header 'Content-Type: application/json' \
--data '{
"phone_number": "918606328257",
"template_name": "order_details_template_yzn_1",
"language_code": "en_US",
"is_broadcast": 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": [
{
"amount": {
"offset": 100,
"value": 100
},
"name": "ORDER_ITEM_NAME",
"quantity": 1,
"retailer_id": "ORDER_ITEM_RETAILER_ID",
"country_of_origin": "ORIGIN_COUNTRY",
"importer_name": "IMPORTER_NAME",
"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 deslocamentos: Os valores das quantias usam um sistema de deslocamento (por exemplo, valor: 21000 e deslocamento: 100 = ₹210,00).
Detalhes do produto: Você pode enviar vários produtos em uma única mensagem.
Cabeçalho de imagem: Forneça um URL de mídia válido para exibir uma imagem no topo da mensagem.
Gateway de pagamento: O Gateway de Pagamento suportado pelo Facebook, como 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 tutorial visual:
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 do Pedido no Wati para criar e enviar mensagens estruturadas. Este guia orienta você nos passos para criar um em poucos cliques.
Siga estas etapas para configurar um modelo de Detalhes do Pedido no Wati:
1. Conecte-se à sua conta do Wati.
2. Vá para Transmissões e selecione Seus Modelos.
3. Clique em Nova Mensagem de Modelo.
4. Digite um nome para seu modelo para que você possa encontrá-lo facilmente depois.
5. Em Categoria, escolha Marketing ou Utilidade
6. Selecione o idioma que deseja que o modelo esteja.
7. Em Selecionar Modelo de Marketing, escolha Detalhes do Pedido.
8. Escolha como deseja que a mensagem comece:
Para adicionar um texto ou imagem como título, selecione Texto ou Imagem em Título da transmissão.
Se preferir pular o título e começar com o corpo, escolha Nenhum em Título da transmissão.
9. Digite o conteúdo do corpo—esta é a mensagem principal que seu cliente verá.
10. Quando tudo estiver pronto, clique em Salvar e Enviar.
Pronto! Seu modelo de Detalhes do Pedido está pronto para ser usado em suas campanhas.
Nota: Você pode criar o modelo de Detalhes do Pedido tanto na categoria de Marketing quanto de Modelo de Utilidade.