Detalles y estado de pedidos

​

Descripción general

• WhatsApp Order Details — envía el mensaje de pedido/factura con la(s) opción(es) de pago.
• WhatsApp Order Status — envía un mensaje de seguimiento que actualiza el estado del pedido y del pago (ej. procesando, enviado, pagado).

​

Cómo funciona

​

Requisitos

• Un número de WhatsApp Business brasileño conectado a tu espacio de trabajo.
• Una plantilla de Order Details aprobada (Meta no permite las opciones de pago al crear la plantilla; se agregan solo al enviar el mensaje).
• Para pruebas, un segundo número brasileño para recibir mensajes. Los mensajes no se pueden entregar a números fijos (landline).

​

Crear la plantilla de Order Details

​

Enviar el mensaje: paso WhatsApp Order Details

• Payment method — método de pago brasileño (Pix dinámico, Boleto, Payment Link o tarjeta).
• Item Type — ej. Digital goods.
• Item Name — ej. Invoice payment.
• Total Amount — el monto en BRL (ej. 500.00).
• Reference ID — el identificador único del pedido (“Nº da cobrança”).
• Body variables — valores de los placeholders de la plantilla. Si el header es documento, también das la URL del PDF y un nombre de archivo.

​

Actualizar el pedido: paso WhatsApp Order Status

• Body (hasta 1.024 caracteres).
• Footer (hasta 60 caracteres, opcional).
• Order Status y Payment Status — los valores estructurados que definen el estado.

​

Métodos de pago

• Pix dinámico — botón “Copiar código Pix”. Das el código Pix, merchant_name, key y key_type (ej. CNPJ).
• Boleto — botón “Copiar código do boleto”.
• Payment Link — botón “Abrir link de pagamento”.
• Tarjeta (Visa / Mastercard) — en la fila “Pagar com”.

​

Limitaciones y problemas conocidos

• El tipo de header es permanente — no se puede cambiar tras la creación; Meta solo permite editar plantillas con header de imagen/documento.
• Las etiquetas de botón las fija Meta — el texto de pago (ej. “Copiar código Pix”) no se personaliza; un texto personalizado falla la validación de la API de Meta.
• Header PDF solo en plantillas — un header PDF/documento se soporta en las plantillas de Order Details, no en los mensajes interactivos.
• Descarga de PDF en móvil — en pruebas, un PDF adjunto en el header no se pudo descargar en la app de Android, pero sí en WhatsApp Desktop y Web (parece un problema de Meta).
• No entrega a números fijos — los envíos no entregables devuelven el error de Meta 131026 (“Message undeliverable”).
• Los métodos de pago no se fijan al crear — solo se adjuntan al enviar, por lo que la vista previa del builder difiere del mensaje final.

​

Manejo de errores

• Rama “If send WhatsApp failed”: conéctala a un paso de respaldo (notificar a un agente, reintentar, o enviar un mensaje alternativo).
• Error 131026 — “Message undeliverable”: común al enviar a un número fijo o que no puede recibir el mensaje. Confirma que el destinatario tenga WhatsApp y no sea landline.
• Mensajes entrantes duplicados: si se duplican tras conectar el número, ve a Facebook → Configuración y privacidad → Integraciones comerciales y elimina la integración duplicada “uchat” (deja la del chatbot).
• “send failed” ocasional al probar plantillas: puede ocurrir antes de que una plantilla nueva esté totalmente activa.

​

Referencia técnica (API)

​

Estructura de la plantilla (Meta)

• category: UTILITY o MARKETING
• display_format: ORDER_DETAILS
• Header format: TEXT, IMAGE o DOCUMENT
• Components: HEADER, BODY, FOOTER, y un bloque BUTTONS con un único botón de tipo ORDER_DETAILS

​

Montos

​

Payload de ejemplo (Pix dinámico, header de texto)

{
  "messaging_product": "whatsapp",
  "recipient_type": "individual",
  "to": "<RECIPIENT_PHONE_NUMBER>",
  "type": "template",
  "template": {
    "name": "<TEMPLATE_NAME>",
    "language": { "policy": "deterministic", "code": "pt_BR" },
    "components": [
      {
        "type": "body",
        "parameters": [
          { "type": "text", "text": "<CUSTOMER_NAME>" },
          { "type": "text", "text": "<REFERENCE_ID>" }
        ]
      },
      {
        "type": "button",
        "sub_type": "order_details",
        "index": 0,
        "parameters": [
          {
            "type": "action",
            "action": {
              "order_details": {
                "reference_id": "<REFERENCE_ID>",
                "type": "digital-goods",
                "payment_type": "br",
                "payment_settings": [
                  {
                    "type": "pix_dynamic_code",
                    "pix_dynamic_code": {
                      "code": "<DYNAMIC_PIX_COPY_PASTE_CODE>",
                      "merchant_name": "<MERCHANT_NAME>",
                      "key": "<PIX_KEY>",
                      "key_type": "CNPJ"
                    }
                  }
                ],
                "currency": "BRL",
                "total_amount": { "value": 55700, "offset": 100 },
                "order": {
                  "status": "pending",
                  "items": [
                    {
                      "retailer_id": "<ITEM_ID>",
                      "name": "<ITEM_NAME>",
                      "amount": { "value": 55700, "offset": 100 },
                      "quantity": 1
                    }
                  ],
                  "subtotal": { "value": 55700, "offset": 100 },
                  "tax": { "value": 0, "offset": 100 }
                }
              }
            }
          }
        ]
      }
    ]
  }
}

​

Endpoint de envío de Botky

POST /api/subscriber/send-whatsapp-template-by-user-id

​

Referencias

• Meta — Send order details template message (Brazil)
• Meta — Payments API, Brazil (overview)
• Meta — Graph API media upload