--- title: "Variables de plantilla de WhatsApp: {{1}} o parámetros con nombre" description: "Cómo funcionan las variables de plantilla de WhatsApp: {{1}} posicional o parámetros con nombre, dónde se permiten, ejemplos, rechazos de Meta y envío." canonical: "https://omnichannels.ai/es/blog/whatsapp-template-variables-parameters/" language: "es" updated: "2026-11-08" publisher: "BroadNet Technologies" brand: "OmniChannels.ai" category: "whatsapp" primaryQuery: "whatsapp template variables" keywords: ["variables plantilla whatsapp", "parámetros plantilla whatsapp", "plantilla whatsapp {{1}}", "parámetros con nombre whatsapp", "parameter_format whatsapp", "valores de ejemplo plantilla whatsapp", "plantilla whatsapp rechazada variables", "plantilla whatsapp personalizada csv"] published: "2026-11-08" author: "OmniChannels.ai Editorial Team" reviewer: "BroadNet Messaging Solutions Team" readingMinutes: 9 answer: "Una variable de plantilla de WhatsApp es un marcador, {{1}} en las plantillas posicionales o {{first_name}} en las de nombre, que se rellena en cada envío. Elija el formato con parameter_format al crearla; el posicional es el predeterminado. Cada variable necesita un valor de ejemplo. Se permiten en el cuerpo, en un encabezado de texto (una) y en un botón de URL (una); Meta rechaza las plantillas que empiezan o terminan con una variable." takeaways: ["Las variables posicionales se numeran {{1}}, {{2}} y deben rellenarse en orden; las variables con nombre usan nombres en minúsculas con guiones bajos y pueden rellenarse en cualquier orden.", "Una plantilla debe incluir un valor de ejemplo para cada variable al crearla; Meta usa los ejemplos durante la revisión.", "Un encabezado de texto admite una variable, el cuerpo admite varias y un botón de URL admite una variable que se añade al final de la URL.", "Entre los motivos de rechazo documentados por Meta están las variables mal formadas o no secuenciales, una plantilla que empieza o termina con una variable, demasiadas variables para la longitud del texto y caracteres especiales como #, $ o %.", "Personalizar desde un CSV significa una fila por destinatario con un valor limpio para cada variable."] faq: - q: "¿Cuál es la diferencia entre parámetros posicionales y con nombre?" a: "Las plantillas posicionales usan marcadores numerados como {{1}} y exigen que los valores de envío sigan el mismo orden. Las plantillas con nombre usan nombres en minúsculas con guiones bajos, como {{order_number}}, y los valores pueden ir en cualquier orden en el envío. Si no define parameter_format al crear la plantilla, Meta usa el formato posicional." - q: "¿Dónde puedo usar variables en una plantilla de WhatsApp?" a: "La documentación de Meta menciona el cuerpo, que admite varios parámetros, un encabezado de texto, que admite uno, y un botón de URL, que admite una variable añadida al final de la URL. Los encabezados multimedia llevan un archivo en lugar de una variable. El pie de página y los botones de respuesta rápida y de número de teléfono no figuran como compatibles con variables." - q: "¿Por qué se rechazó mi plantilla por las variables?" a: "La guía de revisión de Meta enumera varias causas relacionadas con variables: llaves ausentes o desparejadas, variables no secuenciales, un mensaje que empieza o termina con una variable, demasiadas variables respecto a la longitud del mensaje y caracteres especiales como #, $ o %. Corrija el texto, añada ejemplos realistas y vuelva a enviarla." - q: "¿Necesito valores de ejemplo?" a: "Sí. Meta indica que, si una plantilla usa variables, debe incluir valores de ejemplo al crearla, uno por parámetro. Use valores realistas, no marcadores como test, para que los revisores vean cómo quedará el mensaje final. Los ejemplos solo se usan en la revisión; los valores reales se aportan al enviar." - q: "¿Puede una variable contener un salto de línea o un enlace?" a: "Esta guía solo recoge lo que verificamos en la documentación de Meta, y las páginas que consultamos no establecen ninguna regla sobre saltos de línea dentro de los valores de las variables. Pruebe con un envío real a su propio número y consulte a nuestro equipo si piensa pasar valores largos o con formato. El valor de un botón de URL se añade al final de la URL del botón." - q: "¿Cómo personalizo una plantilla desde una hoja de cálculo?" a: "Mantenga una fila por destinatario y una columna por variable, con valores limpios: nombres sin espacios sobrantes, fechas en un solo formato y números en formato internacional. Suba el archivo al enviar una campaña personalizada y revise la vista previa. Confirme con nuestro equipo la disposición exacta de las columnas antes de su primera campaña." sources: - title: "Template fundamentals — WhatsApp Business Platform, Meta for Developers" url: "https://developers.facebook.com/documentation/business-messaging/whatsapp/templates/overview" - title: "Template components — WhatsApp Business Platform, Meta for Developers" url: "https://developers.facebook.com/documentation/business-messaging/whatsapp/templates/components" - title: "Template review — WhatsApp Business Platform, Meta for Developers" url: "https://developers.facebook.com/documentation/business-messaging/whatsapp/templates/template-review" --- # Variables de plantilla de WhatsApp: {{1}} o parámetros con nombre Canonical: https://omnichannels.ai/es/blog/whatsapp-template-variables-parameters/ Language: es Publisher: OmniChannels.ai by BroadNet Technologies Esta guía es para desarrolladores y profesionales del marketing que crean plantillas de WhatsApp con contenido personalizado. Explica los dos formatos de variables, dónde pueden ir, qué dice Meta sobre la revisión y cómo enviar los valores desde la API o desde una hoja de cálculo. ## ¿Qué son las variables de plantilla de WhatsApp? Una variable es un marcador en el texto de la plantilla que se sustituye por un valor real al enviar. Meta las llama parámetros. WhatsApp Manager las llama variables. El texto de la plantilla y los valores de ejemplo se revisan una vez; los valores reales se aportan en cada mensaje. Por ejemplo, el cuerpo de una plantilla dice `Hi {{1}}! Your order number is {{2}}. Thank you.` y usted envía `Hi Layla! Your order number is OM-4821. Thank you.` a un cliente y otro par de valores al siguiente. Meta no traduce el texto de la plantilla ni los valores de las variables. Usted los aporta en el idioma correcto para cada versión lingüística de la plantilla. ## ¿Cuál es la diferencia entre parámetros posicionales y con nombre? Elige el formato al crear la plantilla con el campo `parameter_format`. Si lo omite, Meta usa `positional`. | | Posicional | Con nombre | |---|---|---| | Marcador | `{{1}}`, `{{2}}` | `{{first_name}}`, `{{order_number}}` | | Regla de nombres | Numerado desde 1, en orden | Únicos, letras minúsculas y guiones bajos | | Valores de envío | Deben seguir el orden de los marcadores | Pueden ir en cualquier orden | | Valores de ejemplo | Matriz `body_text` | `body_text_named_params` con `param_name` | | Ideal para | Plantillas cortas con una o dos variables | Plantillas con varias variables que otras personas deben mantener | Los parámetros con nombre se leen mejor en una biblioteca de plantillas, y un orden cambiado no puede colocar en silencio un número de pedido donde va un nombre. Las plantillas posicionales son más cortas de escribir y siguen siendo la opción predeterminada. ## ¿Dónde se permiten las variables? La documentación de componentes de Meta indica estos lugares: | Componente | Variables | |---|---| | Encabezado de texto | Un parámetro | | Cuerpo | Varios parámetros | | Botón de URL | Una variable, añadida al final de la URL | | Encabezado multimedia (imagen, vídeo, documento) | Ninguna; el archivo de ejemplo se aporta al crear y el archivo real al enviar | | Pie de página, botones de respuesta rápida y de número de teléfono | No figuran como compatibles con variables | Límites de longitud documentados: un encabezado de texto de hasta 60 caracteres, un cuerpo de hasta 1.024, un pie de página de hasta 60, una etiqueta de botón de hasta 25 y una URL de botón de hasta 2.000 caracteres. Si el valor de un botón de URL contiene caracteres especiales, Meta indica codificarlos con porcentaje. ## ¿Cómo aporto los valores de ejemplo? La regla de Meta es que, si su plantilla usa variables, debe incluir valores de ejemplo al crearla, uno por parámetro. Un encabezado con variable necesita también un `example`. Cuerpo posicional con ejemplos: ```json { "type": "BODY", "text": "Hi {{1}}! Your order {{2}} ships on {{3}}.", "example": { "body_text": [["Layla", "OM-4821", "12 November"]] } } ``` Cuerpo con nombre y ejemplos: ```json { "type": "BODY", "text": "Hi {{first_name}}! Your order {{order_number}} ships on {{ship_date}}.", "example": { "body_text_named_params": [ { "param_name": "first_name", "example": "Layla" }, { "param_name": "order_number", "example": "OM-4821" }, { "param_name": "ship_date", "example": "12 November" } ] } } ``` La propia plantilla define `"parameter_format": "named"` para la segunda forma. Use ejemplos realistas para que los revisores vean lo que dirá el mensaje real. ## ¿Qué dice Meta sobre las reglas de variables y los rechazos? La guía de revisión de plantillas de Meta enumera estos motivos de rechazo relacionados con variables: - Faltan variables o sus llaves están desparejadas. La forma posicional correcta es `{{1}}`. - Las variables no son secuenciales, por ejemplo `{{1}}`, `{{2}}`, `{{5}}`, `{{4}}`. - La plantilla empieza o termina con una variable. Meta las llama parámetros «dangling» (colgantes). - La plantilla tiene demasiadas variables respecto a la longitud del mensaje. Meta no da ninguna proporción, así que añada texto fijo alrededor de cada variable. - Las variables contienen caracteres especiales como `#`, `$` o `%`. No hemos encontrado ninguna declaración oficial sobre dos variables colocadas una junto a otra, así que no damos ninguna regla al respecto. Sepárelas con palabras, lo que además se lee mejor. Para las reglas de categorías y otras causas de rechazo, consulte [categorías de plantillas de WhatsApp y aprobación](/es/blog/whatsapp-template-categories-approval/). Para textos ya preparados, consulte [ejemplos de plantillas de mensajes de WhatsApp](/es/blog/whatsapp-message-template-examples/). ## ¿Cómo envío los parámetros en la llamada a la API? Envía el nombre de la plantilla, el idioma y una matriz `components` con los valores. Esta es la estructura para una plantilla posicional: ```json { "messaging_product": "whatsapp", "to": "971500000000", "type": "template", "template": { "name": "order_shipped", "language": { "code": "en" }, "components": [ { "type": "body", "parameters": [ { "type": "text", "text": "Layla" }, { "type": "text", "text": "OM-4821" }, { "type": "text", "text": "12 November" } ] } ] } } ``` En una plantilla con nombre, cada entrada lleva además `parameter_name`, que debe coincidir con el marcador: ```json { "type": "text", "parameter_name": "order_number", "text": "OM-4821" } ``` ### ¿Cómo funcionan los parámetros de un encabezado multimedia? Un encabezado multimedia no tiene variable de texto. Al crear la plantilla, el encabezado contiene el identificador de un archivo de ejemplo obtenido del flujo de carga de Meta, y el ejemplo se revisa junto con la plantilla. Al enviar, pasa el archivo, por ejemplo una imagen por ID de medio: ```json { "type": "header", "parameters": [ { "type": "image", "image": { "id": "1558081531584829" } } ] } ``` El ID anterior es el ejemplo de la documentación de Meta, no un archivo real. ### ¿Cómo se ve esto con la API de OmniChannels.ai? Nuestro endpoint `sendbulk` recibe la plantilla como campos de formulario, según la [documentación de la API de WhatsApp](/developers/whatsapp/): | Elemento de la plantilla | Campos | |---|---| | Variable del cuerpo | `bodyTemplateVariables` | | Parámetro con nombre | `bodyTemplateVariables={"parameter_name":"order_id","text":"ORD-12345"}` | | Variable de texto del encabezado | `headerTemplateVariables` | | Imagen, vídeo o documento del encabezado | `mediaUrl` (sustituye el contenido multimedia del encabezado) | | Botón de URL dinámico | `buttonsTemplateVariable` | ## Ejemplo práctico: una plantilla de pedido enviado «Souq Rafiq» (ficticia), un minorista de los Emiratos Árabes Unidos, quiere una notificación de envío con la imagen del producto y un botón de seguimiento. 1. **Redactar la plantilla** para que no empiece ni termine con una variable: «Hi {{1}}, your order {{2}} has shipped and should arrive on {{3}}. Tap the button to follow it.» 2. **Añadir el encabezado** como imagen, el pie de página como texto simple y un botón de URL `https://shop.example/track/{{1}}` con un ejemplo como `OM-4821`. 3. **Enviar a revisión** con ejemplos realistas para cada variable y esperar el estado de aprobación. 4. **Enviar** con los tres valores del cuerpo, el sufijo de seguimiento y, si lo sustituye, la imagen del encabezado. ```bash curl -X POST https://api.broadnet.me/whatsapp/message/sendbulk \ -H "Authorization: Bearer $BROADNET_TOKEN" \ -F batchId=0 \ -F campaignName=order-shipped \ -F destinationNo=971500000000 \ -F messageType=TEMPLATE \ -F templateName=order_shipped \ -F templateLanguage=en \ -F bodyTemplateVariables=Layla \ -F buttonsTemplateVariable=OM-4821 ``` Este fragmento muestra los nombres de los campos para un solo valor. Si hay varias variables de cuerpo por destinatario, use una carga personalizada en lugar de repetir el comando. Confirme la codificación con nuestro equipo para su primera campaña. ## ¿Cómo personalizo una plantilla desde un CSV? Use una fila por destinatario y una columna por variable, y súbalo en un envío personalizado. 1. Ponga el número del destinatario en formato internacional en la primera columna. Consulte [formato de número de teléfono E.164](/es/blog/e164-phone-number-format/). 2. Añada una columna por variable y confirme la disposición de las columnas con nuestro equipo antes de su primera campaña. 3. Limpie primero los datos: quite espacios, corrija las mayúsculas, use un solo formato de fecha y elimine valores vacíos, porque una variable vacía produce un mensaje roto o un envío fallido. 4. Previsualice varias filas y envíe primero a su propio número. La limpieza de datos se explica en [enviar SMS masivos desde Excel o CSV](/es/blog/send-bulk-sms-from-excel-csv/); se aplica igual a WhatsApp. ## ¿Cómo elijo entre posicional y con nombre? Elija según cuántas personas tocarán la plantilla y cuántas variables tiene. 1. Una o dos variables y un solo responsable: el posicional basta y es el predeterminado. 2. Tres o más variables, o varios equipos que editan plantillas: use el formato con nombre, para que cada marcador se explique por sí mismo. 3. Mismo texto en varios idiomas: mantenga los mismos nombres o números en todas las versiones, para que una sola rutina de envío rellene todos los idiomas. 4. Conserve siempre un registro de qué columna de origen alimenta cada variable, para que una edición posterior de la plantilla no desplace los datos. Antes de enviar a revisión, lea en voz alta el mensaje terminado con los valores de ejemplo. Si suena poco natural, los revisores y los clientes pensarán lo mismo. ## ¿Cuáles son los errores habituales? - **Empezar o terminar con una variable,** que Meta señala como motivo de rechazo. - **Saltarse números** o reutilizar el mismo número fuera de orden en una plantilla posicional. - **Ejemplos de relleno** como «test», que no dicen nada a los revisores. - **Caracteres especiales** como `#`, `$` o `%` dentro de las variables. - **Orden incorrecto al enviar** en una plantilla posicional, que coloca los datos correctos en el sitio equivocado. - **`parameter_name` que no coincide** en una plantilla con nombre. - **Usar una variable para ocultar la finalidad real** del mensaje. Una plantilla cuya categoría no coincide con su contenido puede ser rechazada o recategorizada; consulte la [guía de categorías](/es/blog/whatsapp-template-categories-approval/). - **Límites:** esta guía recoge lo que indica la documentación de Meta en el momento de redactarla. Las decisiones de revisión corresponden a Meta y las reglas cambian, así que consulte las páginas enlazadas. ## Cómo ayuda OmniChannels.ai BroadNet es un Business Solution Provider oficial de Meta. En OmniChannels.ai puede crear plantillas de WhatsApp con variables, contenido multimedia y botones, previsualizarlas y seguir su estado de aprobación, y luego enviarlas con valores personalizados desde la API o desde una carga de Excel o CSV en una campaña. Se incluyen el filtrado de duplicados y los informes de entrega. Consulte la [página de la API de WhatsApp Business](/es/channels/whatsapp-business-api/) y la [plataforma de campañas](/es/platform/campaigns/).