Ir al contenido principal

Cómo enviar un mensaje de orden utilizando la API de plantillas de detalles del pedido

Actualizado hace más de 2 semanas

Resumen

¿Quieres enviar mensajes personalizados de pedidos directamente a WhatsApp de tu cliente utilizando la API de Wati? Esta guía te explica cómo usar el endpoint POST /api/v1/order_details_template para enviar un mensaje estructurado que incluya elementos del pedido, precios y opciones de pago. También encontrarás un payload de ejemplo para ayudar a que comiences rápidamente.

Endpoint

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

El endpoint order_details_template te permite enviar un mensaje de plantilla de detalles de pedido a WhatsApp de tu cliente. Puedes incluir uno o más elementos en el mensaje, especificar precios y vincularlo a una pasarela de pago como PayU, Razorpay, etc.

Paso 1: Busca tu endpoint de la API

Puedes encontrar tu endpoint de la API específico en la sección /api-docs de tu cuenta de Wati. Se verá algo así: https://live-server-xxxx.wati.io.

Tu endpoint final para enviar el pedido será:

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

Paso 2: Entiende la importancia de reference_id

Todos los mensajes de pedido deben incluir un único reference_id. Tú generas este valor y lo usas para rastrear cada pedido. No deben haber dos pedidos con el mismo reference_id.

Paso 3: Estructura tu payload

Aquí tienes un payload de ejemplo que muestra cómo idiomas formato tu order_details_template. Puedes personalizar campos como el nombre del producto, el precio, los detalles del importador y la configuración de pago según sea necesario.

Payload de ejemplo

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"
, < br>"value": "Madhavan"
},
{ < br>"name": "discount", < br>"value": "60%" < br>} < br>], < br>"order_details": { < br>"reference_id": "yzn-test-6", < br>"type": "digital-goods", < br>"payment_configuration": "razorpay_test_payment_2", < br>"payment_type": "payment_gateway:razorpay", < br>"currency": "INR", < br>"total_amount": { < br>"offset": 100, < br>"value": 100 < br>}, < br>"order": { < br>"discount": { < br>"offset": 100, < br>"value": 100 < br>}, < br>"items": [ < br>{ < br>"amount": { < br>"offset": 100, < br>"value": 100 < br>}, < br>"name": "ORDER_ITEM_NAME", < br>"quantity": 1, < br>"retailer_id": "ORDER_ITEM_RETAILER_ID", < br>"country_of_origin": "ORIGIN_COUNTRY", < br>"importer_name": "IMPORTER_NAME", < br>"importer_address": { < br>"address_line1": "IMPORTER_ADDRESS", < br>"city": "CITY", < br>"country_code": "COUNTRY", < br>"postal_code": "ZIP_CODE" < br>} < br>} < br>], < br>"shipping": { < br>"offset": 100, < br>"value": 0 < br>}, < br>"status": "pending", < br>"subtotal": { < br>"offset": 100, < br>"value": 100 < br>}, < br>"tax": { < br>"offset": 100, < br>"value": 100 < br>} < br>} < br>}
}'

Notas

  • Moneda y desplazamientos: Los valores de las cantidades usan un sistema de desplazamiento (por ejemplo, valor: 21000 y desplazamiento: 100 = ₹210.00).

  • Detalles del producto: Puedes enviar múltiples productos en un solo mensaje.

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

  • Pasarela de pago: La Pasarela de Pago admitida por Facebook, por ejemplo: Razorpay, Payu, Zaakpay y Billdesk.

Cómo vincular tu cuenta de pago a Facebook

Para recibir pagos en WhatsApp, necesitas vincular tu pasarela de pago a tu Cuenta de Negocios de WhatsApp a través de una configuración de pago.

Aquí tienes un rápido recorrido visual:

Cómo crear una plantilla de detalle de pedidos en Wati

¿Quieres enviar la información de los pedidos de forma rápida y clara a tus clientes? Usa la plantilla Detalles del Pedido en Wati para diseñar y enviar mensajes estructurados. Esta guía te explica los pasos para crear uno en solo unos pocos clics.

Sigue estos pasos para configurar una plantilla de Detalles de Pedido en Wati:

1. Inicia sesión en tu cuenta de Wati.

2. Ve a Transmisiones y selecciona Tus plantillas.

3. Haz clic en Nueva plantilla de mensaje.

4. Ingresa un nombre para tu plantilla para poder encontrarla más adelante fácilmente.

5. En Categoría, elige Marketing o Utilidad.

6. Selecciona el idioma que desees que tenga la plantilla.

7. En Seleccionar plantilla de marketing, elige Detalles del pedido.

8. Elige cómo quieres que comience el mensaje:

  • Para agregar texto o imagen como título, selecciona Texto o Imagen en Título de transmisión.

  • Si prefieres omitir el título y comenzar con el cuerpo, elige Ninguno en Título de transmisión.

9. Ingresa el contenido del cuerpo de mensaje—este es el mensaje principal que verá tu cliente.

10. Una vez que todo se vea bien, haz clic en Guardar y enviar.

¡Listo! Ahora tu plantilla de Detalles del Pedido está lista para usarse en tus campañas.

Nota: Puedes crear la plantilla de Detalles del Pedido debajo de la categoría de Plantillas de Marketing y también la de Utilidad.

¿Ha quedado contestada tu pregunta?