whatsapp.smb.message.echoes

Usa whatsapp.smb.message.echoes para gestionar este evento en tu endpoint de webhook.

Desencadenadores

Se produce cuando un mensaje enviado desde la WhatsApp Business App se sincroniza como un eco. Suscríbete a whatsapp.smb.message.echoes cuando configures tu endpoint de webhook.

Sintaxis

YCloud envía una solicitud HTTP POST a tu URL de webhook configurada. La siguiente estructura muestra una variante del payload. Los valores entre corchetes angulares son marcadores de posición; sus tipos se enumeran en Parámetros. Los campos opcionales y otras variantes se describen a continuación.

{
  "id": "<ID>",
  "type": "whatsapp.smb.message.echoes",
  "apiVersion": "<API_VERSION>",
  "createTime": "<CREATE_TIME>",
  "whatsappMessage": {
    "id": "<ID>",
    "wamid": "<WAMID>",
    "wabaId": "<WABA_ID>",
    "from": "<FROM>",
    "to": "<TO>",
    "type": "<TYPE>",
    "text": {
      "body": "<BODY>"
    },
    "status": "<STATUS>",
    "createTime": "<CREATE_TIME>",
    "sendTime": "<SEND_TIME>",
    "toUserId": "<TO_USER_ID>",
    "toParentUserId": "<TO_PARENT_USER_ID>",
    "customerProfile": {
      "username": "<USERNAME>"
    }
  }
}

Parámetros

Valida el encabezado HTTP YCloud-Signature antes de procesar el cuerpo JSON. Consulta validación de firmas.

Envoltorio del evento

Parámetro	Tipo	Obligatorio	Descripción
`id`	string	Sí	ID único para el evento. Longitud mínima: `6`. Longitud máxima: `128`.
`type`	string	Sí	Siempre `whatsapp.smb.message.echoes`.
`apiVersion`	string	Sí	La versión de la API utilizada para procesar este evento.
`createTime`	string (date-time)	Sí	La hora en la que se creó este evento, con formato RFC 3339. Por ejemplo, `2022-06-01T12:00:00.000Z`.

Payload del evento

Parámetro	Tipo	Obligatorio	Descripción
`whatsappMessage`	object	No	Payload específico del evento `whatsappMessage`.

Los cuatro campos comunes del envoltorio son obligatorios. Los campos del payload dependen de la variante del evento. En cada tabla de objetos, Obligatorio se aplica cuando su objeto superior está presente. Los campos opcionales pueden omitirse; un ejemplo no hace que un campo sea obligatorio.

whatsappMessage

Parámetro	Tipo	Obligatorio	Descripción
`id`	string	Sí	ID único del mensaje.
`wamid`	string	No	El ID de mensaje original en la plataforma de WhatsApp.
`wabaId`	string	Sí	ID de la cuenta de WhatsApp Business.
`from`	string	Sí	El número de teléfono del remitente en formato E.164.
`to`	string	No	El número de teléfono del destinatario en formato E.164.
`recipient`	string	No	El valor del destinatario enviado en la solicitud cuando se utilizó un BSUID o un BSUID principal.
`recipientUserId`	string	No	El ID de usuario con ámbito de WhatsApp Business (BSUID) del destinatario.
`toUserId`	string	No	Alias de `recipientUserId` conservado por compatibilidad.
`parentRecipientUserId`	string	No	El ID de usuario principal con ámbito de WhatsApp Business del destinatario.
`toParentUserId`	string	No	Alias de `parentRecipientUserId` conservado por compatibilidad.
`customerProfile`	object	No	La información de perfil del destinatario, incluido el nombre de usuario de WhatsApp cuando esté disponible.
`conversation`	object	No	WhatsApp define una conversación como una sesión de mensajería de 24 horas entre una persona y una empresa. Este campo está presente después de que el estado del mensaje cambie a `sent`. Consulta también Precios basados en conversaciones.
`type`	string	No	Tipo de mensaje saliente de WhatsApp. Consulta también Mensajes de WhatsApp. Valores: `template`, `text`, `image`, `audio`, `video`, `document`, `sticker`, `location`, `interactive`, `contacts`, `reaction`.
`template`	object	No	Úsalo para enviar un mensaje de WhatsApp `template`.
`text`	object	No	Objeto de texto del mensaje de WhatsApp.
`image`	object	No	Usa esto para mensajes de tipo `image`, `gif`, `video`, `audio`, `document` o `sticker`. Consulta también Tipos de medios admitidos.
`video`	object	No	Usa esto para mensajes de tipo `image`, `gif`, `video`, `audio`, `document` o `sticker`. Consulta también Tipos de medios admitidos.
`audio`	object	No	Usa esto para mensajes de tipo `image`, `gif`, `video`, `audio`, `document` o `sticker`. Consulta también Tipos de medios admitidos.
`document`	object	No	Usa esto para mensajes de tipo `image`, `gif`, `video`, `audio`, `document` o `sticker`. Consulta también Tipos de medios admitidos.
`sticker`	object	No	Usa esto para mensajes de tipo `image`, `gif`, `video`, `audio`, `document` o `sticker`. Consulta también Tipos de medios admitidos.
`location`	object	No	Usa esto para mensajes de tipo `location`.
`interactive`	object	No	Usa esto para mensajes de tipo `interactive`.
`contacts`	object[]	No	Los elementos del array se describen a continuación.
`reaction`	object	No	Cuando un usuario reacciona a los mensajes con un emoji, el tipo de mensaje se establece en `reaction` y se incluye este campo.
`context`	object	No	Se usa para mencionar un mensaje específico al que estás respondiendo. La respuesta puede ser de cualquier tipo de mensaje.
`externalId`	string	No	Una cadena única (recomendada) para hacer referencia al objeto. Puede ser un número de pedido o similar, y se puede usar para conciliar el objeto con tus sistemas internos.
`category`	string	No	La categoría de Direct Send, como `utility` o `authentication`, cuando corresponda.
`ttlSeconds`	integer	No	El tiempo de vida configurado del mensaje de Direct Send en segundos, cuando corresponda.
`status`	string	No	Estado del mensaje de WhatsApp. Uno de `accepted`, `failed`, `sent`, `delivered`, `read`. `accepted`: Nuestro sistema ha aceptado la solicitud de mensajería. `failed`: Un mensaje enviado por tu negocio no se pudo enviar. `sent`: Un mensaje enviado por tu negocio está en tránsito dentro de los sistemas de WhatsApp. `delivered`: Un mensaje enviado por tu negocio se entregó en el dispositivo del usuario. `read`: Un mensaje enviado por tu negocio fue leído por el usuario.
`errorCode`	string	No	Código de error cuando el estado del mensaje es `failed`.
`errorMessage`	string	No	Mensaje de error cuando el estado del mensaje es `failed`.
`createTime`	string (date-time)	No	La hora en la que se creó este mensaje, con formato en RFC 3339. Por ejemplo, `2022-06-01T12:00:00.000Z`.
`updateTime`	string (date-time)	No	La hora en la que se actualizó este mensaje, con formato en RFC 3339. Por ejemplo, `2022-06-01T12:00:00.000Z`.
`sendTime`	string (date-time)	No	La hora en la que este mensaje `status` cambió a `sent`, con formato en RFC 3339. Por ejemplo, `2022-06-01T12:00:00.000Z`.
`deliverTime`	string (date-time)	No	La hora en la que este mensaje `status` cambió a `delivered`, con formato en RFC 3339. Por ejemplo, `2022-06-01T12:00:00.000Z`.
`readTime`	string (date-time)	No	La hora en la que este mensaje `status` cambió a `read`, con formato según RFC 3339. Por ejemplo, `2022-06-01T12:00:00.000Z`.
`totalPrice`	number (double)	No	Precio total de este mensaje. Nota: Es solo un precio estimado cuando el `status` es `accepted` o `sent`. Pasa a ser el precio final después de que se entrega el mensaje, es decir, cuando el `status` es `delivered` o `read`. Para los mensajes con Max Price, el importe en el momento del envío es una estimación. Usa el evento delivered/read whatsapp.message.updated para el cargo final; maxBid no es el importe cobrado final.
`currency`	string	No	Moneda del precio. Código de moneda ISO 4217.
`regionCode`	string	No	El código de región del número de teléfono del destinatario.
`pricingCategory`	string	No	La categoría de precio del mensaje. Nota: Es solo una categoría de precio estimada cuando el `status` es `accepted` o `sent`. Pasa a ser definitiva después de que se entrega el mensaje, es decir, cuando el `status` es `delivered` o `read`. Valores: `referral_conversion`, `authentication`, `authentication_international`, `marketing`, `marketing_lite`, `utility`, `service`, `marketing_lite_bidding`.
`pricingModel`	string	No	El modelo de precios del mensaje. `PMP`: Se aplica el precio por mensaje. `CBP`: Se aplica el precio basado en conversaciones.
`pricingType`	string	No	El tipo de precio del mensaje. Este campo solo está disponible en el modo PMP (Per-Message Pricing). `regular`: Indica que el mensaje es facturable. `free_customer_service`: Indica que el mensaje es gratuito porque fue un mensaje de plantilla de utilidad o un mensaje sin plantilla enviado dentro de una ventana de servicio de atención al cliente. `free_entry_point`: Indica que el mensaje es gratuito porque forma parte de una conversación de punto de entrada gratuito.
`whatsappApiError`	object	No	El objeto de error original devuelto por WhatsApp. Consulta Handling Errors, Cloud API Error Codes.
`bizType`	string	No	Puede estar vacío o ser uno de `whatsapp` o `verify`. El valor predeterminado es `whatsapp`. `whatsapp`: Indica que el mensaje se envía a través del producto WhatsApp. `verify`: Indica que el mensaje se envía a través del producto Verify.
`verificationId`	string	No	El ID de verificación. Solo se incluye cuando `bizType` es `verify`.
`bidPricingFlag`	boolean	No	True cuando el mensaje se identifica como un mensaje de puja de Marketing Lite. Su pricingCategory es marketing_lite_bidding.

whatsappMessage.customerProfile

Parámetro	Tipo	Obligatorio	Descripción
`name`	string	No	Nombre de la cuenta de WhatsApp.
`username`	string	No	Nombre de usuario de WhatsApp.

whatsappMessage.conversation

Parámetro	Tipo	Obligatorio	Descripción
`id`	string	No	Identificador único del objeto.
`type`	string	No	Tipo de conversación. Se aplica un cargo cuando se entrega el primer mensaje empresarial de esta conversación, lo que inicia la sesión de conversación de 24 horas. Por lo tanto, el tipo de conversación puede ser `null` antes de que se entregue el primer mensaje. `FREE_ENTRY`: Conversaciones que se originan a partir de un punto de entrada gratuito. `FREE_TIER`: Conversaciones dentro del nivel gratuito mensual. `REGULAR`: Cualquier conversación que no se haya originado a partir de un punto de entrada gratuito o que supere la asignación mensual del nivel gratuito.
`originType`	string	No	Indica la categoría de conversación. También se puede denominar punto de entrada de la conversación. `referral_conversion`: Indica una conversación de punto de entrada gratuito. `authentication`: Indica que la conversación fue abierta por una empresa al enviar una plantilla categorizada como `AUTHENTICATION` al cliente. Esto se aplica siempre que hayan pasado más de 24 horas desde el último mensaje del cliente. `marketing`: Indica que la conversación fue abierta por una empresa al enviar una plantilla categorizada como `MARKETING` al cliente. Esto se aplica siempre que hayan pasado más de 24 horas desde el último mensaje del cliente. `utility`: Indica que la conversación fue abierta por una empresa al enviar una plantilla categorizada como `UTILITY` al cliente. Esto se aplica siempre que hayan pasado más de 24 horas desde el último mensaje del cliente. `service`: Indica que la conversación fue abierta por una empresa al responder a un cliente dentro de una ventana de atención al cliente.
`expireTime`	string (date-time)	No	Fecha en la que vence la conversación, con formato RFC 3339. Por ejemplo, `2022-06-01T12:00:00.000Z`.

whatsappMessage.template

Parámetro	Tipo	Obligatorio	Descripción
`name`	string	Sí	Nombre de la plantilla.
`language`	object	Sí	Contiene un objeto language. Especifica el idioma en el que se puede representar la plantilla.
`components`	object[]	No	Obligatorio cuando la plantilla especificada contiene variables o archivos multimedia. Matriz de objetos component que contienen los parámetros del mensaje.

whatsappMessage.template.language

Parámetro	Tipo	Obligatorio	Descripción
`code`	string	Sí	El código del idioma o configuración regional a usar. Acepta tanto el formato de idioma como el de idioma_configuración regional (por ejemplo, en y en_US). Consulta Idiomas admitidos para ver todos los códigos.
`policy`	string	No	La política de idioma que debe seguir el mensaje. Valor predeterminado (y única opción admitida): `deterministic`, lo que significa que WhatsApp entrega la plantilla de mensaje exactamente en el idioma y la configuración regional solicitados.

whatsappMessage.template.components[]

Parámetro	Tipo	Obligatorio	Descripción
`type`	string	Sí	Tipo de componente. Valores: `header`, `body`, `button`, `limited_time_offer`, `carousel`, `order_status`.
`sub_type`	string	No	Obligatorio cuando el tipo es `button`. Tipo de botón. `quick_reply`: hace referencia a un botón de respuesta rápida creado previamente que permite al cliente devolver un mensaje predefinido. `url`: hace referencia a un botón de URL creado previamente que permite al cliente visitar la URL generada al añadir el parámetro text al prefijo de URL predefinido en la plantilla. `copy_code`: hace referencia a un botón de copiar código creado previamente que permite al cliente copiar una cadena de texto (definida cuando la plantilla se envía en un mensaje de plantilla) al portapapeles del dispositivo cuando el usuario de la aplicación lo pulsa. `catalog`: hace referencia a un botón de catálogo creado previamente que permite al cliente ver tu catálogo de productos. `mpm`: hace referencia a un botón de MPM (mensaje multiproducto) creado previamente que permite al cliente explorar productos y secciones. `flow`: hace referencia a un botón de flujo creado previamente que permite al cliente interactuar con un flow. `order_details`: hace referencia a un botón de detalles del pedido creado previamente que permite al cliente ver los detalles de un pedido.
`index`	integer (int32)	No	Obligatorio cuando `type` = `button`. No se utiliza para los demás tipos. Indica el orden en el que debe aparecer el botón, si la plantilla utiliza varios botones. Los botones están indexados desde cero, por lo que establecer el valor en 0 hará que el botón aparezca primero, y otro botón con un índice de 1 aparecerá a continuación, etc. Mínimo: `0`. Máximo: `9`.
`parameters`	object[]	No	Obligatorio cuando `type` = `button`, o si hay variables en el componente de plantilla correspondiente, o si el formato de la plantilla `HEADER` es multimedia (`IMAGE`, `VIDEO` o `DOCUMENT`). Matriz de objetos de parámetros con el contenido del mensaje.
`cards`	object[]	No	Úsalo para componentes `carousel`. Proporciona componentes de tarjeta que contienen los parámetros del mensaje.

whatsappMessage.template.components[].parameters[]

Parámetro	Tipo	Obligatorio	Descripción
`type`	string	No	Obligatorio. Tipo de parámetro del componente. `text`: Se utiliza cuando el tipo de componente de la plantilla es `BODY`, o el formato del componente `HEADER` es `TEXT`. `image`: Se utiliza cuando el componente `HEADER` de la plantilla es `IMAGE`. `gif`: Se utiliza cuando el componente `HEADER` de la plantilla es `GIF`. `video`: Se utiliza cuando el componente `HEADER` de la plantilla es `VIDEO`. `document`: Se utiliza cuando el componente `HEADER` de la plantilla es `DOCUMENT`. `payload`: Se utiliza cuando el tipo de botón del componente de la plantilla es `QUICK_REPLY`. `coupon_code`: Se utiliza cuando el tipo de botón del componente de la plantilla es `COPY_CODE`. `limited_time_offer`: Se utiliza cuando el tipo de componente de la plantilla es `LIMITED_TIME_OFFER`. `action`: Se utiliza cuando el tipo de botón del componente de la plantilla es `CATALOG`, `MPM`, `FLOW`, u `ORDER_DETAILS`. `order_status`: Se utiliza cuando la subcategoría de la plantilla es `ORDER_STATUS`. `location`: Se utiliza cuando el componente `HEADER` de la plantilla es `LOCATION`.
`text`	string	No	Obligatorio cuando `type` = `text`. El texto del mensaje. Para el componente de encabezado, el límite de caracteres es de 60 caracteres. Para el componente del cuerpo, el límite es de 1024 caracteres. Para los botones de URL, indica el sufijo proporcionado por el desarrollador que se añade a la URL prefijada predefinida en la plantilla.
`payload`	string	No	Obligatorio para los botones de `quick_reply`. Carga útil (payload) definida por el desarrollador que se devuelve cuando se hace clic en el botón, además del texto mostrado en el botón.
`coupon_code`	string	No	Obligatorio cuando `type` = `coupon_code`. El código de cupón que se copiará cuando el cliente pulse el botón.
`image`	object	No	Obligatorio cuando el formato de `HEADER` de la plantilla es `IMAGE`.
`gif`	object	No	Obligatorio cuando el formato de `HEADER` de la plantilla es `GIF`.
`video`	object	No	Obligatorio cuando el formato de `HEADER` de la plantilla es `VIDEO`.
`document`	object	No	Obligatorio cuando el formato de `HEADER` de la plantilla es `DOCUMENT`.
`limited_time_offer`	object	No	Obligatorio si la plantilla utiliza detalles de vencimiento de la oferta.
`action`	object	No	Obligatorio si la plantilla utiliza botones de catálogo o MPM (mensaje de múltiples productos).
`order_status`	object	No	Los campos del objeto se detallan a continuación.
`location`	object	No	Obligatorio cuando `type` = `location`.

whatsappMessage.template.components[].parameters[].image

Parámetro	Tipo	Obligatorio	Descripción
`id`	string	No	Usa esto cuando el archivo multimedia se suba a los servidores de WhatsApp. Proporciona el ID del objeto multimedia obtenido de la API de subida de archivos multimedia de WhatsApp (https://docs.ycloud.com/reference/whatsapp_media-upload#/). Nota: Debes proporcionar `id` o `link`. Si se proporcionan ambos, `id` tiene prioridad.
`link`	string	No	Usa esto cuando envíes archivos multimedia directamente desde tu servidor. El protocolo y la URL del archivo multimedia que se enviará. Usa solo con URL HTTP/HTTPS. Nota: La API de WhatsApp Cloud almacena en caché los recursos multimedia durante 10 minutos. Para garantizar el contenido más reciente, añade parámetros de consulta (query strings) aleatorios a la URL. Nota: Debes proporcionar `id` o `link`. Si se proporcionan ambos, `id` tiene prioridad y `link` se ignorará.
`caption`	string	No	Describe el archivo multimedia especificado (`image`, `gif`, `video` o `document`). No aplicable en el `header` de mensajes de `template` o `interactive`.
`filename`	string	No	Describe el nombre de archivo para el documento específico. Usa solo con contenido multimedia `document`.

whatsappMessage.template.components[].parameters[].gif

Parámetro	Tipo	Requerido	Descripción
`id`	string	No	Usa esto cuando el archivo multimedia se suba a los servidores de WhatsApp. Proporciona el ID del objeto multimedia obtenido de la API de subida de archivos multimedia de WhatsApp (https://docs.ycloud.com/reference/whatsapp_media-upload#/). Nota: Debes proporcionar `id` o `link`. Si se proporcionan ambos, `id` tiene prioridad.
`link`	string	No	Usa esto cuando envíes archivos multimedia directamente desde tu servidor. El protocolo y la URL del archivo multimedia que se enviará. Usa solo con URL HTTP/HTTPS. Nota: La API de WhatsApp Cloud almacena en caché los recursos multimedia durante 10 minutos. Para garantizar el contenido más reciente, añade parámetros de consulta (query strings) aleatorios a la URL. Nota: Debes proporcionar `id` o `link`. Si se proporcionan ambos, `id` tiene prioridad y `link` se ignorará.
`caption`	string	No	Describe el archivo multimedia especificado (`image`, `gif`, `video` o `document`). No aplicable en el `header` de mensajes de `template` o `interactive`.
`filename`	string	No	Describe el nombre de archivo para el documento específico. Usa solo con contenido multimedia `document`.

whatsappMessage.template.components[].parameters[].video

Parámetro	Tipo	Requerido	Descripción
`id`	string	No	Usa esto cuando el archivo multimedia se suba a los servidores de WhatsApp. Proporciona el ID del objeto multimedia obtenido de la API de subida de archivos multimedia de WhatsApp (https://docs.ycloud.com/reference/whatsapp_media-upload#/). Nota: Debes proporcionar `id` o `link`. Si se proporcionan ambos, `id` tiene prioridad.
`link`	string	No	Usa esto cuando envíes archivos multimedia directamente desde tu servidor. El protocolo y la URL del archivo multimedia que se enviará. Usa solo con URL HTTP/HTTPS. Nota: La API de WhatsApp Cloud almacena en caché los recursos multimedia durante 10 minutos. Para garantizar el contenido más reciente, añade parámetros de consulta (query strings) aleatorios a la URL. Nota: Debes proporcionar `id` o `link`. Si se proporcionan ambos, `id` tiene prioridad y `link` se ignorará.
`caption`	string	No	Describe el archivo multimedia `image`, `gif`, `video` o `document` especificado. No aplicable en el `header` de mensajes `template` o `interactive`.
`filename`	string	No	Describe el nombre de archivo para el documento específico. Úsalo solo con multimedia `document`.

whatsappMessage.template.components[].parameters[].document

Parámetro	Tipo	Obligatorio	Descripción
`id`	string	No	Usa esto cuando el archivo multimedia se suba a los servidores de WhatsApp. Proporciona el ID del objeto multimedia obtenido de la API de subida de archivos multimedia de WhatsApp (https://docs.ycloud.com/reference/whatsapp_media-upload#/). Nota: Se debe proporcionar `id` o `link`. Si se proporcionan ambos, prevalece `id`.
`link`	string	No	Usa esto cuando envíes archivos multimedia directamente desde tu servidor. El protocolo y la URL del archivo multimedia que se enviará. Úsalo solo con URL HTTP/HTTPS. Nota: La Cloud API de WhatsApp almacena en caché los recursos multimedia durante 10 minutos. Para asegurarte de tener el contenido más reciente, añade parámetros de consulta (query strings) aleatorios a la URL. Nota: Se debe proporcionar `id` o `link`. Si se proporcionan ambos, prevalece `id` y se ignorará `link`.
`caption`	string	No	Describe el archivo multimedia `image`, `gif`, `video` o `document` especificado. No aplicable en el `header` de mensajes `template` o `interactive`.
`filename`	string	No	Describe el nombre de archivo para el documento específico. Úsalo solo con multimedia `document`.

whatsappMessage.template.components[].parameters[].limited_time_offer

Parámetro	Tipo	Obligatorio	Descripción
`expiration_time_ms`	integer (int64)	No	Obligatorio. Hora de caducidad del código de oferta en formato de marca de tiempo UNIX en milisegundos.

whatsappMessage.template.components[].parameters[].action

Parámetro	Tipo	Obligatorio	Descripción
`thumbnail_product_retailer_id`	string	No	Opcional. Úsalo para mensajes de plantilla de catálogo y MPM. Número SKU del artículo. Etiquetado como Content ID en el Administrador de ventas. La miniatura de este artículo se usará como la imagen del encabezado del mensaje. Si se omite el objeto `parameters`, se utilizará la imagen del producto del primer artículo de tu catálogo.
`sections`	object[]	No	Úsalo para plantillas MPM. Secciones de productos. Puedes definir hasta 10 secciones.
`flow_token`	string	No	Úsalo para botones de tipo `FLOW`. Token de flujo generado por la empresa para servir como identificador. El valor predeterminado es `unused`.
`flow_action_data`	object	No	Úsalo para botones de tipo `FLOW`. Objeto JSON con la carga útil de datos para la primera pantalla.
`order_details`	object	No	Obligatorio para botones de tipo `order_details`.

whatsappMessage.template.components[].parameters[].action.sections[]

Parámetro	Tipo	Obligatorio	Descripción
`title`	string	No	Texto del título de la sección. Máximo 24 caracteres. No se admite Markdown. Longitud máxima: `24`.
`product_items`	object[]	No	Matriz de números SKU de productos. Hay un mínimo de 1 producto por sección y un máximo de 30 productos en todas las secciones.

whatsappMessage.template.components[].parameters[].action.sections[].product_items[]

Parámetro	Tipo	Obligatorio	Descripción
`product_retailer_id`	string	No	Número SKU del artículo que quieres que aparezca en la sección. Los números SKU están etiquetados como Content ID en el Commerce Manager.

whatsappMessage.template.components[].parameters[].action.order_details

Parámetro	Tipo	Requerido	Descripción
`currency`	string	Sí	La moneda de este pedido. Actualmente, el único valor admitido es `INR`.
`order`	object	Sí	Proporciona `status`, `items`, `subtotal`, `tax`, etc., del pedido.
`reference_id`	string	Sí	Identificador único del pedido proporcionado por el negocio. Distingue entre mayúsculas y minúsculas, no puede ser una cadena vacía, solo puede contener letras en inglés, números, guiones bajos, guiones o puntos, y no debe superar los 35 caracteres. El `reference_id` debe ser único para cada mensaje de order_details de un negocio determinado. Si es necesario enviar varios mensajes de order_details para el mismo pedido, se recomienda incluir un número de secuencia en el reference_id (por ejemplo, “BM345A-12”) para garantizar su unicidad._
`total_amount`	object	Sí	El importe total del pedido.
`type`	string	Sí	El tipo de artículos que se pagan en este pedido. Las opciones admitidas actualmente son `digital-goods` y `physical-goods`.
`payment_settings`	object[]	Sí	Ajustes de pago para el pedido.

whatsappMessage.template.components[].parameters[].action.order_details.order

Parámetro	Tipo	Requerido	Descripción
`status`	string	No	El único valor admitido en el mensaje `order_details` es `pending`. En un mensaje `order_status`, `status` puede ser: `pending`, `processing`, `partially_shipped`, `shipped`, `completed` o `canceled`.
`type`	string	No	El único valor admitido es `quick_pay`. Cuando se incluye este campo, ocultamos el botón “Review and Pay” y solo mostramos el botón “Pay Now” en la burbuja de detalles del pedido.
`catalog_id`	string	No	Identificador único del catálogo de Facebook que utiliza el negocio. Si no proporcionas este campo, debes indicar los siguientes campos dentro del objeto items: `country_of_origin`, `importer_name` y `importer_address`.
`items`	object[]	No	Matriz de artículos del pedido.
`subtotal`	object	No	El valor debe ser igual a la suma de `order.amount.value` * `order.amount.quantity`.
`tax`	object	No	La información de impuestos de este pedido.
`shipping`	object	No	El coste de envío del pedido.
`discount`	object	No	El importe del descuento para este pedido.
`expiration`	object	No	Vencimiento de este pedido.
`description`	string	No	Opcional. Texto para compartir información relacionada con el estado. Puede resultar útil al enviar una cancelación. El límite máximo es de 120 caracteres. Longitud máxima: `120`.

whatsappMessage.template.components[].parameters[].action.order_details.order.items[]

Parámetro	Tipo	Requerido	Descripción
`retailer_id`	string	No	ID de contenido de un artículo del pedido perteneciente a tu catálogo.
`name`	string	Sí	Nombre del artículo que se mostrará al usuario. No puede superar los 60 caracteres. Longitud máxima: `60`.
`image`	object	No	Imagen personalizada para el artículo que se mostrará al usuario.
`amount`	object	Sí	El precio por artículo.
`sale_amount`	object	No	El precio con descuento por artículo. Debe ser menor que el importe original. Si se incluye, este campo se utiliza para calcular el importe subtotal.
`quantity`	integer (int32)	Sí	La cantidad de artículos en el pedido.
`country_of_origin`	string	No	Obligatorio si `catalog_id` no está presente. El país de origen del producto.
`importer_name`	string	No	Obligatorio si `catalog_id` no está presente. Nombre de la empresa importadora.
`importer_address`	string	No	Obligatorio si `catalog_id` no está presente. Dirección de la empresa importadora.

whatsappMessage.template.components[].parameters[].action.order_details.order.items[].image

Parámetro	Tipo	Obligatorio	Descripción
`id`	string	No	Usa esto cuando el archivo multimedia se sube a los servidores de WhatsApp. Proporciona el ID del objeto multimedia obtenido de la API de subida de archivos multimedia de WhatsApp (https://docs.ycloud.com/reference/whatsapp_media-upload#/). Nota: Se debe proporcionar `id` o bien `link`. Si se proporcionan ambos, `id` tiene prioridad.
`link`	string	No	Usa esto al enviar archivos multimedia directamente desde tu servidor. El protocolo y la URL del archivo multimedia que se enviará. Úsalo únicamente con URL HTTP/HTTPS. Nota: WhatsApp Cloud API almacena en caché los recursos multimedia durante 10 minutos. Para asegurarte de tener el contenido más reciente, añade parámetros de consulta aleatorios a la URL. Nota: Se debe proporcionar `id` o bien `link`. Si se proporcionan ambos, `id` tiene prioridad y `link` se ignorará.
`caption`	string	No	Describe el archivo multimedia `image`, `gif`, `video` o `document` especificado. No aplicable en el `header` de mensajes `template` o `interactive`.
`filename`	string	No	Describe el nombre de archivo para el documento específico. Úsalo solo con archivos multimedia `document`.

whatsappMessage.template.components[].parameters[].action.order_details.order.items[].amount

Parámetro	Tipo	Obligatorio	Descripción
`offset`	integer (int32)	Sí	Debe ser `100` para `INR`.
`value`	integer (int32)	Sí	Entero positivo que representa el valor del importe multiplicado por el desplazamiento (offset). Por ejemplo, ₹12.34 tiene el valor 1234.
`description`	string	No	Usa únicamente para `tax`, `shipping` o `discount`. Descripción del importe. El límite máximo es de 60 caracteres. Longitud máxima: `60`.
`discount_program_name`	string	No	Usa únicamente para `discount`. Texto utilizado para definir pedidos con incentivos. Si el pedido tiene incentivos, el comerciante debe definir esta información. El límite máximo es de 60 caracteres. Longitud máxima: `60`.

whatsappMessage.template.components[].parameters[].action.order_details.order.items[].sale_amount

Parámetro	Tipo	Obligatorio	Descripción
`offset`	integer (int32)	Sí	Debe ser `100` para `INR`.
`value`	integer (int32)	Sí	Entero positivo que representa el valor del importe multiplicado por el desplazamiento (offset). Por ejemplo, ₹12.34 tiene el valor 1234.
`description`	string	No	Úsalo solo para `tax`, `shipping` o `discount`. Descripción del importe. El límite máximo de caracteres es de 60. Longitud máxima: `60`.
`discount_program_name`	string	No	Úsalo solo para `discount`. Texto utilizado para definir pedidos con incentivos. Si el pedido tiene incentivos, el comerciante debe definir esta información. El límite máximo de caracteres es de 60. Longitud máxima: `60`.

whatsappMessage.template.components[].parameters[].action.order_details.order.subtotal

Parámetro	Tipo	Obligatorio	Descripción
`offset`	integer (int32)	Sí	Debe ser `100` para `INR`.
`value`	integer (int32)	Sí	Entero positivo que representa el valor del importe multiplicado por el desplazamiento (offset). Por ejemplo, ₹12.34 tiene el valor 1234.
`description`	string	No	Úsalo solo para `tax`, `shipping` o `discount`. Descripción del importe. El límite máximo de caracteres es de 60. Longitud máxima: `60`.
`discount_program_name`	string	No	Úsalo solo para `discount`. Texto utilizado para definir pedidos con incentivos. Si el pedido tiene incentivos, el comerciante debe definir esta información. El límite máximo de caracteres es de 60. Longitud máxima: `60`.

whatsappMessage.template.components[].parameters[].action.order_details.order.tax

Parámetro	Tipo	Obligatorio	Descripción
`offset`	integer (int32)	Sí	Debe ser `100` para `INR`.
`value`	integer (int32)	Sí	Entero positivo que representa el valor del importe multiplicado por el desplazamiento (offset). Por ejemplo, ₹12.34 tiene el valor 1234.
`description`	string	No	Úsalo solo para `tax`, `shipping` o `discount`. Descripción del importe. El límite máximo de caracteres es de 60. Longitud máxima: `60`.
`discount_program_name`	string	No	Úsalo solo para `discount`. Texto utilizado para definir pedidos con incentivos. Si el pedido tiene incentivos, el comerciante debe definir esta información. El límite máximo de caracteres es de 60. Longitud máxima: `60`.

whatsappMessage.template.components[].parameters[].action.order_details.order.shipping

Parámetro	Tipo	Obligatorio	Descripción
`offset`	integer (int32)	Sí	Debe ser `100` para `INR`.
`value`	integer (int32)	Sí	Entero positivo que representa el valor del importe multiplicado por el desplazamiento (offset). Por ejemplo, ₹12.34 tiene el valor 1234.
`description`	string	No	Úsalo solo para `tax`, `shipping` o `discount`. Descripción del importe. El límite máximo de caracteres es de 60. Longitud máxima: `60`.
`discount_program_name`	string	No	Úsalo solo para `discount`. Texto utilizado para definir pedidos con incentivos. Si el pedido tiene incentivos, el comerciante debe definir esta información. El límite máximo de caracteres es de 60 caracteres. Longitud máxima: `60`.

whatsappMessage.template.components[].parameters[].action.order_details.order.discount

Parámetro	Tipo	Obligatorio	Descripción
`offset`	integer (int32)	Sí	Debe ser `100` para `INR`.
`value`	integer (int32)	Sí	Entero positivo que representa el valor del importe multiplicado por el desplazamiento (offset). Por ejemplo, ₹12.34 tiene el valor 1234.
`description`	string	No	Úsalo solo para `tax`, `shipping` o `discount`. Descripción del importe. El límite máximo de caracteres es de 60 caracteres. Longitud máxima: `60`.
`discount_program_name`	string	No	Úsalo solo para `discount`. Texto utilizado para definir pedidos con incentivos. Si el pedido tiene incentivos, el comerciante debe definir esta información. El límite máximo de caracteres es de 60 caracteres. Longitud máxima: `60`.

whatsappMessage.template.components[].parameters[].action.order_details.order.expiration

Parámetro	Tipo	Obligatorio	Descripción
`timestamp`	string	Sí	Cadena con la marca de tiempo UTC en segundos del momento en que debe caducar el pedido. El umbral mínimo es de 300 segundos.
`description`	string	No	Explicación de texto para la caducidad. Longitud máxima: `120`.

whatsappMessage.template.components[].parameters[].action.order_details.total_amount

Parámetro	Tipo	Obligatorio	Descripción
`offset`	integer (int32)	Sí	Debe ser `100` para `INR`.
`value`	integer (int32)	Sí	Entero positivo que representa el valor del importe multiplicado por el desplazamiento (offset). Por ejemplo, ₹12.34 tiene el valor 1234.
`description`	string	No	Úsalo solo para `tax`, `shipping` o `discount`. Descripción del importe. El límite máximo de caracteres es de 60 caracteres. Longitud máxima: `60`.
`discount_program_name`	string	No	Úsalo solo para `discount`. Texto utilizado para definir pedidos con incentivos. Si el pedido tiene incentivos, el comerciante debe definir esta información. El límite máximo de caracteres es de 60 caracteres. Longitud máxima: `60`.

whatsappMessage.template.components[].parameters[].action.order_details.payment_settings[]

Parámetro	Tipo	Obligatorio	Descripción
`type`	string	Sí	Debe establecerse en `payment_gateway`.
`payment_gateway`	object	Sí	Objeto que describe la información de la cuenta de pago.

whatsappMessage.template.components[].parameters[].action.order_details.payment_settings[].payment_gateway

Parámetro	Tipo	Obligatorio	Descripción
`type`	string	Sí	Tipo de pago. Debes establecer esto en `billdesk`, `razorpay`, `payu` o `zaakpay` si has vinculado tu pasarela de pago de BillDesk, Razorpay, PayU o Zaakpay para aceptar pagos.
`configuration_name`	string	Sí	El nombre de la configuración de pago preconfigurada que se utilizará para este pedido; no debe superar los 60 caracteres. Este valor debe coincidir con una configuración de pago configurada en WhatsApp Business Manager. Longitud máxima: `60`.
`billdesk`	object	No	Información adicional para BillDesk. Los campos definidos por el usuario (extra) se utilizan para almacenar cualquier información correspondiente a un pedido concreto. Cada campo extra tiene un límite máximo de 120 caracteres.
`payu`	object	No	Información adicional para PayU. Los campos definidos por el usuario (udf) se utilizan para almacenar cualquier información correspondiente a un pedido concreto. Cada campo UDF tiene un límite máximo de 255 caracteres.
`razorpay`	object	No	Información adicional para Razorpay.
`zaakpay`	object	No	Información adicional para Zaakpay. Los campos definidos por el usuario (extra) se utilizan para almacenar cualquier información correspondiente a un pedido concreto. Cada campo extra tiene un límite máximo de 180 caracteres.

whatsappMessage.template.components[].parameters[].action.order_details.payment_settings[].payment_gateway.billdesk

Parámetro	Tipo	Obligatorio	Descripción
`additional_info1`	string	No	Información definida por el usuario sobre este pedido para BillDesk. Longitud máxima: `120` caracteres.
`additional_info2`	string	No	Información definida por el usuario sobre este pedido para BillDesk. Longitud máxima: `120` caracteres.
`additional_info3`	string	No	Información definida por el usuario sobre este pedido para BillDesk. Longitud máxima: `120` caracteres.
`additional_info4`	string	No	Información definida por el usuario sobre este pedido para BillDesk. Longitud máxima: `120` caracteres.
`additional_info5`	string	No	Información definida por el usuario sobre este pedido para BillDesk. Longitud máxima: `120` caracteres.
`additional_info6`	string	No	Información definida por el usuario sobre este pedido para BillDesk. Longitud máxima: `120` caracteres.
`additional_info7`	string	No	Información definida por el usuario sobre este pedido para BillDesk. Longitud máxima: `120` caracteres.

whatsappMessage.template.components[].parameters[].action.order_details.payment_settings[].payment_gateway.payu

Parámetro	Tipo	Obligatorio	Descripción
`udf1`	string	No	Información definida por el usuario sobre este pedido para PayU. Longitud máxima: `255` caracteres.
`udf2`	string	No	Información definida por el usuario sobre este pedido para PayU. Longitud máxima: `255` caracteres.
`udf3`	string	No	Información definida por el usuario sobre este pedido para PayU. Longitud máxima: `255` caracteres.
`udf4`	string	No	Información definida por el usuario sobre este pedido para PayU. Longitud máxima: `255` caracteres.

whatsappMessage.template.components[].parameters[].action.order_details.payment_settings[].payment_gateway.razorpay

Parámetro	Tipo	Obligatorio	Descripción
`receipt`	string	No	Número de recibo que corresponde a este pedido, establecido para tu referencia interna. Admite una longitud máxima de 40 caracteres con una longitud mínima superior a 0 caracteres.
`notes`	object	No	El objeto puede estar formado por pares clave-valor con un máximo de 15 claves y cada valor está limitado a 256 caracteres.

whatsappMessage.template.components[].parameters[].action.order_details.payment_settings[].payment_gateway.zaakpay

Parámetro	Tipo	Obligatorio	Descripción
`extra1`	string	No	Información definida por el usuario sobre este pedido para Zaakpay. Longitud máxima: `180` caracteres.
`extra2`	string	No	Información definida por el usuario sobre este pedido para Zaakpay. Longitud máxima: `180` caracteres.

whatsappMessage.template.components[].parameters[].order_status

Parámetro	Tipo	Obligatorio	Descripción
`reference_id`	string	No	Identificador único para el pedido proporcionado por el negocio.
`order`	object	No	Proporciona solo `status` y `description` de este pedido para mensajes `order_status`.

whatsappMessage.template.components[].parameters[].order_status.order

Parámetro	Tipo	Obligatorio	Descripción
`status`	string	No	El único valor admitido en el mensaje `order_details` es `pending`. En un mensaje `order_status`, `status` puede ser: `pending`, `processing`, `partially_shipped`, `shipped`, `completed` o `canceled`.
`type`	string	No	El único valor admitido es `quick_pay`. Cuando se pasa este campo, ocultamos el botón “Review and Pay” y solo mostramos el botón “Pay Now” en la burbuja de detalles del pedido.
`catalog_id`	string	No	Identificador único del catálogo de Facebook que utiliza el negocio. Si no proporcionas este campo, debes proporcionar los siguientes campos dentro del objeto items: `country_of_origin`, `importer_name` y `importer_address`.
`items`	object[]	No	Array de artículos del pedido.
`subtotal`	object	No	El valor debe ser igual a la suma de `order.amount.value` * `order.amount.quantity`.
`tax`	object	No	La información fiscal de este pedido.
`shipping`	object	No	El costo de envío del pedido.
`discount`	object	No	El monto de descuento para este pedido.
`expiration`	object	No	Vencimiento de este pedido.
`description`	string	No	Opcional. Texto para compartir información relacionada con el estado. Podría ser útil al enviar una cancelación. El límite máximo de caracteres es de 120 caracteres. Longitud máxima: `120`.

whatsappMessage.template.components[].parameters[].order_status.order.items[]

Parámetro	Tipo	Obligatorio	Descripción
`retailer_id`	string	No	Identificador de contenido para un artículo en el pedido de tu catálogo.
`name`	string	Sí	El nombre del artículo que se mostrará al usuario. No puede superar los 60 caracteres. Longitud máxima: `60`.
`image`	object	No	Imagen personalizada para el artículo que se mostrará al usuario.
`amount`	object	Sí	El precio por artículo.
`sale_amount`	object	No	El precio con descuento por artículo. Debe ser menor que el importe original. Si se incluye, este campo se utiliza para calcular el importe subtotal.
`quantity`	integer (int32)	Sí	El número de artículos en el pedido.
`country_of_origin`	string	No	Obligatorio si `catalog_id` no está presente. El país de origen del producto.
`importer_name`	string	No	Obligatorio si `catalog_id` no está presente. Nombre de la empresa importadora.
`importer_address`	string	No	Obligatorio si `catalog_id` no está presente. Dirección de la empresa importadora.

whatsappMessage.template.components[].parameters[].order_status.order.items[].image

Parámetro	Tipo	Obligatorio	Descripción
`id`	string	No	Usa esto cuando el contenido multimedia se suba a los servidores de WhatsApp. Proporciona el ID del objeto multimedia obtenido de la API de subida de archivos multimedia de WhatsApp (https://docs.ycloud.com/reference/whatsapp_media-upload#/). Nota: Se debe proporcionar `id` o `link`. Si se proporcionan ambos, `id` tiene prioridad.
`link`	string	No	Usa esto cuando envíes archivos multimedia directamente desde tu servidor. El protocolo y la URL del archivo multimedia que se enviará. Usa solo con URLs HTTP/HTTPS. Nota: La Cloud API de WhatsApp almacena en caché los recursos multimedia durante 10 minutos. Para asegurarte de tener el contenido más reciente, añade cadenas de consulta aleatorias a la URL. Nota: Se debe proporcionar `id` o `link`. Si se proporcionan ambos, `id` tiene prioridad y `link` se ignorará.
`caption`	string	No	Describe el archivo multimedia `image`, `gif`, `video` o `document` especificado. No aplicable en el `header` de mensajes de `template` o `interactive`.
`filename`	string	No	Describe el nombre de archivo del documento específico. Usa solo con contenido multimedia `document`.

whatsappMessage.template.components[].parameters[].order_status.order.items[].amount

Parámetro	Tipo	Obligatorio	Descripción
`offset`	integer (int32)	Sí	Debe ser `100` para `INR`.
`value`	integer (int32)	Sí	Entero positivo que representa el valor del importe multiplicado por el desplazamiento (offset). Por ejemplo, ₹12.34 tiene el valor 1234.
`description`	string	No	Usa solo para `tax`, `shipping` o `discount`. Descripción del importe. El límite máximo de caracteres es de 60 caracteres. Longitud máxima: `60`.
`discount_program_name`	string	No	Usa solo para `discount`. Texto utilizado para definir pedidos con incentivos. Si el pedido tiene incentivos, el comerciante debe definir esta información. El límite máximo de caracteres es de 60 caracteres. Longitud máxima: `60`.

whatsappMessage.template.components[].parameters[].order_status.order.items[].sale_amount

Parámetro	Tipo	Obligatorio	Descripción
`offset`	integer (int32)	Sí	Debe ser `100` para `INR`.
`value`	integer (int32)	Sí	Entero positivo que representa el valor del importe multiplicado por el desplazamiento (offset). Por ejemplo, ₹12.34 tiene el valor 1234.
`description`	string	No	Úsalo solo para `tax`, `shipping` o `discount`. Descripción del importe. El límite máximo es de 60 caracteres. Longitud máxima: `60`.
`discount_program_name`	string	No	Úsalo solo para `discount`. Texto utilizado para definir pedidos con incentivos. Si el pedido tiene incentivos, el comercio debe definir esta información. El límite máximo es de 60 caracteres. Longitud máxima: `60`.

whatsappMessage.template.components[].parameters[].order_status.order.subtotal

Parámetro	Tipo	Requerido	Descripción
`offset`	integer (int32)	Sí	Debe ser `100` para `INR`.
`value`	integer (int32)	Sí	Entero positivo que representa el valor del importe multiplicado por el desplazamiento (offset). Por ejemplo, ₹12.34 tiene el valor 1234.
`description`	string	No	Úsalo solo para `tax`, `shipping` o `discount`. Descripción del importe. El límite máximo es de 60 caracteres. Longitud máxima: `60`.
`discount_program_name`	string	No	Úsalo solo para `discount`. Texto utilizado para definir pedidos con incentivos. Si el pedido tiene incentivos, el comercio debe definir esta información. El límite máximo es de 60 caracteres. Longitud máxima: `60`.

whatsappMessage.template.components[].parameters[].order_status.order.tax

Parámetro	Tipo	Requerido	Descripción
`offset`	integer (int32)	Sí	Debe ser `100` para `INR`.
`value`	integer (int32)	Sí	Entero positivo que representa el valor del importe multiplicado por el desplazamiento (offset). Por ejemplo, ₹12.34 tiene el valor 1234.
`description`	string	No	Úsalo solo para `tax`, `shipping` o `discount`. Descripción del importe. El límite máximo es de 60 caracteres. Longitud máxima: `60`.
`discount_program_name`	string	No	Úsalo solo para `discount`. Texto utilizado para definir pedidos con incentivos. Si el pedido tiene incentivos, el comercio debe definir esta información. El límite máximo es de 60 caracteres. Longitud máxima: `60`.

whatsappMessage.template.components[].parameters[].order_status.order.shipping

Parámetro	Tipo	Requerido	Descripción
`offset`	integer (int32)	Sí	Debe ser `100` para `INR`.
`value`	integer (int32)	Sí	Entero positivo que representa el valor del importe multiplicado por el desplazamiento (offset). Por ejemplo, ₹12.34 tiene el valor 1234.
`description`	string	No	Úsalo solo para `tax`, `shipping` o `discount`. Descripción del importe. El límite máximo es de 60 caracteres. Longitud máxima: `60`.
`discount_program_name`	string	No	Úsalo solo para `discount`. Texto utilizado para definir pedidos con incentivo. Si el pedido tiene incentivo, el comerciante debe definir esta información. El límite máximo de caracteres es de 60 caracteres. Longitud máxima: `60`.

whatsappMessage.template.components[].parameters[].order_status.order.discount

Parámetro	Tipo	Obligatorio	Descripción
`offset`	integer (int32)	Sí	Debe ser `100` para `INR`.
`value`	integer (int32)	Sí	Entero positivo que representa el valor del importe multiplicado por el desplazamiento (offset). Por ejemplo, ₹12.34 tiene el valor 1234.
`description`	string	No	Úsalo solo para `tax`, `shipping` o `discount`. Descripción del importe. El límite máximo de caracteres es de 60 caracteres. Longitud máxima: `60`.
`discount_program_name`	string	No	Úsalo solo para `discount`. Texto utilizado para definir pedidos con incentivo. Si el pedido tiene incentivo, el comerciante debe definir esta información. El límite máximo de caracteres es de 60 caracteres. Longitud máxima: `60`.

whatsappMessage.template.components[].parameters[].order_status.order.expiration

Parámetro	Tipo	Obligatorio	Descripción
`timestamp`	string	Sí	Cadena de texto con la marca de tiempo UTC en segundos correspondiente al momento en que debe vencer el pedido. El umbral mínimo es de 300 segundos.
`description`	string	No	Explicación en texto sobre el vencimiento. Longitud máxima: `120`.

whatsappMessage.template.components[].parameters[].location

Parámetro	Tipo	Obligatorio	Descripción
`latitude`	number (double)	Sí	Latitud de la ubicación.
`longitude`	number (double)	Sí	Longitud de la ubicación.
`name`	string	No	Nombre de la ubicación.
`address`	string	No	Dirección de la ubicación. Solo se muestra si `name` está presente.

whatsappMessage.template.components[].cards[]

Parámetro	Tipo	Obligatorio	Descripción
`card_index`	integer (int32)	No	Obligatorio. Orden con base cero en el que aparece la tarjeta dentro del carrusel de tarjetas. 0 indica la primera tarjeta, 1 indica la segunda tarjeta, etc. Mínimo: `0`. Máximo: `9`.
`components`	object[]	No	Componente de tarjeta.

whatsappMessage.template.components[].cards[].components[]

Parámetro	Tipo	Obligatorio	Descripción
`type`	string	Sí	Tipo de componente. Valores: `header`, `body`, `button`.
`sub_type`	string	No	Obligatorio cuando el tipo es `button`. Tipo de botón. `quick_reply`: se refiere a un botón de respuesta rápida creado previamente que permite al cliente enviar un mensaje predefinido. `url`: se refiere a un botón de URL creado previamente que permite al cliente visitar la URL generada al añadir el parámetro de texto al prefijo de URL predefinido en la plantilla.
`index`	integer (int32)	No	Obligatorio cuando `type` = `button`. No se utiliza para los demás tipos. Indica el orden en el que debe aparecer el botón si la plantilla utiliza varios botones. Los botones tienen índice con base cero, por lo que establecer el valor en 0 hará que el botón aparezca en primer lugar, y otro botón con índice 1 aparecerá a continuación, etc. Mínimo: `0`. Máximo: `9`.
`parameters`	object[]	No	Obligatorio cuando `type` = `button`, o hay variables en el componente de plantilla correspondiente, o el formato del componente de tarjeta `HEADER` es multimedia (`IMAGE`, `VIDEO`). Matriz de objetos de parámetros con el contenido del mensaje.

whatsappMessage.template.components[].cards[].components[].parameters[]

Parámetro	Tipo	Obligatorio	Descripción
`type`	string	No	Obligatorio. Tipo de parámetro del componente. `text`: se utiliza cuando el tipo de componente de la plantilla es `BODY`, o el formato del componente `HEADER` es `TEXT`. `image`: se utiliza cuando el componente `HEADER` de la plantilla es `IMAGE`. `gif`: se utiliza cuando el componente `HEADER` de la plantilla es `GIF`. `video`: se utiliza cuando el componente `HEADER` de la plantilla es `VIDEO`. `document`: se utiliza cuando el componente `HEADER` de la plantilla es `DOCUMENT`. `payload`: se utiliza cuando el tipo de botón del componente de la plantilla es `QUICK_REPLY`. `coupon_code`: se utiliza cuando el tipo de botón del componente de la plantilla es `COPY_CODE`. `limited_time_offer`: se utiliza cuando el tipo de componente de la plantilla es `LIMITED_TIME_OFFER`. `action`: se utiliza cuando el tipo de botón del componente de la plantilla es `CATALOG`, `MPM`, `FLOW` o `ORDER_DETAILS`. `order_status`: se utiliza cuando la subcategoría de la plantilla es `ORDER_STATUS`. `location`: se utiliza cuando el componente `HEADER` de la plantilla es `LOCATION`.
`text`	string	No	Obligatorio cuando `type` = `text`. El texto del mensaje. Para el componente de encabezado, el límite es de 60 caracteres. Para el componente de cuerpo, el límite es de 1024 caracteres. Para botones de URL, indica el sufijo proporcionado por el desarrollador que se añade a la URL de prefijo predefinida en la plantilla.
`payload`	string	No	Obligatorio para botones `quick_reply`. Payload definido por el desarrollador que se devuelve cuando se hace clic en el botón, además del texto visible en el botón.
`coupon_code`	string	No	Obligatorio cuando `type` = `coupon_code`. El código de cupón que se copiará cuando el cliente toque el botón.
`image`	object	No	Obligatorio cuando el formato `HEADER` de la plantilla es `IMAGE`.
`gif`	object	No	Obligatorio cuando el formato `HEADER` de la plantilla es `GIF`.
`video`	object	No	Obligatorio cuando el formato `HEADER` de la plantilla es `VIDEO`.
`document`	object	No	Obligatorio cuando el formato del template `HEADER` es `DOCUMENT`.
`limited_time_offer`	object	No	Obligatorio si la plantilla utiliza detalles de vencimiento de la oferta.
`action`	object	No	Obligatorio si la plantilla utiliza botones de catálogo o MPM (mensaje multiproducto).
`order_status`	object	No	Los campos del objeto se enumeran a continuación.
`location`	object	No	Obligatorio cuando `type` = `location`.

whatsappMessage.template.components[].cards[].components[].parameters[].image

Parámetro	Tipo	Obligatorio	Descripción
`id`	string	No	Usa esto cuando el archivo multimedia se sube a los servidores de WhatsApp. Proporciona el ID del objeto multimedia obtenido desde la API de subida de archivos multimedia de WhatsApp (https://docs.ycloud.com/reference/whatsapp_media-upload#/). Nota: Se debe proporcionar `id` o `link`. Si se proporcionan ambos, `id` tiene prioridad.
`link`	string	No	Usa esto cuando envíes archivos multimedia directamente desde tu servidor. El protocolo y la URL del archivo multimedia que se enviará. Úsalo solo con URLs HTTP/HTTPS. Nota: WhatsApp Cloud API almacena en caché los recursos multimedia durante 10 minutos. Para asegurarte de que se use el contenido más reciente, añade parámetros de consulta aleatorios a la URL. Nota: Se debe proporcionar `id` o `link`. Si se proporcionan ambos, `id` tiene prioridad y `link` se ignorará.
`caption`	string	No	Describe el archivo multimedia especificado de tipo `image`, `gif`, `video` o `document`. No se aplica en el `header` de mensajes `template` o `interactive`.
`filename`	string	No	Describe el nombre de archivo del documento específico. Úsalo solo con archivos multimedia `document`.

whatsappMessage.template.components[].cards[].components[].parameters[].gif

Parámetro	Tipo	Obligatorio	Descripción
`id`	string	No	Usa esto cuando el archivo multimedia se sube a los servidores de WhatsApp. Proporciona el ID del objeto multimedia obtenido desde la API de subida de archivos multimedia de WhatsApp (https://docs.ycloud.com/reference/whatsapp_media-upload#/). Nota: Se debe proporcionar `id` o `link`. Si se proporcionan ambos, `id` tiene prioridad.
`link`	string	No	Usa esto cuando envíes archivos multimedia directamente desde tu servidor. El protocolo y la URL del archivo multimedia que se enviará. Úsalo solo con URLs HTTP/HTTPS. Nota: WhatsApp Cloud API almacena en caché los recursos multimedia durante 10 minutos. Para asegurarte de que se use el contenido más reciente, añade parámetros de consulta aleatorios a la URL. Nota: Se debe proporcionar `id` o `link`. Si se proporcionan ambos, `id` tiene prioridad y `link` se ignorará.
`caption`	string	No	Describe el archivo multimedia especificado de tipo `image`, `gif`, `video` o `document`. No se aplica en el `header` de mensajes `template` o `interactive`.
`filename`	string	No	Describe el nombre de archivo del documento específico. Úsalo solo con archivos multimedia `document`.

whatsappMessage.template.components[].cards[].components[].parameters[].video

Parámetro	Tipo	Obligatorio	Descripción
`id`	string	No	Usa esto cuando el archivo multimedia se suba a los servidores de WhatsApp. Proporciona el ID del objeto multimedia obtenido de la API de subida de medios de WhatsApp (https://docs.ycloud.com/reference/whatsapp_media-upload#/). Nota: Se debe proporcionar `id` o `link`. Si se proporcionan ambos, `id` tiene prioridad.
`link`	string	No	Usa esto cuando envíes archivos multimedia directamente desde tu servidor. El protocolo y la URL del archivo multimedia que se enviará. Úsalo solo con URL HTTP/HTTPS. Nota: La Cloud API de WhatsApp almacena en caché los recursos multimedia durante 10 minutos. Para asegurarte de tener el contenido más reciente, añade cadenas de consulta aleatorias a la URL. Nota: Se debe proporcionar `id` o `link`. Si se proporcionan ambos, `id` tiene prioridad y se ignorará `link`.
`caption`	string	No	Describe el archivo multimedia `image`, `gif`, `video` o `document` especificado. No aplicable en el `header` de mensajes de `template` o `interactive`.
`filename`	string	No	Describe el nombre de archivo para el documento específico. Úsalo solo con archivos multimedia `document`.

whatsappMessage.template.components[].cards[].components[].parameters[].document

Parámetro	Tipo	Obligatorio	Descripción
`id`	string	No	Usa esto cuando el archivo multimedia se suba a los servidores de WhatsApp. Proporciona el ID del objeto multimedia obtenido de la API de subida de medios de WhatsApp (https://docs.ycloud.com/reference/whatsapp_media-upload#/). Nota: Se debe proporcionar `id` o `link`. Si se proporcionan ambos, `id` tiene prioridad.
`link`	string	No	Usa esto cuando envíes archivos multimedia directamente desde tu servidor. El protocolo y la URL del archivo multimedia que se enviará. Úsalo solo con URL HTTP/HTTPS. Nota: La Cloud API de WhatsApp almacena en caché los recursos multimedia durante 10 minutos. Para asegurarte de tener el contenido más reciente, añade cadenas de consulta aleatorias a la URL. Nota: Se debe proporcionar `id` o `link`. Si se proporcionan ambos, `id` tiene prioridad y se ignorará `link`.
`caption`	string	No	Describe el archivo multimedia `image`, `gif`, `video` o `document` especificado. No aplicable en el `header` de mensajes de `template` o `interactive`.
`filename`	string	No	Describe el nombre de archivo para el documento específico. Úsalo solo con archivos multimedia `document`.

whatsappMessage.template.components[].cards[].components[].parameters[].limited_time_offer

Parámetro	Tipo	Obligatorio	Descripción
`expiration_time_ms`	integer (int64)	No	Obligatorio. Hora de caducidad del código de oferta como marca de tiempo UNIX en milisegundos.

whatsappMessage.template.components[].cards[].components[].parameters[].action

Parámetro	Tipo	Obligatorio	Descripción
`thumbnail_product_retailer_id`	string	No	Opcional. Úsalo para mensajes de plantilla de catálogo y MPM. Número de SKU del artículo. Etiquetado como Content ID en el Administrador de ventas. La miniatura de este artículo se utilizará como la imagen del encabezado del mensaje. Si se omite el objeto `parameters`, se utilizará la imagen del producto del primer artículo de tu catálogo.
`sections`	object[]	No	Úsalo para plantillas MPM. Secciones de productos. Puedes definir hasta 10 secciones.
`flow_token`	string	No	Úsalo para botones de `FLOW`. Token de Flow que genera la empresa para servir como identificador. El valor predeterminado es `unused`.
`flow_action_data`	object	No	Úsalo para botones de `FLOW`. Objeto JSON con la carga útil de datos para la primera pantalla.
`order_details`	object	No	Obligatorio para botones de `order_details`.

whatsappMessage.template.components[].cards[].components[].parameters[].action.sections[]

Parámetro	Tipo	Obligatorio	Descripción
`title`	string	No	Texto del título de la sección. Máximo 24 caracteres. No se admite Markdown. Longitud máxima: `24`.
`product_items`	object[]	No	Matriz de números SKU del producto. Hay un mínimo de 1 producto por sección y un máximo de 30 productos en todas las secciones.

whatsappMessage.template.components[].cards[].components[].parameters[].action.sections[].product_items[]

Parámetro	Tipo	Obligatorio	Descripción
`product_retailer_id`	string	No	Número SKU del artículo que quieres que aparezca en la sección. Los números SKU están etiquetados como Content ID en el Commerce Manager.

whatsappMessage.template.components[].cards[].components[].parameters[].action.order_details

Parámetro	Tipo	Obligatorio	Descripción
`currency`	string	Sí	La moneda de este pedido. Actualmente, el único valor admitido es `INR`.
`order`	object	Sí	Proporciona `status`, `items`, `subtotal`, `tax`, etc. del pedido.
`reference_id`	string	Sí	Identificador único del pedido proporcionado por la empresa. Distingue entre mayúsculas y minúsculas, no puede ser una cadena vacía, solo puede contener letras en inglés, números, guiones bajos, guiones o puntos, y no debe superar los 35 caracteres. El `reference_id` debe ser único para cada mensaje de order_details de una empresa determinada. Si es necesario enviar varios mensajes de order_details para el mismo pedido, se recomienda incluir un número de secuencia en el reference_id (por ejemplo, “BM345A-12”) para garantizar su unicidad._
`total_amount`	object	Sí	El importe total del pedido.
`type`	string	Sí	El tipo de artículos que se pagan en este pedido. Las opciones admitidas actualmente son `digital-goods` y `physical-goods`.
`payment_settings`	object[]	Sí	Configuración de pago del pedido.

whatsappMessage.template.components[].cards[].components[].parameters[].action.order_details.order

Parámetro	Tipo	Obligatorio	Descripción
`status`	string	No	El único valor admitido en el mensaje `order_details` es `pending`. En un mensaje `order_status`, `status` puede ser: `pending`, `processing`, `partially_shipped`, `shipped`, `completed` o `canceled`.
`type`	string	No	El único valor admitido es `quick_pay`. Cuando se pasa este campo, ocultamos el botón “Revisar y pagar” y solo mostramos el botón “Pagar ahora” en la burbuja de detalles del pedido.
`catalog_id`	string	No	Identificador único del catálogo de Facebook que utiliza la empresa. Si no proporcionas este campo, debes proporcionar los siguientes campos dentro del objeto items: `country_of_origin`, `importer_name` y `importer_address`.
`items`	object[]	No	Matriz de artículos del pedido.
`subtotal`	object	No	El valor debe ser igual a la suma de `order.amount.value` * `order.amount.quantity`.
`tax`	object	No	La información de impuestos de este pedido.
`shipping`	object	No	El costo de envío del pedido.
`discount`	object	No	El monto de descuento para este pedido.
`expiration`	object	No	Vencimiento de este pedido.
`description`	string	No	Opcional. Texto para compartir información relacionada con el estado. Puede ser útil al enviar una cancelación. El límite máximo es de 120 caracteres. Longitud máxima: `120`.

whatsappMessage.template.components[].cards[].components[].parameters[].action.order_details.order.items[]

Parámetro	Tipo	Requerido	Descripción
`retailer_id`	string	No	Content ID de un artículo en el pedido procedente de tu catálogo.
`name`	string	Sí	El nombre del artículo que se mostrará al usuario. No puede superar los 60 caracteres. Longitud máxima: `60`.
`image`	object	No	Imagen personalizada del artículo que se mostrará al usuario.
`amount`	object	Sí	El precio por artículo.
`sale_amount`	object	No	El precio con descuento por artículo. Debe ser inferior al monto original. Si se incluye, este campo se utiliza para calcular el subtotal.
`quantity`	integer (int32)	Sí	La cantidad de artículos en el pedido.
`country_of_origin`	string	No	Requerido si `catalog_id` no está presente. El país de origen del producto.
`importer_name`	string	No	Requerido si `catalog_id` no está presente. Nombre de la empresa importadora.
`importer_address`	string	No	Requerido si `catalog_id` no está presente. Dirección de la empresa importadora.

whatsappMessage.template.components[].cards[].components[].parameters[].action.order_details.order.items[].image

Parámetro	Tipo	Requerido	Descripción
`id`	string	No	Usa esto cuando el contenido multimedia se suba a los servidores de WhatsApp. Proporciona el ID del objeto multimedia obtenido de la API de subida de contenido multimedia de WhatsApp (https://docs.ycloud.com/reference/whatsapp_media-upload#/). Nota: Se debe proporcionar `id` o `link`. Si se proporcionan ambos, `id` tiene prioridad.
`link`	string	No	Usa esto al enviar contenido multimedia directamente desde tu servidor. El protocolo y la URL del contenido multimedia que se enviará. Úsalo únicamente con URL HTTP/HTTPS. Nota: La Cloud API de WhatsApp almacena en caché los recursos multimedia durante 10 minutos. Para asegurarte de tener el contenido más reciente, añade parámetros de consulta aleatorios a la URL. Nota: Se debe proporcionar `id` o `link`. Si se proporcionan ambos, `id` tiene prioridad y `link` se ignorará.
`caption`	string	No	Describe el archivo multimedia `image`, `gif`, `video` o `document` especificado. No es aplicable en el `header` de mensajes `template` o `interactive`.
`filename`	string	No	Describe el nombre de archivo del documento específico. Usa solo con contenido multimedia `document`.

whatsappMessage.template.components[].cards[].components[].parameters[].action.order_details.order.items[].amount

Parámetro	Tipo	Obligatorio	Descripción
`offset`	integer (int32)	Sí	Debe ser `100` para `INR`.
`value`	integer (int32)	Sí	Entero positivo que representa el valor del importe multiplicado por el desplazamiento. Por ejemplo, ₹12.34 tiene el valor 1234.
`description`	string	No	Usa solo para `tax`, `shipping` o `discount`. Descripción del importe. El límite máximo de caracteres es de 60 caracteres. Longitud máxima: `60`.
`discount_program_name`	string	No	Usa solo para `discount`. Texto utilizado para definir pedidos con incentivos. Si el pedido tiene incentivos, el comerciante debe definir esta información. El límite máximo de caracteres es de 60 caracteres. Longitud máxima: `60`.

whatsappMessage.template.components[].cards[].components[].parameters[].action.order_details.order.items[].sale_amount

Parámetro	Tipo	Obligatorio	Descripción
`offset`	integer (int32)	Sí	Debe ser `100` para `INR`.
`value`	integer (int32)	Sí	Entero positivo que representa el valor del importe multiplicado por el desplazamiento. Por ejemplo, ₹12.34 tiene el valor 1234.
`description`	string	No	Usa solo para `tax`, `shipping` o `discount`. Descripción del importe. El límite máximo de caracteres es de 60 caracteres. Longitud máxima: `60`.
`discount_program_name`	string	No	Usa solo para `discount`. Texto utilizado para definir pedidos con incentivos. Si el pedido tiene incentivos, el comerciante debe definir esta información. El límite máximo de caracteres es de 60 caracteres. Longitud máxima: `60`.

whatsappMessage.template.components[].cards[].components[].parameters[].action.order_details.order.subtotal

Parámetro	Tipo	Obligatorio	Descripción
`offset`	integer (int32)	Sí	Debe ser `100` para `INR`.
`value`	integer (int32)	Sí	Entero positivo que representa el valor del importe multiplicado por el desplazamiento. Por ejemplo, ₹12.34 tiene el valor 1234.
`description`	string	No	Usa solo para `tax`, `shipping` o `discount`. Descripción del importe. El límite máximo de caracteres es de 60 caracteres. Longitud máxima: `60`.
`discount_program_name`	string	No	Usa solo para `discount`. Texto utilizado para definir pedidos con incentivos. Si el pedido tiene incentivos, el comerciante debe definir esta información. El límite máximo de caracteres es de 60 caracteres. Longitud máxima: `60`.

whatsappMessage.template.components[].cards[].components[].parameters[].action.order_details.order.tax

Parámetro	Tipo	Obligatorio	Descripción
`offset`	integer (int32)	Sí	Debe ser `100` para `INR`.
`value`	integer (int32)	Sí	Entero positivo que representa el valor del importe multiplicado por el offset. Por ejemplo, ₹12.34 tiene el valor 1234.
`description`	string	No	Úsalo solo para `tax`, `shipping` o `discount`. Descripción del importe. El límite máximo de caracteres es de 60 caracteres. Longitud máxima: `60`.
`discount_program_name`	string	No	Úsalo solo para `discount`. Texto utilizado para definir pedidos con incentivo. Si el pedido tiene incentivo, el comerciante debe definir esta información. El límite máximo de caracteres es de 60 caracteres. Longitud máxima: `60`.

whatsappMessage.template.components[].cards[].components[].parameters[].action.order_details.order.shipping

Parámetro	Tipo	Obligatorio	Descripción
`offset`	integer (int32)	Sí	Debe ser `100` para `INR`.
`value`	integer (int32)	Sí	Entero positivo que representa el valor del importe multiplicado por el offset. Por ejemplo, ₹12.34 tiene el valor 1234.
`description`	string	No	Úsalo solo para `tax`, `shipping` o `discount`. Descripción del importe. El límite máximo de caracteres es de 60 caracteres. Longitud máxima: `60`.
`discount_program_name`	string	No	Úsalo solo para `discount`. Texto utilizado para definir pedidos con incentivo. Si el pedido tiene incentivo, el comerciante debe definir esta información. El límite máximo de caracteres es de 60 caracteres. Longitud máxima: `60`.

whatsappMessage.template.components[].cards[].components[].parameters[].action.order_details.order.discount

Parámetro	Tipo	Obligatorio	Descripción
`offset`	integer (int32)	Sí	Debe ser `100` para `INR`.
`value`	integer (int32)	Sí	Entero positivo que representa el valor del importe multiplicado por el offset. Por ejemplo, ₹12.34 tiene el valor 1234.
`description`	string	No	Úsalo solo para `tax`, `shipping` o `discount`. Descripción del importe. El límite máximo de caracteres es de 60 caracteres. Longitud máxima: `60`.
`discount_program_name`	string	No	Úsalo solo para `discount`. Texto utilizado para definir pedidos con incentivo. Si el pedido tiene incentivo, el comerciante debe definir esta información. El límite máximo de caracteres es de 60 caracteres. Longitud máxima: `60`.

whatsappMessage.template.components[].cards[].components[].parameters[].action.order_details.order.expiration

Parámetro	Tipo	Obligatorio	Descripción
`timestamp`	string	Sí	Una cadena de marca de tiempo UTC en segundos del momento en que debe expirar el pedido. El umbral mínimo es de 300 segundos.
`description`	string	No	Explicación en texto para la expiración. Longitud máxima: `120`.

whatsappMessage.template.components[].cards[].components[].parameters[].action.order_details.total_amount

Parámetro	Tipo	Obligatorio	Descripción
`offset`	integer (int32)	Sí	Debe ser `100` para `INR`.
`value`	integer (int32)	Sí	Entero positivo que representa el valor del importe multiplicado por el desplazamiento (offset). Por ejemplo, ₹12.34 tiene el valor 1234.
`description`	string	No	Úsalo solo para `tax`, `shipping` o `discount`. Descripción del importe. El límite máximo de caracteres es de 60 caracteres. Longitud máxima: `60`.
`discount_program_name`	string	No	Úsalo solo para `discount`. Texto utilizado para definir pedidos con incentivos. Si el pedido tiene incentivos, el comerciante debe definir esta información. El límite máximo de caracteres es de 60 caracteres. Longitud máxima: `60`.

whatsappMessage.template.components[].cards[].components[].parameters[].action.order_details.payment_settings[]

Parámetro	Tipo	Obligatorio	Descripción
`type`	string	Sí	Debe establecerse en `payment_gateway`.
`payment_gateway`	object	Sí	Un objeto que describe la información de la cuenta de pago.

whatsappMessage.template.components[].cards[].components[].parameters[].action.order_details.payment_settings[].payment_gateway

Parámetro	Tipo	Obligatorio	Descripción
`type`	string	Sí	Tipo de pago. Debes establecer esto en `billdesk`, `razorpay`, `payu` o `zaakpay`, si has vinculado tu pasarela de pago de BillDesk, Razorpay, PayU o Zaakpay para aceptar pagos.
`configuration_name`	string	Sí	El nombre de la configuración de pago preconfigurada que se utilizará para este pedido; no debe superar los 60 caracteres. Este valor debe coincidir con una configuración de pago establecida en WhatsApp Business Manager. Longitud máxima: `60`.
`billdesk`	object	No	Información adicional para BillDesk. Los campos definidos por el usuario (extra) se utilizan para almacenar cualquier información correspondiente a un pedido en particular. Cada campo extra tiene un límite máximo de 120 caracteres.
`payu`	object	No	Información adicional para PayU. Los campos definidos por el usuario (udf) se utilizan para almacenar cualquier información correspondiente a un pedido en particular. Cada campo UDF tiene un límite máximo de 255 caracteres.
`razorpay`	object	No	Información adicional para Razorpay.
`zaakpay`	object	No	Información adicional para Zaakpay. Los campos definidos por el usuario (extra) se utilizan para almacenar cualquier información correspondiente a un pedido en particular. Cada campo extra tiene un límite máximo de 180 caracteres.

whatsappMessage.template.components[].cards[].components[].parameters[].action.order_details.payment_settings[].payment_gateway.billdesk

Parámetro	Tipo	Obligatorio	Descripción
`additional_info1`	string	No	Información definida por el usuario sobre este pedido para BillDesk. Longitud máxima: `120` caracteres.
`additional_info2`	string	No	Información definida por el usuario sobre este pedido para BillDesk. Longitud máxima: `120` caracteres.
`additional_info3`	string	No	Información definida por el usuario sobre este pedido para BillDesk. Longitud máxima: `120` caracteres.
`additional_info4`	string	No	Información definida por el usuario sobre este pedido para BillDesk. Longitud máxima: `120` caracteres.
`additional_info5`	string	No	Información definida por el usuario sobre este pedido para BillDesk. Longitud máxima: `120` caracteres.
`additional_info6`	string	No	Información definida por el usuario sobre este pedido para BillDesk. Longitud máxima: `120` caracteres.
`additional_info7`	string	No	Información definida por el usuario sobre este pedido para BillDesk. Longitud máxima: `120` caracteres.

whatsappMessage.template.components[].cards[].components[].parameters[].action.order_details.payment_settings[].payment_gateway.payu

Parámetro	Tipo	Obligatorio	Descripción
`udf1`	string	No	Información definida por el usuario sobre este pedido para PayU. Longitud máxima: `255` caracteres.
`udf2`	string	No	Información definida por el usuario sobre este pedido para PayU. Longitud máxima: `255` caracteres.
`udf3`	string	No	Información definida por el usuario sobre este pedido para PayU. Longitud máxima: `255` caracteres.
`udf4`	string	No	Información definida por el usuario sobre este pedido para PayU. Longitud máxima: `255` caracteres.

whatsappMessage.template.components[].cards[].components[].parameters[].action.order_details.payment_settings[].payment_gateway.razorpay

Parámetro	Tipo	Obligatorio	Descripción
`receipt`	string	No	Número de recibo que corresponde a este pedido, configurado para tu referencia interna. Admite una longitud máxima de 40 caracteres con una longitud mínima superior a 0 caracteres.
`notes`	object	No	El objeto puede ser pares clave-valor con un máximo de 15 claves y cada valor tiene un límite de 256 caracteres.

whatsappMessage.template.components[].cards[].components[].parameters[].action.order_details.payment_settings[].payment_gateway.zaakpay

Parámetro	Tipo	Obligatorio	Descripción
`extra1`	string	No	Información definida por el usuario sobre este pedido para Zaakpay. Longitud máxima: `180` caracteres.
`extra2`	string	No	Información definida por el usuario sobre este pedido para Zaakpay. Longitud máxima: `180` caracteres.

whatsappMessage.template.components[].cards[].components[].parameters[].order_status

Parámetro	Tipo	Obligatorio	Descripción
`reference_id`	string	No	Identificador único del pedido proporcionado por la empresa.
`order`	object	No	Proporciona solo `status` y `description` de este pedido para mensajes `order_status`.

whatsappMessage.template.components[].cards[].components[].parameters[].order_status.order

Parámetro	Tipo	Obligatorio	Descripción
`status`	string	No	El único valor admitido en el mensaje `order_details` es `pending`. En un mensaje `order_status`, `status` puede ser: `pending`, `processing`, `partially_shipped`, `shipped`, `completed` o `canceled`.
`type`	string	No	El único valor admitido es `quick_pay`. Cuando se pasa este campo, ocultamos el botón “Review and Pay” y solo mostramos el botón “Pay Now” en la burbuja de detalles del pedido.
`catalog_id`	string	No	Identificador único del catálogo de Facebook utilizado por la empresa. Si no proporcionas este campo, debes proporcionar los siguientes campos dentro del objeto items: `country_of_origin`, `importer_name` y `importer_address`.
`items`	object[]	No	Array de artículos en el pedido.
`subtotal`	object	No	El valor debe ser igual a la suma de `order.amount.value` * `order.amount.quantity`.
`tax`	object	No	La información de impuestos de este pedido.
`shipping`	object	No	El costo de envío del pedido.
`discount`	object	No	El monto de descuento para este pedido.
`expiration`	object	No	Vencimiento de este pedido.
`description`	string	No	Opcional. Texto para compartir información relacionada con el estado. Puede ser útil al enviar una cancelación. El límite máximo de caracteres es de 120 caracteres. Longitud máxima: `120`.

whatsappMessage.template.components[].cards[].components[].parameters[].order_status.order.items[]

Parámetro	Tipo	Obligatorio	Descripción
`retailer_id`	string	No	ID de contenido de un artículo del pedido perteneciente a tu catálogo.
`name`	string	Sí	El nombre del artículo que se mostrará al usuario. No puede superar los 60 caracteres. Longitud máxima: `60`.
`image`	object	No	Imagen personalizada del artículo que se mostrará al usuario.
`amount`	object	Sí	El precio por artículo.
`sale_amount`	object	No	El precio con descuento por artículo. Debe ser inferior al monto original. Si se incluye, este campo se utiliza para calcular el subtotal.
`quantity`	integer (int32)	Sí	La cantidad de artículos en el pedido.
`country_of_origin`	string	No	Obligatorio si `catalog_id` no está presente. El país de origen del producto.
`importer_name`	string	No	Obligatorio si `catalog_id` no está presente. Nombre de la empresa importadora.
`importer_address`	string	No	Obligatorio si `catalog_id` no está presente. Dirección de la empresa importadora.

whatsappMessage.template.components[].cards[].components[].parameters[].order_status.order.items[].image

Parámetro	Tipo	Obligatorio	Descripción
`id`	string	No	Usa esto cuando los archivos multimedia se suban a los servidores de WhatsApp. Proporciona el ID del objeto multimedia obtenido de la API de subida de medios de WhatsApp (https://docs.ycloud.com/reference/whatsapp_media-upload#/). Nota: Se debe proporcionar `id` o `link`. Si se proporcionan ambos, `id` tiene prioridad.
`link`	string	No	Usa esto al enviar contenido multimedia directamente desde tu servidor. El protocolo y la URL del contenido multimedia que se va a enviar. Úsalo únicamente con URL HTTP/HTTPS. Nota: La API de WhatsApp Cloud almacena en caché los recursos multimedia durante 10 minutos. Para asegurar el contenido más reciente, añade cadenas de consulta aleatorias a la URL. Nota: Se debe proporcionar `id` o `link`. Si se proporcionan ambos, `id` tendrá prioridad y `link` se ignorará.
`caption`	string	No	Describe el contenido multimedia `image`, `gif`, `video` o `document` especificado. No aplicable en el `header` de mensajes `template` o `interactive`.
`filename`	string	No	Describe el nombre de archivo para el documento específico. Úsalo únicamente con contenido multimedia `document`.

whatsappMessage.template.components[].cards[].components[].parameters[].order_status.order.items[].amount

Parámetro	Tipo	Obligatorio	Descripción
`offset`	integer (int32)	Sí	Debe ser `100` para `INR`.
`value`	integer (int32)	Sí	Entero positivo que representa el valor del importe multiplicado por el desplazamiento. Por ejemplo, ₹12.34 tiene el valor 1234.
`description`	string	No	Úsalo solo para `tax`, `shipping` o `discount`. Descripción del importe. El límite máximo es de 60 caracteres. Longitud máxima: `60`.
`discount_program_name`	string	No	Úsalo solo para `discount`. Texto utilizado para definir pedidos con incentivos. Si el pedido tiene incentivos, el comerciante debe definir esta información. El límite máximo es de 60 caracteres. Longitud máxima: `60`.

whatsappMessage.template.components[].cards[].components[].parameters[].order_status.order.items[].sale_amount

Parámetro	Tipo	Obligatorio	Descripción
`offset`	integer (int32)	Sí	Debe ser `100` para `INR`.
`value`	integer (int32)	Sí	Entero positivo que representa el valor del importe multiplicado por el desplazamiento. Por ejemplo, ₹12.34 tiene el valor 1234.
`description`	string	No	Úsalo solo para `tax`, `shipping` o `discount`. Descripción del importe. El límite máximo es de 60 caracteres. Longitud máxima: `60`.
`discount_program_name`	string	No	Úsalo solo para `discount`. Texto utilizado para definir pedidos con incentivos. Si el pedido tiene incentivos, el comerciante debe definir esta información. El límite máximo es de 60 caracteres. Longitud máxima: `60`.

whatsappMessage.template.components[].cards[].components[].parameters[].order_status.order.subtotal

Parámetro	Tipo	Obligatorio	Descripción
`offset`	integer (int32)	Sí	Debe ser `100` para `INR`.
`value`	integer (int32)	Sí	Entero positivo que representa el valor del importe multiplicado por el desplazamiento. Por ejemplo, ₹12.34 tiene el valor 1234.
`description`	string	No	Úsalo solo para `tax`, `shipping` o `discount`. Descripción del importe. El límite máximo es de 60 caracteres. Longitud máxima: `60`.
`discount_program_name`	string	No	Úsalo solo para `discount`. Texto utilizado para definir pedidos con incentivos. Si el pedido tiene incentivos, el comerciante debe definir esta información. El límite máximo de caracteres es de 60. Longitud máxima: `60`.

whatsappMessage.template.components[].cards[].components[].parameters[].order_status.order.tax

Parámetro	Tipo	Obligatorio	Descripción
`offset`	integer (int32)	Sí	Debe ser `100` para `INR`.
`value`	integer (int32)	Sí	Entero positivo que representa el valor del importe multiplicado por offset. Por ejemplo, ₹12.34 tiene el valor 1234.
`description`	string	No	Úsalo solo para `tax`, `shipping` o `discount`. Descripción del importe. El límite máximo de caracteres es de 60. Longitud máxima: `60`.
`discount_program_name`	string	No	Úsalo solo para `discount`. Texto utilizado para definir pedidos con incentivos. Si el pedido tiene incentivos, el comerciante debe definir esta información. El límite máximo de caracteres es de 60. Longitud máxima: `60`.

whatsappMessage.template.components[].cards[].components[].parameters[].order_status.order.shipping

Parámetro	Tipo	Obligatorio	Descripción
`offset`	integer (int32)	Sí	Debe ser `100` para `INR`.
`value`	integer (int32)	Sí	Entero positivo que representa el valor del importe multiplicado por offset. Por ejemplo, ₹12.34 tiene el valor 1234.
`description`	string	No	Úsalo solo para `tax`, `shipping` o `discount`. Descripción del importe. El límite máximo de caracteres es de 60. Longitud máxima: `60`.
`discount_program_name`	string	No	Úsalo solo para `discount`. Texto utilizado para definir pedidos con incentivos. Si el pedido tiene incentivos, el comerciante debe definir esta información. El límite máximo de caracteres es de 60. Longitud máxima: `60`.

whatsappMessage.template.components[].cards[].components[].parameters[].order_status.order.discount

Parámetro	Tipo	Obligatorio	Descripción
`offset`	integer (int32)	Sí	Debe ser `100` para `INR`.
`value`	integer (int32)	Sí	Entero positivo que representa el valor del importe multiplicado por offset. Por ejemplo, ₹12.34 tiene el valor 1234.
`description`	string	No	Úsalo solo para `tax`, `shipping` o `discount`. Descripción del importe. El límite máximo de caracteres es de 60. Longitud máxima: `60`.
`discount_program_name`	string	No	Úsalo solo para `discount`. Texto utilizado para definir pedidos con incentivos. Si el pedido tiene incentivos, el comerciante debe definir esta información. El límite máximo de caracteres es de 60. Longitud máxima: `60`.

whatsappMessage.template.components[].cards[].components[].parameters[].order_status.order.expiration

Parámetro	Tipo	Obligatorio	Descripción
`timestamp`	string	Sí	Cadena de marca de tiempo UTC en segundos del momento en que debe expirar el pedido. El umbral mínimo es de 300 segundos.
`description`	string	No	Explicación de texto para la expiración. Longitud máxima: `120`.

whatsappMessage.template.components[].cards[].components[].parameters[].location

Parámetro	Tipo	Requerido	Descripción
`latitude`	number (double)	Sí	Latitud de la ubicación.
`longitude`	number (double)	Sí	Longitud de la ubicación.
`name`	string	No	Nombre de la ubicación.
`address`	string	No	Dirección de la ubicación. Solo se muestra si `name` está presente.

whatsappMessage.text

Parámetro	Tipo	Requerido	Descripción
`body`	string	Sí	Obligatorio para mensajes de texto. El texto del mensaje de texto, que puede contener URL que comiencen con http:// o https:// y formato. Consulta las opciones de formato disponibles aquí. Si incluyes URL en tu texto y quieres incluir un cuadro de vista previa en los mensajes de texto (preview_url: true), asegúrate de que la URL comience con http:// o https://; se prefieren las URL con https://. Debes incluir un nombre de host, ya que las direcciones IP no coincidirán. Longitud máxima: 4096 caracteres. Longitud máxima: `4096`.
`preview_url`	boolean	No	De forma predeterminada, WhatsApp reconoce las URL y las hace clicables, pero también puedes incluir un cuadro de vista previa con más información sobre el enlace. Establece este campo en true si quieres incluir un cuadro de vista previa de URL. La mayoría de las veces, el destinatario verá una URL en la que puede hacer clic cuando envíes una URL, establezcas preview_url en true y proporciones un objeto body con un enlace http o https. Las vistas previas de URL solo se muestran después de que haya ocurrido una de las siguientes situaciones: La empresa ha enviado una plantilla de mensaje al usuario. El usuario inicia una conversación con un enlace de “clic para chatear”. El usuario agrega el número de teléfono de la empresa a su libreta de contactos e inicia una conversación. Valor predeterminado: `false`.

whatsappMessage.image

Parámetro	Tipo	Requerido	Descripción
`id`	string	No	Usa esto cuando el archivo multimedia se suba a los servidores de WhatsApp. Proporciona el ID del objeto multimedia obtenido de la API de subida de archivos multimedia de WhatsApp (https://docs.ycloud.com/reference/whatsapp_media-upload#/). Nota: Se debe proporcionar `id` o `link`. Si se proporcionan ambos, `id` tiene prioridad.
`link`	string	No	Usa esto cuando envíes archivos multimedia directamente desde tu servidor. El protocolo y la URL del archivo multimedia que se enviará. Úsalo solo con URL HTTP/HTTPS. Nota: WhatsApp Cloud API almacena en caché los recursos multimedia durante 10 minutos. Para asegurar el contenido más reciente, añade cadenas de consulta aleatorias a la URL. Nota: Se debe proporcionar `id` o `link`. Si se proporcionan ambos, `id` tiene prioridad y `link` se ignorará.
`caption`	string	No	Describe el contenido multimedia especificado de `image`, `gif`, `video` o `document`. No aplica en el `header` de mensajes de `template` o `interactive`.
`filename`	string	No	Describe el nombre de archivo para el documento específico. Úsalo solo con archivos multimedia de tipo `document`.

whatsappMessage.video

Parámetro	Tipo	Requerido	Descripción
`id`	string	No	Úsalo cuando el archivo multimedia se suba a los servidores de WhatsApp. Proporciona el ID del objeto multimedia obtenido de la API de subida de archivos multimedia de WhatsApp (https://docs.ycloud.com/reference/whatsapp_media-upload#/). Nota: Debes proporcionar `id` o `link`. Si se proporcionan ambos, prevalece `id`.
`link`	string	No	Úsalo cuando envíes archivos multimedia directamente desde tu servidor. El protocolo y la URL del archivo multimedia que se enviará. Úsalo solo con URL HTTP/HTTPS. Nota: La API de WhatsApp Cloud almacena en caché los recursos multimedia durante 10 minutos. Para asegurarte de tener el contenido más reciente, añade parámetros de consulta (query strings) aleatorios a la URL. Nota: Debes proporcionar `id` o `link`. Si se proporcionan ambos, prevalece `id` y `link` se ignorará.
`caption`	string	No	Describe el archivo multimedia especificado (`image`, `gif`, `video` o `document`). No aplicable en el `header` de mensajes de `template` o `interactive`.
`filename`	string	No	Describe el nombre de archivo para el documento específico. Úsalo solo con contenido multimedia `document`.

whatsappMessage.audio

Parámetro	Tipo	Requerido	Descripción
`id`	string	No	Úsalo cuando el archivo multimedia se suba a los servidores de WhatsApp. Proporciona el ID del objeto multimedia obtenido de la API de subida de archivos multimedia de WhatsApp (https://docs.ycloud.com/reference/whatsapp_media-upload#/). Nota: Debes proporcionar `id` o `link`. Si se proporcionan ambos, prevalece `id`.
`link`	string	No	Úsalo cuando envíes archivos multimedia directamente desde tu servidor. El protocolo y la URL del archivo multimedia que se enviará. Úsalo solo con URL HTTP/HTTPS. Nota: La API de WhatsApp Cloud almacena en caché los recursos multimedia durante 10 minutos. Para asegurarte de tener el contenido más reciente, añade parámetros de consulta (query strings) aleatorios a la URL. Nota: Debes proporcionar `id` o `link`. Si se proporcionan ambos, prevalece `id` y `link` se ignorará.
`caption`	string	No	Describe el archivo multimedia especificado (`image`, `gif`, `video` o `document`). No aplicable en el `header` de mensajes de `template` o `interactive`.
`filename`	string	No	Describe el nombre de archivo para el documento específico. Úsalo solo con contenido multimedia `document`.

whatsappMessage.document

Parámetro	Tipo	Requerido	Descripción
`id`	string	No	Úsalo cuando el archivo multimedia se suba a los servidores de WhatsApp. Proporciona el ID del objeto multimedia obtenido de la API de subida de archivos multimedia de WhatsApp (https://docs.ycloud.com/reference/whatsapp_media-upload#/). Nota: Debes proporcionar `id` o `link`. Si se proporcionan ambos, prevalece `id`.
`link`	string	No	Úsalo cuando envíes archivos multimedia directamente desde tu servidor. El protocolo y la URL del archivo multimedia que se enviará. Úsalo solo con URL HTTP/HTTPS. Nota: La API de WhatsApp Cloud almacena en caché los recursos multimedia durante 10 minutos. Para asegurarte de tener el contenido más reciente, añade parámetros de consulta (query strings) aleatorios a la URL. Nota: Debes proporcionar `id` o `link`. Si se proporcionan ambos, prevalece `id` y `link` se ignorará.
`caption`	string	No	Describe el archivo multimedia `image`, `gif`, `video` o `document` especificado. No aplicable en el `header` de mensajes `template` o `interactive`.
`filename`	string	No	Describe el nombre de archivo para el documento específico. Úsalo solo con archivos multimedia `document`.

whatsappMessage.sticker

Parámetro	Tipo	Obligatorio	Descripción
`id`	string	No	Usa esto cuando el archivo multimedia se suba a los servidores de WhatsApp. Proporciona el ID del objeto multimedia obtenido de la API de subida de medios de WhatsApp (https://docs.ycloud.com/reference/whatsapp_media-upload#/). Nota: Se debe proporcionar `id` o `link`. Si se proporcionan ambos, `id` tiene prioridad.
`link`	string	No	Usa esto al enviar archivos multimedia directamente desde tu servidor. El protocolo y la URL del archivo multimedia que se va a enviar. Úsalo solo con URL HTTP/HTTPS. Nota: WhatsApp Cloud API almacena en caché los recursos multimedia durante 10 minutos. Para asegurarte de tener el contenido más reciente, añade cadenas de consulta aleatorias a la URL. Nota: Se debe proporcionar `id` o `link`. Si se proporcionan ambos, `id` tiene prioridad y `link` se ignorará.
`caption`	string	No	Describe el archivo multimedia `image`, `gif`, `video` o `document` especificado. No aplicable en el `header` de mensajes `template` o `interactive`.
`filename`	string	No	Describe el nombre de archivo para el documento específico. Úsalo solo con archivos multimedia `document`.

whatsappMessage.location

Parámetro	Tipo	Obligatorio	Descripción
`latitude`	number (double)	Sí	Latitud de la ubicación.
`longitude`	number (double)	Sí	Longitud de la ubicación.
`name`	string	No	Nombre de la ubicación.
`address`	string	No	Dirección de la ubicación. Solo se muestra si `name` está presente.

whatsappMessage.interactive

Parámetro	Tipo	Obligatorio	Descripción
`type`	string	No	Obligatorio. El tipo de mensaje interactivo que deseas enviar. `button`: Úsalo para botones de respuesta. `list`: Úsalo para mensajes de lista. `cta_url`: Úsalo para mensajes con botón de llamada a la acción (CTA) con URL. `product`: Úsalo para mensajes de producto único. `product_list`: Úsalo para mensajes multiproducto. `catalog_message`: Úsalo para mensajes de catálogo. `location_request_message`: Úsalo para mensajes de solicitud de ubicación. `order_details`: Úsalo para mensajes de detalles del pedido. `order_status`: Úsalo para mensajes de estado del pedido. `voice_call`: Úsalo para mensajes de llamada de voz. `flow`: Úsalo para mensajes Flow.
`action`	object	No	Obligatorio. Acción que deseas que el usuario realice después de leer el mensaje `interactive`.
`body`	object	No	Opcional para el tipo `product`. Obligatorio para otros tipos de mensaje.
`header`	object	No	Obligatorio para el tipo `product_list`. Opcional para otros tipos.
`footer`	object	No	Opcional. Un objeto con el pie de página del mensaje.

whatsappMessage.interactive.action

Parámetro	Tipo	Obligatorio	Descripción
`buttons`	object[]	No	Obligatorio para Reply Buttons. Puedes incluir hasta 3 botones.
`button`	string	No	Obligatorio para mensajes de lista. Contenido del botón. No puede ser una cadena vacía y debe ser único dentro del mensaje. Se admiten emojis, pero no markdown. Longitud máxima: 20 caracteres. Longitud máxima: `20`.
`catalog_id`	string	No	Obligatorio para Single Product Messages y Multi-Product Messages. Identificador único del catálogo de Facebook vinculado a tu cuenta de WhatsApp Business. Este ID se puede obtener a través del Meta Commerce Manager.
`product_retailer_id`	string	No	Obligatorio para Single Product Messages y Multi-Product Messages. Identificador único del producto en un catálogo.
`sections`	object[]	No	Obligatorio para mensajes de lista y Multi-Product Messages. Matriz de objetos de sección. Mínimo 1, máximo 10.
`name`	string	No	Nombre de la acción. Obligatorio para botones de llamada a la acción (CTA). `cta_url`: Úsalo para botones de URL de llamada a la acción (CTA). `catalog_message`: Úsalo para Catalog Messages. `send_location`: Úsalo para botones de solicitud de ubicación. `flow`: Úsalo para botones de Flow. `review_and_pay`: Úsalo para botones de detalles del pedido. `review_order`: Úsalo para botones de estado del pedido. `voice_call`: Úsalo para botones de llamada de voz.
`parameters`	object	No	Parámetros de la acción. Obligatorio para botones de llamada a la acción (CTA).

whatsappMessage.interactive.action.buttons[]

Parámetro	Tipo	Obligatorio	Descripción
`type`	string	No	El único tipo admitido es `reply` (para Reply Button).
`reply`	object	No	Los campos del objeto se indican a continuación.

whatsappMessage.interactive.action.buttons[].reply

Parámetro	Tipo	Obligatorio	Descripción
`title`	string	No	Título del botón. No puede ser una cadena vacía y debe ser único dentro del mensaje. Se admiten emojis, pero no markdown. Longitud máxima: 20 caracteres. Longitud máxima: `20`.
`id`	string	No	Identificador único de tu botón. Este ID se devuelve en el webhook cuando el usuario hace clic en el botón. Longitud máxima: 256 caracteres. No puedes incluir espacios iniciales o finales al establecer el ID. Longitud máxima: `256`.

whatsappMessage.interactive.action.sections[]

Parámetro	Tipo	Obligatorio	Descripción
`title`	string	No	Obligatorio si el mensaje tiene más de una sección. Título de la sección. Longitud máxima: 24 caracteres. Longitud máxima: `24`.
`rows`	object[]	No	Contiene una lista de filas. Puedes tener un total de 10 filas entre todas tus secciones. Cada fila debe tener un título (longitud máxima: 24 caracteres) y un ID (longitud máxima: 200 caracteres). Puedes añadir una descripción (longitud máxima: 72 caracteres), pero es opcional.
`product_items`	object[]	No	Obligatorio para mensajes multiproducto. Matriz de objetos de producto. Hay un mínimo de 1 producto por sección y un máximo de 30 productos en todas las secciones.

whatsappMessage.interactive.action.sections[].rows[]

Parámetro	Tipo	Obligatorio	Descripción
`id`	string	No	ID único de la fila. Longitud máxima: 200 caracteres. Longitud máxima: `200`.
`title`	string	No	Contenido del título de la fila. Longitud máxima: 24 caracteres. Longitud máxima: `24`.
`description`	string	No	Contenido de la descripción de la fila. Longitud máxima: 72 caracteres. Longitud máxima: `72`.

whatsappMessage.interactive.action.sections[].product_items[]

Parámetro	Tipo	Obligatorio	Descripción
`product_retailer_id`	string	No	Obligatorio para mensajes multiproducto. Identificador único del producto en un catálogo.

whatsappMessage.interactive.action.parameters

Parámetro	Tipo	Obligatorio	Descripción
`display_text`	string	No	Texto del botón CTA de URL. Longitud máxima: 20 bytes. Longitud máxima: `20`.
`url`	string	No	URL del botón CTA de URL.
`thumbnail_product_retailer_id`	string	No	Número de SKU del artículo. Etiquetado como Content ID en el Commerce Manager. La miniatura de este artículo se utilizará como la imagen de encabezado del mensaje.
`flow_message_version`	string	No	Se utiliza para botones `flow`. El valor debe ser “3”.
`flow_token`	string	No	Se utiliza para botones `flow`. Token del Flow generado por la empresa para servir como identificador. El valor predeterminado es `unused`.
`flow_id`	string	No	Obligatorio condicionalmente para botones `flow`. ID único del Flow proporcionado por WhatsApp. No se puede utilizar con el parámetro `flow_name`.
`flow_name`	string	No	Obligatorio condicionalmente para botones `flow`. El nombre del Flow que creaste. No se puede utilizar con el parámetro `flow_id`. Cambiar el nombre del Flow requerirá actualizar este parámetro para que coincida con el nuevo nombre.
`flow_cta`	string	No	Obligatorio para botones `flow`. Texto en el botón CTA. Por ejemplo: “Open flow!”. Longitud máxima: 20 caracteres. Longitud máxima: `20`.
`flow_action`	string	No	Se utiliza para botones `flow`. Ya sea `navigate` o `data_exchange`. El valor predeterminado es `navigate`.
`flow_action_payload`	object	No	Obligatorio si `flow_action` es `navigate`. Debe omitirse en caso contrario.
`reference_id`	string	No	Obligatorio para los botones `review_y_pay`. Identificador único del pedido proporcionado por la empresa. Distingue entre mayúsculas y minúsculas, no puede ser una cadena vacía y solo puede contener letras en inglés, números, guiones bajos, guiones o puntos, y no debe superar los 35 caracteres. El `reference_id` debe ser único para cada mensaje de order_details de una empresa determinada. Si es necesario enviar varios mensajes de order_details para el mismo pedido, se recomienda incluir un número de secuencia en el reference_id (por ejemplo, “BM345A-12”) para garantizar la exclusividad del reference_id.
`type`	string	No	Obligatorio para los botones `review_and_pay`. El tipo de bienes que se pagan en este pedido. Las opciones admitidas actualmente son `digital-goods` y `physical-goods`.
`beneficiaries`	object[]	No	Obligatorio para los botones `review_and_pay`. Una matriz de beneficiarios para este pedido. Un beneficiario es un destinatario previsto para el envío de los bienes físicos del pedido. La información del beneficiario no se muestra a los usuarios, pero es necesaria por motivos legales y de cumplimiento normativo.
`currency`	string	No	Obligatorio para los botones `review_and_pay`. La moneda de este pedido. Actualmente, el único valor admitido es `INR`.
`total_amount`	object	No	Obligatorio para los botones `review_and_pay`. El importe total de este pedido.
`order`	object	No	Obligatorio para los botones `review_and_pay` o `review_order`. Para los botones `review_and_pay`, proporciona el pedido `status`, `items`, `subtotal`, `tax`, etc. Para los botones `review_order`, solo proporciona el pedido `status` y `description`.
`payment_settings`	object[]	No	Obligatorio para los botones `review_and_pay`. Ajustes de pago para el pedido.

whatsappMessage.interactive.action.parameters.flow_action_payload

Parámetro	Tipo	Obligatorio	Descripción
`screen`	string	No	El ID de la pantalla que se muestra primero. Debe ser una pantalla de tipo entry .
`data`	object	No	Datos de entrada opcionales para la primera pantalla del Flow. Si se proporciona, debe ser un objeto no vacío.

whatsappMessage.interactive.action.parameters.beneficiaries[]

Parámetro	Tipo	Obligatorio	Descripción
`name`	string	Sí	Nombre de la persona o empresa que recibe los bienes físicos. No puede superar los 200 caracteres. Longitud máxima: `200`.
`address_line1`	string	Sí	Dirección de envío (número de puerta/torre, nombre de calle, etc.). No puede superar los 100 caracteres. Longitud máxima: `100`.
`address_line2`	string	No	Dirección de envío (punto de referencia, zona, etc.). No puede superar los 100 caracteres. Longitud máxima: `100`.
`city`	string	Sí	Nombre de la ciudad.
`state`	string	Sí	Nombre del estado o provincia.
`country`	string	Sí	Nombre del país. Actualmente, el único valor admitido es `India`.
`postal_code`	string	Sí	Código postal de 6 dígitos de la dirección de envío. Longitud mínima: `6`. Longitud máxima: `6`.

whatsappMessage.interactive.action.parameters.total_amount

Parámetro	Tipo	Obligatorio	Descripción
`offset`	integer (int32)	Sí	Debe ser `100` para `INR`.
`value`	integer (int32)	Sí	Entero positivo que representa el valor del importe multiplicado por el desplazamiento (offset). Por ejemplo, ₹12.34 tiene el valor 1234.
`description`	string	No	Usa solo para `tax`, `shipping` o `discount`. Descripción del importe. El límite máximo es de 60 caracteres. Longitud máxima: `60`.
`discount_program_name`	string	No	Úsalo solo para `discount`. Texto utilizado para definir pedidos con incentivos. Si el pedido tiene incentivos, el comerciante debe definir esta información. El límite máximo de caracteres es de 60. Longitud máxima: `60`.

whatsappMessage.interactive.action.parameters.order

Parámetro	Tipo	Obligatorio	Descripción
`status`	string	No	El único valor admitido en el mensaje `order_details` es `pending`. En un mensaje `order_status`, `status` puede ser: `pending`, `processing`, `partially_shipped`, `shipped`, `completed` o `canceled`.
`type`	string	No	El único valor admitido es `quick_pay`. Cuando se pasa este campo, ocultamos el botón “Review and Pay” y solo mostramos el botón “Pay Now” en la burbuja de detalles del pedido.
`catalog_id`	string	No	Identificador único del catálogo de Facebook que utiliza la empresa. Si no proporcionas este campo, debes proporcionar los siguientes campos dentro del objeto items: `country_of_origin`, `importer_name` y `importer_address`.
`items`	object[]	No	Matriz de artículos en el pedido.
`subtotal`	object	No	El valor debe ser igual a la suma de `order.amount.value` * `order.amount.quantity`.
`tax`	object	No	La información de impuestos para este pedido.
`shipping`	object	No	El costo de envío del pedido.
`discount`	object	No	El monto del descuento para este pedido.
`expiration`	object	No	Vencimiento para este pedido.
`description`	string	No	Opcional. Texto para compartir información relacionada con el estado. Puede resultar útil al enviar una cancelación. El límite máximo de caracteres es de 120. Longitud máxima: `120`.

whatsappMessage.interactive.action.parameters.order.items[]

Parámetro	Tipo	Obligatorio	Descripción
`retailer_id`	string	No	ID de contenido de un artículo en el pedido procedente de tu catálogo.
`name`	string	Sí	El nombre del artículo que se mostrará al usuario. No puede exceder los 60 caracteres. Longitud máxima: `60`.
`image`	object	No	Imagen personalizada del artículo que se mostrará al usuario.
`amount`	object	Sí	El precio por artículo.
`sale_amount`	object	No	El precio con descuento por artículo. Debe ser inferior al monto original. Si se incluye, este campo se utiliza para calcular el monto del subtotal.
`quantity`	integer (int32)	Sí	La cantidad de artículos en el pedido.
`country_of_origin`	string	No	Obligatorio si `catalog_id` no está presente. El país de origen del producto.
`importer_name`	string	No	Obligatorio si `catalog_id` no está presente. Nombre de la empresa importadora.
`importer_address`	string	No	Obligatorio si `catalog_id` no está presente. Dirección de la empresa importadora.

whatsappMessage.interactive.action.parameters.order.items[].image

Parámetro	Tipo	Obligatorio	Descripción
`id`	string	No	Usa esto cuando el archivo multimedia se suba a los servidores de WhatsApp. Proporciona el ID del objeto multimedia obtenido de la API de subida de archivos multimedia de WhatsApp (https://docs.ycloud.com/reference/whatsapp_media-upload#/). Nota: Debes proporcionar `id` o `link`. Si proporcionas ambos, `id` tendrá prioridad.
`link`	string	No	Usa esto cuando envíes archivos multimedia directamente desde tu servidor. El protocolo y la URL del archivo multimedia que se enviará. Úsalo solo con URL HTTP/HTTPS. Nota: La API de WhatsApp Cloud almacena en caché los recursos multimedia durante 10 minutos. Para asegurarte de tener el contenido más reciente, añade strings de consulta aleatorios a la URL. Nota: Debes proporcionar `id` o `link`. Si proporcionas ambos, `id` tendrá prioridad y `link` se ignorará.
`caption`	string	No	Describe el archivo multimedia `image`, `gif`, `video` o `document` especificado. No aplica en el `header` de mensajes `template` o `interactive`.
`filename`	string	No	Describe el nombre de archivo para el documento específico. Úsalo solo con archivos multimedia `document`.

whatsappMessage.interactive.action.parameters.order.items[].amount

Parámetro	Tipo	Requerido	Descripción
`offset`	integer (int32)	Sí	Debe ser `100` para `INR`.
`value`	integer (int32)	Sí	Entero positivo que representa el valor del importe multiplicado por el desplazamiento. Por ejemplo, ₹12.34 tiene el valor 1234.
`description`	string	No	Usa solo para `tax`, `shipping` o `discount`. Descripción del importe. El límite máximo de caracteres es de 60 caracteres. Longitud máxima: `60`.
`discount_program_name`	string	No	Usa solo para `discount`. Texto utilizado para definir pedidos con incentivos. Si el pedido tiene incentivos, el comerciante debe definir esta información. El límite máximo de caracteres es de 60 caracteres. Longitud máxima: `60`.

whatsappMessage.interactive.action.parameters.order.items[].sale_amount

Parámetro	Tipo	Requerido	Descripción
`offset`	integer (int32)	Sí	Debe ser `100` para `INR`.
`value`	integer (int32)	Sí	Entero positivo que representa el valor del importe multiplicado por el desplazamiento. Por ejemplo, ₹12.34 tiene el valor 1234.
`description`	string	No	Usa solo para `tax`, `shipping` o `discount`. Descripción del importe. El límite máximo de caracteres es de 60 caracteres. Longitud máxima: `60`.
`discount_program_name`	string	No	Usa solo para `discount`. Texto utilizado para definir pedidos con incentivos. Si el pedido tiene incentivos, el comerciante debe definir esta información. El límite máximo de caracteres es de 60 caracteres. Longitud máxima: `60`.

whatsappMessage.interactive.action.parameters.order.subtotal

Parámetro	Tipo	Requerido	Descripción
`offset`	integer (int32)	Sí	Debe ser `100` para `INR`.
`value`	integer (int32)	Sí	Entero positivo que representa el valor del importe multiplicado por el desplazamiento. Por ejemplo, ₹12.34 tiene el valor 1234.
`description`	string	No	Úsalo solo para `tax`, `shipping` o `discount`. Descripción del importe. El límite máximo de caracteres es de 60. Longitud máxima: `60`.
`discount_program_name`	string	No	Úsalo solo para `discount`. Texto utilizado para definir pedidos con incentivos. Si el pedido tiene incentivos, el comerciante debe definir esta información. El límite máximo de caracteres es de 60. Longitud máxima: `60`.

whatsappMessage.interactive.action.parameters.order.tax

Parámetro	Tipo	Obligatorio	Descripción
`offset`	integer (int32)	Sí	Debe ser `100` para `INR`.
`value`	integer (int32)	Sí	Entero positivo que representa el valor del importe multiplicado por el desplazamiento. Por ejemplo, ₹12.34 tiene el valor 1234.
`description`	string	No	Úsalo solo para `tax`, `shipping` o `discount`. Descripción del importe. El límite máximo de caracteres es de 60. Longitud máxima: `60`.
`discount_program_name`	string	No	Úsalo solo para `discount`. Texto utilizado para definir pedidos con incentivos. Si el pedido tiene incentivos, el comerciante debe definir esta información. El límite máximo de caracteres es de 60. Longitud máxima: `60`.

whatsappMessage.interactive.action.parameters.order.shipping

Parámetro	Tipo	Obligatorio	Descripción
`offset`	integer (int32)	Sí	Debe ser `100` para `INR`.
`value`	integer (int32)	Sí	Entero positivo que representa el valor del importe multiplicado por el desplazamiento. Por ejemplo, ₹12.34 tiene el valor 1234.
`description`	string	No	Úsalo solo para `tax`, `shipping` o `discount`. Descripción del importe. El límite máximo de caracteres es de 60. Longitud máxima: `60`.
`discount_program_name`	string	No	Úsalo solo para `discount`. Texto utilizado para definir pedidos con incentivos. Si el pedido tiene incentivos, el comerciante debe definir esta información. El límite máximo de caracteres es de 60. Longitud máxima: `60`.

whatsappMessage.interactive.action.parameters.order.discount

Parámetro	Tipo	Obligatorio	Descripción
`offset`	integer (int32)	Sí	Debe ser `100` para `INR`.
`value`	integer (int32)	Sí	Entero positivo que representa el valor del importe multiplicado por el desplazamiento. Por ejemplo, ₹12.34 tiene el valor 1234.
`description`	string	No	Úsalo solo para `tax`, `shipping` o `discount`. Descripción del importe. El límite máximo de caracteres es de 60. Longitud máxima: `60`.
`discount_program_name`	string	No	Úsalo solo para `discount`. Texto utilizado para definir pedidos con incentivos. Si el pedido tiene incentivos, el comerciante debe definir esta información. El límite máximo de caracteres es de 60. Longitud máxima: `60`.

whatsappMessage.interactive.action.parameters.order.expiration

Parámetro	Tipo	Obligatorio	Descripción
`timestamp`	string	Sí	Una cadena de marca de tiempo UTC en segundos de la hora en la que debe expirar el pedido. El umbral mínimo es de 300 segundos.
`description`	string	No	Explicación en texto para el vencimiento. Longitud máxima: `120`.

whatsappMessage.interactive.action.parameters.payment_settings[]

Parámetro	Tipo	Obligatorio	Descripción
`type`	string	Sí	Debe establecerse en `payment_gateway`.
`payment_gateway`	object	Sí	Un objeto que describe la información de la cuenta de pago.

whatsappMessage.interactive.action.parameters.payment_settings[].payment_gateway

Parámetro	Tipo	Obligatorio	Descripción
`type`	string	Sí	Tipo de pago. Debes establecer esto en `billdesk`, `razorpay`, `payu` o `zaakpay`, si has vinculado tu pasarela de pago de BillDesk, Razorpay, PayU o Zaakpay para aceptar pagos.
`configuration_name`	string	Sí	El nombre de la configuración de pago preconfigurada que se utilizará para este pedido; no debe superar los 60 caracteres. Este valor debe coincidir con una configuración de pago configurada en el Administrador de WhatsApp Business. Longitud máxima: `60`.
`billdesk`	object	No	Información adicional para BillDesk. Los campos definidos por el usuario (extra) se utilizan para almacenar cualquier información correspondiente a un pedido en particular. Cada campo extra tiene un límite máximo de 120 caracteres.
`payu`	object	No	Información adicional para PayU. Los campos definidos por el usuario (udf) se utilizan para almacenar cualquier información correspondiente a un pedido en particular. Cada campo UDF tiene un límite máximo de 255 caracteres.
`razorpay`	object	No	Información adicional para Razorpay.
`zaakpay`	object	No	Información adicional para Zaakpay. Los campos definidos por el usuario (extra) se utilizan para almacenar cualquier información correspondiente a un pedido en particular. Cada campo extra tiene un límite máximo de 180 caracteres.

whatsappMessage.interactive.action.parameters.payment_settings[].payment_gateway.billdesk

Parámetro	Tipo	Obligatorio	Descripción
`additional_info1`	string	No	Información definida por el usuario sobre este pedido para BillDesk. Longitud máxima: `120` caracteres.
`additional_info2`	string	No	Información definida por el usuario sobre este pedido para BillDesk. Longitud máxima: `120` caracteres.
`additional_info3`	string	No	Información definida por el usuario sobre este pedido para BillDesk. Longitud máxima: `120` caracteres.
`additional_info4`	string	No	Información definida por el usuario sobre este pedido para BillDesk. Longitud máxima: `120` caracteres.
`additional_info5`	string	No	Información definida por el usuario sobre este pedido para BillDesk. Longitud máxima: `120` caracteres.
`additional_info6`	string	No	Información definida por el usuario sobre este pedido para BillDesk. Longitud máxima: `120` caracteres.
`additional_info7`	string	No	Información definida por el usuario sobre este pedido para BillDesk. Longitud máxima: `120` caracteres.

whatsappMessage.interactive.action.parameters.payment_settings[].payment_gateway.payu

Parámetro	Tipo	Obligatorio	Descripción
`udf1`	string	No	Información definida por el usuario sobre este pedido para PayU. Longitud máxima: `255` caracteres.
`udf2`	string	No	Información definida por el usuario sobre este pedido para PayU. Longitud máxima: `255` caracteres.
`udf3`	string	No	Información definida por el usuario sobre este pedido para PayU. Longitud máxima: `255` caracteres.
`udf4`	string	No	Información definida por el usuario sobre este pedido para PayU. Longitud máxima: `255` caracteres.

whatsappMessage.interactive.action.parameters.payment_settings[].payment_gateway.razorpay

Parámetro	Tipo	Obligatorio	Descripción
`receipt`	string	No	Número de recibo que corresponde a este pedido, establecido para tu referencia interna. Se admite una longitud máxima de 40 caracteres con una longitud mínima superior a 0 caracteres.
`notes`	object	No	El objeto puede ser pares clave-valor con un máximo de 15 claves y cada valor está limitado a 256 caracteres.

whatsappMessage.interactive.action.parameters.payment_settings[].payment_gateway.zaakpay

Parámetro	Tipo	Obligatorio	Descripción
`extra1`	string	No	Información definida por el usuario sobre este pedido para Zaakpay. Longitud máxima: `180` caracteres.
`extra2`	string	No	Información definida por el usuario sobre este pedido para Zaakpay. Longitud máxima: `180` caracteres.

whatsappMessage.interactive.body

Parámetro	Tipo	Obligatorio	Descripción
`text`	string	No	El contenido del cuerpo del mensaje. Se admiten emojis y markdown. Longitud máxima: 1024 caracteres. Longitud máxima: `1024`.

whatsappMessage.interactive.header

Parámetro	Tipo	Obligatorio	Descripción
`type`	string	No	Obligatorio. El tipo de encabezado que te gustaría usar. `text`: se usa para mensajes de lista, botones de respuesta y mensajes de varios productos. `video`: se usa para botones de respuesta. `image`: se usa para botones de respuesta. `document`: se usa para botones de respuesta.
`text`	string	No	Texto para el encabezado. El formato admite emojis, pero no markdown. Longitud máxima: `60`.
`image`	object	No	Úsalo para mensajes de tipo `image`, `gif`, `video`, `audio`, `document` o `sticker`. Consulta también Supported Media Types.
`video`	object	No	Úsalo para mensajes `image`, `gif`, `video`, `audio`, `document` o `sticker`. Consulta también los tipos de contenido multimedia admitidos.
`document`	object	No	Úsalo para mensajes de `image`, `gif`, `video`, `audio`, `document` o `sticker`. Consulta también los tipos de medios compatibles.

whatsappMessage.interactive.header.image

Parámetro	Tipo	Obligatorio	Descripción
`id`	string	No	Úsalo cuando el contenido multimedia se haya subido a los servidores de WhatsApp. Proporciona el ID del objeto multimedia obtenido de la API de subida de medios de WhatsApp (https://docs.ycloud.com/reference/whatsapp_media-upload#/). Nota: Debes proporcionar `id` o `link`. Si se proporcionan ambos, `id` tiene prioridad.
`link`	string	No	Úsalo cuando envíes contenido multimedia directamente desde tu servidor. El protocolo y la URL del contenido multimedia que se enviará. Utilízalo solo con URL HTTP/HTTPS. Nota: La API de WhatsApp Cloud almacena en caché los recursos multimedia durante 10 minutos. Para asegurarte de tener el contenido más reciente, añade parámetros de consulta aleatorios a la URL. Nota: Debes proporcionar `id` o `link`. Si se proporcionan ambos, `id` tiene prioridad y `link` se ignorará.
`caption`	string	No	Describe el archivo multimedia especificado (`image`, `gif`, `video` o `document`). No se aplica en el `header` de mensajes de `template` o `interactive`.
`filename`	string	No	Describe el nombre de archivo para el documento específico. Úsalo únicamente con archivos multimedia de tipo `document`.

whatsappMessage.interactive.header.video

Parámetro	Tipo	Obligatorio	Descripción
`id`	string	No	Úsalo cuando el contenido multimedia se haya subido a los servidores de WhatsApp. Proporciona el ID del objeto multimedia obtenido de la API de subida de medios de WhatsApp (https://docs.ycloud.com/reference/whatsapp_media-upload#/). Nota: Debes proporcionar `id` o `link`. Si se proporcionan ambos, `id` tiene prioridad.
`link`	string	No	Úsalo cuando envíes contenido multimedia directamente desde tu servidor. El protocolo y la URL del contenido multimedia que se enviará. Utilízalo solo con URL HTTP/HTTPS. Nota: La API de WhatsApp Cloud almacena en caché los recursos multimedia durante 10 minutos. Para asegurarte de tener el contenido más reciente, añade parámetros de consulta aleatorios a la URL. Nota: Debes proporcionar `id` o `link`. Si se proporcionan ambos, `id` tiene prioridad y `link` se ignorará.
`caption`	string	No	Describe el archivo multimedia especificado (`image`, `gif`, `video` o `document`). No se aplica en el `header` de mensajes de `template` o `interactive`.
`filename`	string	No	Describe el nombre de archivo para el documento específico. Úsalo únicamente con archivos multimedia de tipo `document`.

whatsappMessage.interactive.header.document

Parámetro	Tipo	Obligatorio	Descripción
`id`	string	No	Úsalo cuando el contenido multimedia se haya subido a los servidores de WhatsApp. Proporciona el ID del objeto multimedia obtenido de la API de subida de medios de WhatsApp (https://docs.ycloud.com/reference/whatsapp_media-upload#/). Nota: Debes proporcionar `id` o `link`. Si se proporcionan ambos, `id` tiene prioridad.
`link`	string	No	Úsalo cuando envíes contenido multimedia directamente desde tu servidor. El protocolo y la URL del contenido multimedia que se enviará. Utilízalo solo con URL HTTP/HTTPS. Nota: La API de WhatsApp Cloud almacena en caché los recursos multimedia durante 10 minutos. Para asegurarte de tener el contenido más reciente, añade parámetros de consulta aleatorios a la URL. Nota: Debes proporcionar `id` o `link`. Si se proporcionan ambos, `id` tiene prioridad y `link` se ignorará.
`caption`	string	No	Describe el archivo multimedia `image`, `gif`, `video` o `document` especificado. No aplicable en el `header` de mensajes `template` o `interactive`.
`filename`	string	No	Describe el nombre de archivo para el documento específico. Úsalo solo con contenido multimedia `document`.

whatsappMessage.interactive.footer

Parámetro	Tipo	Requerido	Descripción
`text`	string	No	El contenido del pie de página. Se admiten emojis y markdown. Se admiten enlaces. Longitud máxima: 60 caracteres. Longitud máxima: `60`.

whatsappMessage.contacts[]

Parámetro	Tipo	Requerido	Descripción
`addresses`	object[]	No	Los elementos del array se describen a continuación.
`birthday`	string	No	Cadena con formato `YYYY-MM-DD`.
`emails`	object[]	No	Los elementos del array se describen a continuación.
`name`	object	Sí	Nombre completo del contacto formateado como un objeto name.
`org`	object	No	Información de la organización del contacto formateada como un objeto org.
`phones`	object[]	No	Número(s) de teléfono del contacto formateado(s) como un objeto phone.
`urls`	object[]	No	URL(s) del contacto formateada(s) como un objeto urls.
`vcard`	string	No	vCard opcional proporcionada con la carga útil del contacto compartido.
`origin`	string	No	Establecido en `contact_request` cuando el usuario compartió el contacto en respuesta a un mensaje para solicitar información de contacto.

whatsappMessage.contacts[].addresses[]

Parámetro	Tipo	Requerido	Descripción
`street`	string	No	Número de la calle y nombre de la calle.
`city`	string	No	Nombre de la ciudad.
`state`	string	No	Abreviatura del estado o provincia.
`zip`	string	No	Código postal.
`country`	string	No	Nombre completo del país.
`country_code`	string	No	Abreviatura del país en dos letras.
`type`	string	No	Los valores estándar son `HOME` y `WORK`.

whatsappMessage.contacts[].emails[]

Parámetro	Tipo	Requerido	Descripción
`email`	string	No	Dirección de correo electrónico.
`type`	string	No	Los valores estándar son `HOME` y `WORK`.

whatsappMessage.contacts[].name

Parámetro	Tipo	Requerido	Descripción
`formatted_name`	string	Sí	Nombre completo, tal como aparece habitualmente.
`first_name`	string	No	Nombre.
`last_name`	string	No	Apellido.
`middle_name`	string	No	Segundo nombre.
`suffix`	string	No	Sufijo del nombre.
`prefix`	string	No	Prefijo del nombre.

whatsappMessage.contacts[].org

Parámetro	Tipo	Requerido	Descripción
`company`	string	No	Nombre de la empresa del contacto.
`department`	string	No	Nombre del departamento del contacto.
`title`	string	No	Cargo o título profesional del contacto.

whatsappMessage.contacts[].phones[]

Parámetro	Tipo	Obligatorio	Descripción
`phone`	string	No	Se completa automáticamente con el valor de `wa_id` como un número de teléfono formateado.
`type`	string	No	Los valores estándar son `CELL`, `MAIN`, `IPHONE`, `HOME` y `WORK`.
`wa_id`	string	No	ID de WhatsApp.

whatsappMessage.contacts[].urls[]

Parámetro	Tipo	Obligatorio	Descripción
`url`	string	No	URL.
`type`	string	No	Los valores estándar son `HOME` y `WORK`.

whatsappMessage.reaction

Parámetro	Tipo	Obligatorio	Descripción
`message_id`	string	Sí	Especifica el `wamid` del mensaje recibido que contenía la reacción.
`emoji`	string	No	Obligatorio cuando envías un mensaje `reaction`. Establécelo en `""` si deseas eliminar el emoji. Opcional cuando recibiste un mensaje de un usuario. Este campo se incluye cuando un usuario reacciona a los mensajes con un emoji. De lo contrario, indica que un usuario eliminó el emoji.

whatsappMessage.context

Parámetro	Tipo	Obligatorio	Descripción
`message_id`	string	No	Especifica el `wamid` del mensaje al que estás respondiendo. `wamid` es el ID del mensaje original en la plataforma de WhatsApp.

whatsappMessage.whatsappApiError

Parámetro	Tipo	Obligatorio	Descripción
`message`	string	Sí	Una descripción del error legible por humanos.
`code`	string	Sí	Un código de error.
`type`	string	No	Tipo de error.
`error_subcode`	string	No	Código adicional sobre el error.
`error_user_msg`	string	No	El mensaje que se mostrará al usuario. El idioma del mensaje se basa en la configuración regional (locale) de la solicitud a la API.
`error_user_title`	string	No	El título del cuadro de diálogo, si se muestra. El idioma del mensaje se basa en la configuración regional (locale) de la solicitud a la API.
`fbtrace_id`	string	No	Identificador de soporte interno. Al informar de un error relacionado con una llamada a la Graph API, incluye el fbtrace_id para ayudarnos a encontrar datos de registro para la depuración.
`error_data`	string u object	No	Datos adicionales sobre el error. Una cadena o mapa. Para las API de plantillas, este campo es una cadena que describe el motivo del error. Para las API de mensajes, este campo es un mapa con la propiedad `details` que describe el motivo del error.

Ejemplo

El siguiente JSON es el cuerpo entregado a tu receptor. Los ID, números de teléfono y otros valores de cuenta son ilustrativos.

Mensaje de texto de WhatsApp Business App

Este evento sincroniza un mensaje enviado desde la aplicación WhatsApp Business o un dispositivo complementario compatible. Lee su contenido en whatsappMessage.

{
  "id": "evt_example_smb_echoes",
  "type": "whatsapp.smb.message.echoes",
  "apiVersion": "v2",
  "createTime": "2026-10-09T08:00:00.000Z",
  "whatsappMessage": {
    "id": "MESSAGE_ID",
    "wamid": "wamid.EXAMPLE",
    "wabaId": "WABA_ID",
    "from": "+12025550124",
    "to": "+12025550123",
    "type": "text",
    "text": {
      "body": "Your order is ready for pickup."
    },
    "status": "sent",
    "createTime": "2026-10-08T12:00:00.000Z",
    "sendTime": "2026-10-08T12:00:00.000Z",
    "toUserId": "US.13491208655302741918",
    "toParentUserId": "US.ENT.11815799212886844830",
    "customerProfile": {
      "username": "example_customer"
    }
  }
}

Mensaje de imagen saliente

{
  "id": "evt_eEVCy8eNqD9EvcFI",
  "type": "whatsapp.smb.message.echoes",
  "apiVersion": "v2",
  "createTime": "2023-02-22T12:00:00.000Z",
  "whatsappMessage": {
    "id": "63f5d602367ea403f8175a6c",
    "wamid": "wamid.BgNODYxN...",
    "status": "sent",
    "from": "BUSINESS-PHONE-NUMBER",
    "to": "CUSTOMER-PHONE-NUMBER",
    "toUserId": "US.13491208655302741918",
    "toParentUserId": "US.1181579921288684483",
    "customerProfile": {
      "username": "@joee"
    },
    "wabaId": "WABA-ID",
    "createTime": "2022-03-01T12:00:00.000Z",
    "sendTime": "2022-03-01T12:00:01.000Z",
    "bizType": "whatsapp",
    "type": "image",
    "image": {
      "link": "https://example.com/sample",
      "id": "592623615738103"
    }
  }
}

Mensaje de video saliente

{
  "id": "evt_eEVCy8eNqD9EvcFI",
  "type": "whatsapp.smb.message.echoes",
  "apiVersion": "v2",
  "createTime": "2023-02-22T12:00:00.000Z",
  "whatsappMessage": {
    "id": "63f5d602367ea403f8175a6c",
    "wamid": "wamid.BgNODYxN...",
    "status": "sent",
    "from": "BUSINESS-PHONE-NUMBER",
    "to": "CUSTOMER-PHONE-NUMBER",
    "toUserId": "US.13491208655302741918",
    "toParentUserId": "US.1181579921288684483",
    "customerProfile": {
      "username": "@joee"
    },
    "wabaId": "WABA-ID",
    "createTime": "2022-03-01T12:00:00.000Z",
    "sendTime": "2022-03-01T12:00:01.000Z",
    "bizType": "whatsapp",
    "type": "video",
    "video": {
      "link": "https://example.com/sample",
      "id": "592623615738103"
    }
  }
}

Mensaje de audio saliente

{
  "id": "evt_eEVCy8eNqD9EvcFI",
  "type": "whatsapp.smb.message.echoes",
  "apiVersion": "v2",
  "createTime": "2023-02-22T12:00:00.000Z",
  "whatsappMessage": {
    "id": "63f5d602367ea403f8175a6c",
    "wamid": "wamid.BgNODYxN...",
    "status": "sent",
    "from": "BUSINESS-PHONE-NUMBER",
    "to": "CUSTOMER-PHONE-NUMBER",
    "toUserId": "US.13491208655302741918",
    "toParentUserId": "US.1181579921288684483",
    "customerProfile": {
      "username": "@joee"
    },
    "wabaId": "WABA-ID",
    "createTime": "2022-03-01T12:00:00.000Z",
    "sendTime": "2022-03-01T12:00:01.000Z",
    "bizType": "whatsapp",
    "type": "audio",
    "audio": {
      "link": "https://example.com/sample",
      "id": "592623615738103"
    }
  }
}

Mensaje de documento saliente

{
  "id": "evt_eEVCy8eNqD9EvcFI",
  "type": "whatsapp.smb.message.echoes",
  "apiVersion": "v2",
  "createTime": "2023-02-22T12:00:00.000Z",
  "whatsappMessage": {
    "id": "63f5d602367ea403f8175a6c",
    "wamid": "wamid.BgNODYxN...",
    "status": "sent",
    "from": "BUSINESS-PHONE-NUMBER",
    "to": "CUSTOMER-PHONE-NUMBER",
    "toUserId": "US.13491208655302741918",
    "toParentUserId": "US.1181579921288684483",
    "customerProfile": {
      "username": "@joee"
    },
    "wabaId": "WABA-ID",
    "createTime": "2022-03-01T12:00:00.000Z",
    "sendTime": "2022-03-01T12:00:01.000Z",
    "bizType": "whatsapp",
    "type": "document",
    "document": {
      "link": "https://example.com/sample",
      "id": "592623615738103",
      "caption": "图片"
    }
  }
}

Tras verificar la firma y aceptar el evento de forma duradera, devuelve una respuesta 2xx. Procesa las tareas lentas de forma asíncrona.

HTTP/1.1 200 OK

Para ver tutoriales paso a paso de situaciones prácticas, consulta los ejemplos comentados.

Primeros pasos

Guías

Endpoints

Webhook reference

whatsapp.smb.message.echoes

Desencadenadores

Sintaxis

Parámetros

Envoltorio del evento

Payload del evento

whatsappMessage

Ejemplo

​Desencadenadores

​Sintaxis

​Parámetros

​Envoltorio del evento

​Payload del evento

​whatsappMessage

​Ejemplo

Desencadenadores

Sintaxis

Parámetros

Envoltorio del evento

Payload del evento

whatsappMessage

Ejemplo