Cómo Usar Modificadores para Variables
Con SendPulse puedes usar modificadores de variables para transformar su valor de acuerdo a las reglas que establezcas. Por ejemplo, puedes formatear texto, fechas, números de teléfono y direcciones URL.
Hablemos de los modificadores de variables y cómo usarlos en tus chatbots.
Sintaxis del Modificador
Puedes modificar datos usando {{ var_name | function(parameter="value") }}
, donde:
var_name
es un nombre de variable,function()
es una función modificadora,parameter
es un parámetro de función,value
es un valor de parámetro.
Puedes usar la sintaxis del modificador en fechas, mayúsculas y minúsculas, longitud de cadena, números de teléfono y URL.
Cadenas
str_to_lower() |
Convierte todos los caracteres a minúsculas.
Por ejemplo: título de la variable = "TÍTULO".
Resultado: título. |
str_to_upper() |
Convierte todos los caracteres a mayúsculas.
Por ejemplo, la variable de título = "
Resultado: TÍTULO. |
str_capitalize() |
Convierte todos los caracteres en una cadena y pone en mayúscula su primer carácter.
Por ejemplo, la variable de título = "
Resultado: Título. |
str_length() |
Devuelve la longitud de una cadena.
Por ejemplo: título = "
Resultado: 5. |
str_limit(limit="100", end="...") |
Trunca una cadena a la longitud especificada.
|
implode(separator="") |
Combina los elementos de una matriz de cadena separador .
{{ $["list"] | implode(separator=", ") }} muestra datos separados por comas de una matriz obtenida como resultado de una solicitud de datos externa. |
array_get(key="*.keyname") |
Recupera un valor de una matriz u objeto anidado utilizando la notación de puntos, que es un forma de acceder a las propiedades del objeto y los valores de la matriz. Un punto (. ) y un asterisco (* ) aparecen como un segmento de matriz y un número de elemento. Puede tener este aspecto: array.*.object.id .
Por ejemplo, si necesitas obtener nombres de una matriz, puedes usar |
Número y Fecha
number_round(precision="0", mode="ROUND_HALF_UP") |
Redondea un número a la precision especificada (el número de dígitos después de un punto decimal).
Si la Si la Puedes obtener más información sobre los posibles valores del modo de redondeo en la documentación de PHP. |
number_format(decimals="0", decimal_separator=".", thousands_separator=",") |
Da formato a un número con miles agrupados y dígitos decimales.
|
date(from_format="dmY", format="dmY", modify="") |
Formatea una cadena de fecha de acuerdo con el formato dado.
Solo se admiten los siguientes modificadores: +/-día(s), +/-mes(es), +/-año(s). Lee más sobre los modificadores de fecha en la documentación de PHP. Por ejemplo, si deseas obtener la fecha en el formato "nombre del mes y la fecha", puedes usar Resultado: 5 de enero. |
Otros Modificadores
phone(formig-fix-handle_api_exceptionat="INTERNATIONAL") |
Formatea una cadena con un número de teléfono según el formato dado.
Las opciones de formato posibles son:
|
urlencode() |
Devuelve una cadena donde todos los caracteres no alfanuméricos, excepto para guiones (- ), guiones bajos (_ ) y puntos (. ), deben reemplazarse con el signo de porcentaje (% ) seguido de dos números hexadecimales y espacios codificados como el signo más (+ ). La cadena se codifica igual que los datos POST del formulario web, es decir, el application/x-www-form-urlencoded .
El modificador se puede usar para pasar los valores recibidos del suscriptor a la solicitud de API, por ejemplo, como un parámetro de obtención. |
Características de Uso
Hablemos de posibles errores que pueden ocurrir al usar modificadores de variables y formas de combinar modificadores.
Puedes aplicar modificadores al elemento "Mensaje" en un flujo o campaña y todos los demás elementos donde puedes insertar y usar variables. Puedes obtener variables utilizando la función "Entrada de variable de usuario" o una respuesta a un elemento de "Solicitud de API".
Cuando estás llamando a una función modificadora y no requiere parámetros, se pueden omitir los corchetes "()".
Si un nombre de variable contiene }}
y |
símbolos, entonces deben escaparse con \}\}
y \|
en el nombre.
Si un valor de parámetro contiene }}
, |
y "
símbolos, deben escaparse con \}\}
, \|
y \"
. El valor del parámetro siempre se da en "" como una cadena.
Posibles Errores
Si un modificador no puede procesar una variable, la devuelve en la misma forma en que estaba antes de aplicar el modificador. Por ejemplo, si aplicamos el {{ name|phone(format="INTERNATIONAL") }}
a la variable de nombre = "Juan", obtenemos "Juan" como respuesta porque la variable no es un número de teléfono.
Si no se puede aplicar un modificador a una variable, el usuario no verá un error.
Los errores se muestran sólo si hay problemas con la sintaxis del modificador, no con los datos recibidos del usuario.
Combinación de Modificadores
Puedes combinar varios modificadores, por ejemplo:
{{variable_name|modifier_name1(parameter_name1="value",parameter_name2="value",parameter_name3="value",)|modifier_name2()|modifier_name_N()}} Si quieres truncar la longitud de la cadena variable hasta 10 caracteres y luego convertir todos los caracteres de la cadena a mayúsculas, la expresión se verá así: {{ String | str_limit(limit="10") | str_to_upper }}
Uso de Modificadores en el Generador de Chatbots
A continuación te mostraremos algunos ejemplos de cómo usar modificadores en el generador de chatbots de SendPulse.
Ejemplo de Formato de Nombre de Suscriptor
Piensa en tu escenario de flujo. En nuestro ejemplo, recopilaremos comentarios de los visitantes, por lo que primero queremos obtener el nombre de nuestro invitado y luego darle la oportunidad de compartir su impresión.
Ve a tu flujo o créelo, agrega el elemento "Mensaje" y escribe tu texto donde se le pide al suscriptor que comparta sus datos personales. Habilita la opción de Esperar respuesta del suscriptor, y en el campo "Validar como", selecciona "Cadena" y escoge una variable.
Haz clic en Aplicar y agrega el siguiente elemento "Mensaje".
El suscriptor puede ingresar su nombre con una letra minúscula por error, pero queremos dirigirnos a él correctamente, por lo que usamos el str_title()
modificador de variable.
Así es como lo ve un suscriptor.
Ejemplo de Formato de Fecha
Piensa en un escenario en el que un visitante desea reservar una mesa para una fecha específica. Al mismo tiempo, el cliente debe recibir una confirmación de reserva después de seleccionar una fecha.
Agrega el elemento "Mensaje" y escribe tu texto donde le pides al suscriptor que comparta sus datos personales. Habilita la opción "Esperar respuesta del suscriptor". En el campo "Validar como", selecciona "Fecha" y escoge una variable.
Haz clic en Aplicar y agrega el siguiente elemento "Mensaje".
Queremos que la fecha de la reserva se muestre siempre en el mismo formato, por lo que agregamos {{ order_date | date(format="dmY") }}
modificador de variable.
Esta es la respuesta que recibirá el usuario cuando seleccione una fecha.
Si quieres aprender más de marketing digital y de chatbots, te recomendamos que leas nuestro blog, donde encontrarás ideas sobre cómo programar un chatbot sin que tus clientes noten que es un chatbot, la efectividad de los chatbots comparado con las campañas de correos electrónicos masivos y 5 Errores que debes evitar al configurar tu chatbot.
Última actualización: 09.05.2023
Registrarse con
Iniciar sesión con Facebook Iniciar sesión con Google