Resumen

¿Desea enviar mensajes de pedido personalizados directamente al WhatsApp de sus clientes usando la API de Wati? Esta guía le explica cómo utilizar el endpoint POST /api/v1/order_details_template para enviar un mensaje estructurado que incluya artículos del pedido, precios y opciones de pago. También encontrará una carga útil (payload) de ejemplo para ayudarle a comenzar rápidamente.

Instrucciones

Endpoint

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

El endpoint order_details_template le permite enviar un mensaje de plantilla con los detalles del pedido al WhatsApp de un cliente. Puede incluir uno o más artículos en el mensaje, especificar el precio y vincularlo a una pasarela de pago como PayU, Razorpay, etc.

Nota: Este endpoint de API está actualmente disponible en Beta Privada y solo es accesible para clientes seleccionados. Contacte al equipo de soporte de Wati si necesita acceso.

Wati también proporciona endpoints de API que no requieren plantilla para las operaciones de pedidos de WhatsApp Pay, incluyendo order_status y order_details. Estos endpoints están disponibles por separado de las API basadas en plantillas. Para obtener más información sobre estos endpoints, consulte la Documentación para Desarrolladores de Wati.

Paso 1: Localice su endpoint de API

Puede encontrar su endpoint de API específico en su cuenta de Wati. Vaya a Connectors > API Tokens. Se verá algo así: https://live-mt-server.wati.io

Su endpoint final para enviar el pedido será:

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

Paso 2: Comprenda la importancia del reference_id

Cada mensaje de pedido debe incluir un reference_id único. Usted genera este valor y lo utiliza para rastrear cada pedido. No debe haber dos pedidos con el mismo reference_id.

Paso 3: Estructure su carga útil (payload)

Aquí tiene una carga útil de ejemplo que muestra cómo formatear su order_details_template. Puede personalizar campos como el nombre del producto, precio, detalles del importador y la configuración de pago según sea necesario.

Carga útil de ejemplo

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

  • Moneda y offsets: Los valores de monto utilizan un sistema de offset (ejemplo: value: 21000 y offset: 100 = ₹210.00).

  • Detalles del producto: Puede enviar varios productos en un solo mensaje.

  • Encabezado de imagen: Proporcione una URL de medios válida para mostrar una imagen en la parte superior del mensaje.

  • Pasarela de pago: Las pasarelas de pago soportadas por Facebook son, por ejemplo: Razorpay, Payu, Zaakpay y Billdesk.

Cómo vincular su cuenta de pago a Facebook

Para recibir pagos en WhatsApp, necesita vincular su pasarela de pago a su cuenta de WhatsApp Business mediante una configuración de pago.

Aquí tiene un breve recorrido visual:

Cómo crear una plantilla de detalles de pedido en Wati

¿Quiere enviar información de pedidos a sus clientes de forma rápida y clara? Utilice la plantilla de Order Details (Detalles del pedido) en Wati para diseñar y enviar mensajes estructurados. Esta guía le guía por los pasos para crear una en solo unos clics.

Siga estos pasos para configurar una plantilla de Detalles del pedido en Wati:

1. Inicie sesión en su cuenta de Wati.

2. Vaya a Campaigns y seleccione Template Messages.

3. Haga clic en New Template Message.

4. Introduzca un nombre para su plantilla para que pueda encontrarla fácilmente más tarde.

5. En Category, elija Marketing o Utility.

6. Seleccione el idioma en el que desea que esté la plantilla.

7. En Select Marketing Template, elija Order Details.

8. Elija cómo quiere que comience el mensaje:

  • Para añadir un título de texto o imagen, seleccione Text o Image bajo Campaign title.

  • Si prefiere omitir el título y comenzar con el cuerpo, elija None bajo Campaign title.

9. Introduzca el contenido del cuerpo: este es el mensaje principal que verá su cliente.

10. Una vez que todo se vea bien, haga clic en Save and Submit.

¡Eso es todo! Su plantilla de Detalles del pedido ya está lista para usarse en sus campañas.

Nota: Puede crear la plantilla de Detalles del pedido tanto en la categoría de Marketing como en la categoría de plantillas de Utilidad (Utility).

Did this answer your question?