Índice:
Contenido Dinámico
El tipo Dinámico es un tipo de contenido de mensaje que se puede definir en tiempo de ejecución, es decir, durante el flujo del bot, lo que permite que el contenido que se pasa al usuario se construya y se muestre a pedido y de forma personalizada para cada usuario.
A través de él, puede crear cualquiera de los otros tipos de contenido de forma programática y dinámica. Para ello, es necesario conocer la estructura de cada uno de ellos y rellenar el bloque de contenido de la siguiente manera:
MIME Type: Definición del tipo de contenido
Esta información le dirá al bloque qué debe esperar recibir (una imagen, un menú o un carrusel, por ejemplo) y mostrar. Estos valores se pueden encontrar en la documentación para el tipo de contenido que desea, que se encuentran haciendo clic aquí.
Los principales tipos se pueden encontrar en la siguiente tabla:
Contenido MIME Type
Texto text/plain
Quick Reply application/vnd.lime.select+json
Imagen application/vnd.lime.media-link+json
Documento application/vnd.lime.media-link+json
Menu application/vnd.lime.select+json
Carrusel application/vnd.lime.document-select+json
Observación: asegúrese de verificar los tipos de contenido admitidos por cada canal para certificarse de que el canal pueda entregar el contenido que desea.
Contenido del mensaje
El contenido del mensaje es un JSON que contiene su información que se mostrará al usuario en el bot. Este JSON corresponde al objeto de contenido de la estructura de tipo de contenido elegido y debe seguir el patrón. Puede guardar este JSON en una variable y usarlo en este campo. Por ejemplo, si el tipo de contenido deseado es una Quick Reply, el JSON debería tener este patrón:
Observación: No olvide cambiar las informaciones para que se muestren de acuerdo a sus necesidades.
Metadatos
Use este campo si necesita enviar algún tipo de información adicional (metadatos) a su bot, pero que no necesita ser mostrada al usuario.
Estas informaciones se pasan en el formato Key: value:
Ejemplo: lista de facturas
Supongamos que tiene una API que devuelve una lista de facturas para ese cliente específico según la información, como identificación, por ejemplo.
El JSON con la respuesta de la API está estructurado de la siguiente manera:
{ "status":"ok",
"results":[
{
"titulo":"Pedido A - Parcela 1/12",
"id": "ABTOASDLZ2224",
"valor":"R$ 29.90",
"vecto":"2020-06-11"
},
{
"titulo":"Pedido A - Parcela 2/12",
"id": "ABTOASDLZ2225",
"valor":"R$ 29.90",
"vecto":"2020-07-10"
},
{
"titulo":"Pedido A - Parcela 3/12",
"id": "ABTOASDLZ2226",
"valor":"R$ 29.90"
, "vecto":"2020-08-10"
},
{
"titulo":"Pedido B - Parcela 1/5"
, "id": "APAXLDLZ7854",
"valor":"R$ 69.90"
, "vecto":"2020-08-15"
}
]
}
Para mostrar esta respuesta en un contenido de tipo Texto, como en el ejemplo siguiente, será necesario transformar la respuesta para adaptarla al estándar requerido por el contenido.
Para ello, será necesario ejecutar un script, que separe cada una de las facturas y las transforme en una única estructura. Para este ejemplo, la respuesta de la API se guarda en la variable de respuesta (1). La estructura creada en este script, que se usará para llenar el contenido dinámico, se guardará en la variable content(2).
function run(resposta) {
var json = JSON.parse(resposta);
var aux = "";
var count = 1;
json.results.forEach(function (element) {
aux = aux.concat(count, " - ", "Data: ", element.vecto, " valor: ", element.valor, "\n"); count++;
})
return content;
}
Dado que el tipo de contenido de Texto espera un MIMEType de tipo text/plain, se colocará en las configuraciones del bloque de contenido dinámico. El campo de contenido se completará con la variable de content, generada en el javascript anterior.
Ejemplo: Message Template con botones en WhatsApp
También es posible enviar una plantilla de mensaje preaprobada en WhatsApp como contenido dinámico durante el flujo del bot.
Por el momento, para enviar tipos de contenido Quick Reply y botones de Call tu Action durante el flujo de conversación del bot, esta es la única forma.
Para ello, debe crear una Message Template y enviarla a WhatsApp para su aprobación. Si quiere saber cómo hacerlo, haga clic aquí.
Después de la aprobación de la Message Template, copie su Nombre del modelo. En el bot, cree un contenido de tipo Contenido dinámico, complete el Mime Type como application/json y el valor del contenido como se muestra a continuación.
{
"type": "template",
"template": {
"name": "NOMBRE_DEL_MODELO",
"language": {
"policy": "deterministic",
"code": "pt_BR"
}
}
}
Para obtener más información, acceda a la discusión sobre el tema en nuestra comunidad o los videos en nuestro canal. 😃