Puedes usar la sintaxis de variables de plantilla de Wassenger para mostrar información dinámica en tus mensajes basada en un conjunto de variables predefinidas vinculadas al usuario actual que envía el mensaje, o al chat de destino, contacto, metadatos y fecha.
Las variables de plantilla se pueden usar en respuestas rápidas, respuestas automáticas y mensajes enviados a través de la API o chat web.
🤩 🤖 Wassenger es una plataforma de comunicación completa y una solución de API para WhatsApp. Explora más de 100 casos de uso de API y automatiza cualquier cosa en WhatsApp al registrarte para una prueba gratuita y empezar en minutos!
Puedes mostrar información dinámica en los mensajes basada en las siguientes entidades:
whatsapp: número de WhatsApp conectado que envía el mensajeuser: usuario actual que envía el mensajechat: chat de destino que recibirá el mensajecontact: contacto de destino que recibirá el mensajedate: la fecha actual cuando se entrega el mensaje
➡️ Aquí tienes más información sobre las variables aceptadas específicas.
➡️ Encuentra un ejemplo real enviando variables de plantilla usando la API
Cómo funciona
La sintaxis de variables de plantilla se puede usar en cualquier mensaje de texto con llaves dobles {{ para abrir y }} para cerrar la expresión:
Dear {{ contact.name }},
We will be in touch shortly with more information.
Your query has been registered on {{ date.humanize.full }}.
Your support agent is {{ chat.agent.name }}.
Thank you!
El mensaje anterior con variables de plantilla se enviará al usuario así:
Dear Michael,
We will be in touch shortly with more information.
Your query has been registered on Monday, August 26, 2024 11:01 AM.
Your support agent is Noah.
Thank you!
Uso de un valor por defecto
Dear {{ contact.name | customer }},
How can I help you today?
En caso de que la variable contact.name esté vacía para el contacto de destino, se usará customer como valor por defecto. Por lo tanto, el mensaje enviado al usuario se verá así:
Dear customer,
How can I help you today?
También puedes encadenar múltiples valores por defecto así:
Dear {{ contact.name | contact.surname | customer }}
En este caso, si contact.name está vacío, tomará por defecto contact.surname. Luego, si contact.surnname está vacío, tomará por defecto customer.
🤩 🤖 Wassenger es una plataforma de comunicación completa y una solución de API para WhatsApp. Explora más de 100 casos de uso de API y automatiza cualquier cosa en WhatsApp al registrarte para una prueba gratuita y empezar en minutos!
Variables soportadas
Aquí está la lista de variables soportadas en la sintaxis de plantilla:
Variables de campaña
Al enviar mensajes desde una Campaña, puedes usar las siguientes variables de plantilla basadas en los datos de contactos importados mediante la subida de un archivo CSV / Excel. Cada variable de plantilla apuntará a la columna importada preseleccionada en el documento CSV / Excel.
Variables de plantilla de campaña aceptadas
🤩 🤖 Wassenger es una plataforma de comunicación completa y una solución de API para WhatsApp. Explora más de 100 casos de uso de API y automatiza cualquier cosa en WhatsApp al registrarte para una prueba gratuita y empezar en minutos!
Ejemplos
Variable de plantilla simple
Dear {{ contact.name }},
How can I help you today?
Múltiples variables de plantilla
Dear {{ contact.name }},
We will send you more information to your email: {{ contact.email }}
If you need further information, you can call us: {{ whatsapp.number }}
Thank you!
Usar los metadatos del contacto en las variables de plantilla
Hello {{ metadata.crm_name }}
We will send you an email to: {{ metadata.crm_email }}
Variable de plantilla con valor por defecto
Dear {{ contact.name | customer }},
Thank you!
Variable de plantilla con múltiples valores por defecto
Dear {{ contact.name | contact.surname | customer }},
Thanks for contacting us, we will answer your query shortly.
Thank you!
Ejemplo de API en vivo
Ahora puedes jugar, depurar y probar la API en vivo directamente desde tu navegador, explorar y probar más ejemplos de API y obtener con un clic fragmentos de código listos para usar disponibles en más de 15 lenguajes de programación 😎
Prueba nuestro probador API en vivo ahora
🤩 🤖 Wassenger es una plataforma de comunicación completa y una solución de API para WhatsApp. Explora más de 100 casos de uso de API y automatiza cualquier cosa en WhatsApp al registrarte para una prueba gratuita y empezar en minutos!
Preguntas (FAQ)
¿Dónde puedo usar variables de plantilla?
Puedes usar variables de plantilla en respuestas rápidas, respuestas automáticas y mensajes enviados vía API.
¿Puedo enviar los metadatos del contacto en las variables de plantilla?
¡Sí, puedes! Simplemente usa la siguiente sintaxis:
Hello {{ metadata.crm_name }}
Donde crm_name representa la clave de metadatos crm_name en los metadatos del contacto.
Puedes crear o actualizar los metadatos del contacto desde el chat web o la API.
¿Puedo establecer un valor por defecto si el valor de la variable está vacío?
Sí, puedes usar la siguiente sintaxis para definir un valor por defecto:
Dear {{ contact.name | customer }}!
En este caso, asumiendo que el contacto de destino no tiene nombre definido, el valor mostrado en el mensaje enviado será customer. Ejemplo:
Dear customer!
¿Qué ocurre si la variable está vacía y no hay un valor por defecto?
En ese caso, la expresión de la variable de plantilla se eliminará del mensaje.
Por ejemplo, dado el siguiente template de mensaje donde contact.name está vacío:
Hello {{ contact.name }},
We are happy to have you onboard!
El mensaje resultante se enviará así:
Hello,
We are happy to have you onboard!
Sin embargo, en casos como este puede ser mejor usar la sintaxis por defecto:
Hello {{ contact.name | there }},
We are happy to have you onboard!
Así es como se enviará al usuario:
Hello there,
We are happy to have you onboard!
¿Puedo usar múltiples valores por defecto posibles?
¡Sí! Puedes encadenar múltiples expresiones por defecto.
Si quieres reemplazar un valor dado con múltiples valores alternativos por defecto, puedes usar la siguiente sintaxis:
Dear {{ contact.name | contact.surname | contact.phone | customer }}
En este caso, si contact.name está vacío, tomará por defecto contact.surname. Luego, si contact.surname está vacío, tomará por defecto contact.phone. Finalmente, si contact.phone está vacío, tomará por defecto customer, una cadena literal.
