Variables de texto
Las variables de texto son fragmentos con el formato {{ nombre }} que el plugin sustituye por
el valor real en el momento del envío.
Si escribes:
Hola
{{ first_name }}, ¡recibimos tus datos! En breve un agente se pondrá en contacto.
El cliente recibe:
Hola Juan, ¡recibimos tus datos! En breve un agente se pondrá en contacto.
Dentro del constructor, las variables aparecen resaltadas y se pueden pulsar en el campo de mensaje, con un aviso cuando la variable elegida no existe en el disparador del flujo.
Cada variable declara en qué disparadores funciona. Desde la versión 2.1.0 eso vale también en el envío, no solo en la vista previa: una variable fuera del contexto del disparador se deja tal cual, en lugar de resolverse a un valor equivocado. Las variables marcadas como globales funcionan en cualquier disparador.
WordPress
| Variable | Disparadores | Descripción |
|---|---|---|
{{ first_name }} | todos | Nombre del usuario |
{{ last_name }} | todos | Apellido del usuario |
{{ email }} | todos | Correo del usuario |
{{ site_url }} | todos | URL del sitio |
{{ site_name }} | todos | Nombre del sitio |
{{ current_date }} | todos | Fecha actual |
{{ user_meta[META_KEY] }} | todos | Un metadato del usuario. Sustituye META_KEY por la clave deseada, por ejemplo billing_phone |
{{ post_title }} | estado de la entrada cambiado | Título de la entrada |
{{ post_date }} | estado de la entrada cambiado | Fecha de publicación |
{{ post_content }} | estado de la entrada cambiado | Contenido de la entrada, solo texto |
{{ post_link }} | estado de la entrada cambiado | Enlace de la entrada |
{{ post_tags }} | estado de la entrada cambiado | Etiquetas, separadas por comas |
{{ post_categories }} | estado de la entrada cambiado | Categorías, separadas por comas |
{{ post_featured_image }} | estado de la entrada cambiado | URL de la imagen destacada |
{{ reset_password_link }} | solicitud de restablecimiento | Enlace para restablecer la contraseña |
WooCommerce
En la mayoría de los casos el objeto procesado es el pedido.
| Variable | Descripción |
|---|---|
{{ wc_billing_first_name }} | Nombre de facturación del cliente |
{{ wc_billing_last_name }} | Apellido de facturación del cliente |
{{ wc_billing_email }} | Correo de facturación |
{{ wc_billing_phone }} | Teléfono de facturación |
{{ wc_shipping_phone }} | Teléfono de envío |
{{ wc_order_number }} | Número del pedido |
{{ wc_order_status }} | Estado actual del pedido |
{{ wc_order_date }} | Fecha del pedido |
{{ wc_order_total }} | Total del pedido |
{{ wc_currency_symbol }} | Símbolo de moneda del pedido |
{{ wc_total_discount }} | Total de descuento aplicado |
{{ wc_total_tax }} | Total de impuestos |
{{ wc_total_refunded }} | Total reembolsado |
{{ wc_coupon_codes }} | Códigos de cupón usados en el pedido |
{{ wc_payment_method_title }} | Título del método de pago |
{{ wc_payment_url }} | URL de pago del pedido |
{{ wc_billing_full_address }} | Dirección completa de facturación (formato configurable en las opciones) |
{{ wc_shipping_full_address }} | Dirección completa de envío (formato configurable en las opciones) |
{{ wc_shipping_address }} | Dirección de envío en formato legible |
{{ wc_purchased_items }} | Productos comprados, con nombre y cantidad, uno por línea |
{{ wc_review_links }} | Enlace de valoración de cada producto comprado, uno por línea |
{{ wc_checkout_field=[FIELD_ID] }} | Valor de un campo del checkout. Sustituye FIELD_ID por el ID del campo, por ejemplo billing_email |
Productos digitales
Disponibles a partir de la versión 2.1.0, y resueltas solo después de conceder el acceso a la descarga.
| Variable | Descripción |
|---|---|
{{ wc_downloadable_items }} | Nombre de cada producto digital del pedido, uno por línea |
{{ wc_download_links }} | Nombre y enlace de cada archivo digital, uno por línea |
{{ wc_download_urls }} | Solo los enlaces de descarga, sin el nombre, uno por línea |
{{ wc_downloads_expiry }} | Fecha de caducidad del acceso. Devuelve la más próxima cuando los archivos caducan en fechas distintas |
{{ wc_downloads_remaining }} | Cuántas descargas le quedan al cliente. Devuelve la menor cuando los archivos tienen límites distintos |
{{ wc_account_downloads_url }} | Enlace al área de descargas en la cuenta del cliente |
{{ wc_download_link=[PRODUCT_ID] }} | Enlaces de descarga de un producto concreto. Sustituye PRODUCT_ID por el ID del producto, por ejemplo 128 |
Cupones creados por el flujo
Disponibles después de la acción Crear cupón en el mismo flujo.
| Variable | Descripción |
|---|---|
{{ joinotify_coupon_code }} | Código del cupón |
{{ joinotify_coupon_description }} | Descripción del cupón |
{{ joinotify_coupon_discount_type }} | Tipo de descuento — porcentual o importe fijo |
{{ joinotify_coupon_discount_value }} | Importe del descuento |
{{ joinotify_coupon_discount_formatted }} | Importe con símbolo o porcentaje, por ejemplo 10% |
{{ joinotify_coupon_expires }} | Caducidad del cupón, por ejemplo "Caduca en 1 hora" |
Bucles (loop)
Disponibles dentro del cuerpo de la acción Loop, a partir de la versión 2.2.0. Valen en cualquier campo de la acción — leyenda, URL multimedia, URL de adjunto y destinatario.
| Variable | Descripción |
|---|---|
{{ loop_value }} | Valor del elemento de la iteración actual |
{{ loop_index }} | Índice del elemento, empezando en cero |
{{ loop_number }} | Número del elemento, empezando en uno |
{{ loop_count }} | Total de elementos de la colección |
{{ loop_file_name }} | Nombre del archivo del elemento |
{{ loop_download_url }} | Enlace de descarga del elemento |
{{ loop_product_name }} | Nombre del producto del elemento |
{{ loop_product_id }} | ID del producto del elemento |
{{ loop_item_name }} | Nombre del elemento |
{{ loop_item_quantity }} | Cantidad del elemento |
Formularios
Elementor y WPForms exponen la misma variable, que recupera el valor de cualquier campo del formulario enviado.
| Variable | Descripción |
|---|---|
{{ field_id=[FIELD_ID] }} | Valor de un campo del formulario |
Sustituye FIELD_ID por el ID del campo. En el ejemplo de Elementor de abajo quedaría
{{ field_id=[field_3cf5068] }}; en el de WPForms, {{ field_id=[1] }}.
Variables personalizadas
A partir de la versión 2.0.0 puedes crear variables propias directamente en el constructor, a partir de tipos de contenido y campos del sitio — pedidos de WooCommerce incluidos — sin escribir código. Aparecen en la misma lista que las nativas.
Para variables que requieren lógica, el camino es el filtro
Joinotify/Builder/Placeholders_List o el helper joinotify_register_placeholders(); consulta
Recursos para desarrolladores.
Formato de WhatsApp
El editor de mensajes ya convierte el formato visual (negrita, cursiva, emoji) al estándar de WhatsApp. Si prefieres escribirlo directamente, la sintaxis es la del propio WhatsApp — se procesa en los servidores de Meta y no se puede desactivar.
| Efecto | Sintaxis |
|---|---|
| Cursiva | _texto_ |
| Negrita | *texto* |
~texto~ | |
Monoespaciado | tres comillas invertidas antes y después |
| Lista con viñetas | * texto o - texto por línea |
| Lista numerada | 1. texto por línea |