🦰
Sintaxis
A continuación te explicamos como funcionan los Webhooks personalizados para integraciones.
Para utilizar los webhooks personalizados debes conocer acerca de la sintaxis que utilizamos, la cual está basada en Mustache, una librería de código abierto que nos permite generar la estructura personalizada.
Básicamente deberás utilizar llaves
{{ }}
o conocidos como "curly braces". Esta sintaxis te permite acceder a valores que te entregamos para cada evento.Como se menciona anteriormente en la sección de variables, cada evento posee sus propios valores. Todos estos valores provienen de un
JSON
que posteriormente son inyectados basado en las variables que hayas escrito.Por ejemplo, un
JSON
igual a { "name": "John Doe" }
te permitirá usar su variable name
en sintaxis mustache, por lo que si deseo solo obtener el nombre (name
) como texto plano deberé escribir {{ name }}
, obteniendo como resultado John Doe
.Podrás escribir sintaxis mustache con o sin espacios entre las llaves o curly braces.
Dependiendo del tipo de dato podrás acceder mediante una sintaxis específica.
Para acceder a los valores de un
Object
deberás utilizar un punto .
al igual que en Javascript. Por ejemplo:{{ order.total }}
{{ order.product.description.pricing }}
Para acceder particularmente a
Array
existen varias sintaxis. Por ejemplo para el valor del primer elemento deberás indicar el índice al igual que en Javascript, pero separado un punto .
{{ orders.0 }}
En el caso que el
Array
esté compuesto por Object
podrás acceder a los valores de cada objeto mediante la separación de puntos .
de la siguiente manera:{{ orders.0.productId }}
Los helpers son funciones que te ayudarán con estructura, tipo de datos, iteración sobre listados, etc.
Estos se componen de una nomenclatura, la cual varía según su función.
Estos tipos de helpers se componen de un nombre + variable que desees usar, por ejemplo:
{{parser myValue}}
Donde
parser
es el nombre del helper, mientras que myValue
es la variable a utilizar.Estos tipos de helpers se componen de un nombre + variable + contenido, donde algunas veces el contenido puede ser opcional. Por ejemplo:
{{#if myValue}}{{/if}}
En este caso
if
es el nombre del helper, pero se debe anteponer un hashtag
# y finalizar con el mismo nombre anteponiendo un slash
/.Por lo tanto, a modo de ficción si tenemos un helper compuesto llamado
mySuperHelper
, se deberá escribir de la siguiente forma:{{#mySuperHelper myValue}}{{/mySuperHelper}}
Dentro del helper es posible añadir contenido, el cual como se mencionó es opcional. Dependiendo de cada helper podrás generar contenido dinámico. Para conocer las funciones de cada uno dirígete a la siguiente sección de helpers.
Dentro del contenido podrás acceder a variables dependiendo de los helpers, pero existen dos los cuales son nativos y haran referencia a diferentes valores dependiendo del contexto.
this
el cual hace referencia al valor de iteración o a la raíz del JSON
. Por ejemplo:{{#each orders}}
Order number {{this}} <--- referencia a cada valor del array "orders"
{{/each}}
{{this}}
@root
el cual accede a todo el JSON, es muy útil si deseas acceder a la raíz. Por ejemplo:[
{{#each orders}}
{
"order": {{this}}, <------ referencia a cada valor del array "orders"
"date": {{@root.createdAt}} <------ referencia a "createdAt" del JSON raíz
}
{{/each}}
]
Ahora que ya conoces como utilizar la sintaxis
{{ mustache }}
y helpers
te invitamos a continuar con el listado de helpers disponibles.Última actualización 1yr ago