Academy – Plataforma Centribal
Te damos la bienvenida al espacio de aprendizaje de nuestra plataforma
Antes de continuar con este manual, puedes consultar la información básica de Entidades, Variables y Parametros aquí.
Los nombres de parámetros reservados representan parámetros de información que ya existen en Plataforma Centribal porque se han generado en la propia sesión del navegador del usuario final o bien porque ya hemos preguntado esta información.
Esta información que se encuentra guardada en la sesión del usuario, puede llamarse en cualquier momento ya sea para mostrarla en la respuesta de un intent, para desviar el flujo de la conversación por condicionales y/o para operar con una extensión o servicio web en Plataforma Centribal.
A continuación se definen parámetros que representan informaciones que ya existe en Plataforma Centribal por el mero hecho de haber establecido una sesión.
Podemos almacenar en la sesión del usuario información como el nombre y el correo, así como cualquier otra información que sea relevante para mostrar en la respuesta de un intent.
A continuación te mostramos unos cuantos ejemplos de parámetros que nos darán información en la respuesta.
$.pc.user.nameSi necesitamos que el chatbot identifique y se dirija al usuario final en cualquier parte del flujo podemos usar este parámetro para solicitarlo al inicio del flujo y luego llamar el nombre que se almacenó en el parámetro.
Primero debemos configurar un intent que inicie la pregunta al usuario que solicite su nombre.
En el segundo intent que creemos, siguiendo el flujo de los contextos, debemos definir un parámetro (ej. name) con la entidad @sys.person y marcando la opción guardar en sesión.
En la frase de entrada, debemos definir la variable que recogerá la información de este parámetro. Lo definiremos con $name$nombre del usuario$/name$.
Para la respuesta de este intent, agregaremos los artefactos relevantes y para poder invocar el nombre que hemos guardado en la sesión del navegador, usaremos el parámetro reservado: $.pc.user.name.
De esta manera podremos ver renderizado el nombre del usuario en la ventana del chatbot.
$.pc.user.emailPodremos realizar el mismo ejercicio anterior solicitando el correo electrónico del usuario. Se podrá guardar en sesión del navegador y podremos invocarlo o trasladarlo al cliente de CRM que necesitemos.
$.pc.user.parameters.{variable del parametro}También tendremos la oportunidad de invocar un valor de variable en cualquier parte de la conversación (otra respuesta de intent) utilizando el parámetro del título. Invocándolo como $.pc.user.parameters.phone, como el que hemos creado en la imagen a la derecha.
La única limitación de este parámetro, es que debemos utilizar nombre de parámetro único, para que no existan colisiones de información. Si preguntamos en dos ocasiones el número de teléfono y queremos utilizar esta variable, debemos hacer un parámetro para cada uno, ejemplo: $phone1 y $phone2 para así utilizar luego $.pc.user.parameters.phone1 y $.pc.user.parameters.phone2
$.pc.user.extensions.{variable_name}Podremos realizar el mismo ejercicio anterior, solicitando el correo electrónico del usuario. Se podrá guardar en sesión del navegador y podremos invocarlo o trasladarlo al cliente de CRM que necesitemos.
En Plataforma Centribal tendremos la posibilidad de usar respuestas condicionales, que nos ayudaran a dar una respuesta según valores de variables y parámetros. Adicionalmente podremos usar cualquier parámetro reservado para dar una respuesta especifica, si se cumplen los requisitos que se configuren.
Un ejemplo sencillo, podría ser el siguiente: Si un usuario nos escribe con un número de teléfono cuyo prefijo sea +34 (España), le ofrecemos la dirección de nuestro negocio en España. Pero si otro usuario escribe con el prefijo de Portugal +351 entonces respondemos tanto en portugués, como con la dirección de nuestro negocio con texto en portugués o en alemán si el prefijo es +49. NOTA: Solo disponible en Canal WhatsApp.
$.pc.user.phone.prefixExisten otros parámetros interesantes para usar en condicionales, te mostramos una lista de ellos:
Nos ayudara a identificar al usuario por su teléfono y lo guardará sesión.
NOTA: Solo disponible en Canal WhatsApp.
$.pc.user.phoneEste parámetro nos indica desde que canal se ha generado la sesión del usuario. Los canales disponibles son: chatweb, whatsapp, instagram, telegram y messenger.
Debemos escribirlos en minuscula en el campo de la condicional (ej: $.pc_session_channel es igual a whatsapp)
$.pc.user.channel
Si queremos dar respuesta a un usuario al que hayamos detectado el idioma de su navegador, podemos hacerlo mediante las siguientes variables.
Language: Nos dará la raíz del idioma junto a la variante del mismo.
pt-BR, portugués de Brasil.
es-AR, español de Argentina.
Language_root: Nos dará el idioma raíz del usuario.
En la siguiente lista podrás encontrar las distintas combinaciones de idioma junto a sus variantes: Lista de códigos ISO 639-1
$.pc.user.language$.pc.user.language.root