Desarrollar código en la plataforma

Características de código
Soporta Node.js v8.0, junto a la lista de libraries abajo:
1
  {
2
    "@turf/helpers": "^6.1.4", // accessed by "turfHelpers" var
3
    "@turf/turf": "^5.1.6", // accessed by "turf" var
4
    "bluebird": "^3.5.1", // accessed by "bluebird" var
5
    "googleapis": "^32.0.0", // accessed by "google" var
6
    "js-sha256": "^0.9.0", // accessed by "sha256" var
7
    "jsonwebtoken": "^8.3.0", // accessed by "jwt" var
8
    "lodash": "^4.17.10", // accessed by "_" var
9
    "md5": "^2.2.1", // accessed by "md5" var
10
    "moment": "^2.22.2", // accessed by "moment" var
11
    "redis": "^2.8.0",
12
    "request": "^2.87.0",
13
    "request-promise": "^4.2.2", // accessed by "rp" var
14
    "secure-random": "^1.1.1", // accessed by "securedRandom" var
15
    "xml2js": "^0.4.19", // accessed by "xml2js" var
16
    "aws-sdk": "^2.485.0"  // accessed by "awsSdk" var
17
  }
Copied!
Input de Acción de Cliente
Cuando el código fue disparado, toda información que tenemos del usuario, conversaciones y configuraciones generales serán provistas. La json abajo describe el input que una Cloud Function podrá usar.
1
{
2
  "context": {
3
    "userData": {
4
      "CHAT_PLATFORM_ID": "webchat",
5
      "CHAT_CHANNEL_ID": "YPDXTZKM8Y3NXLXVQYAN-webchat-null",
6
      "PLATFORM_CONTACT_ID": "0BBSX05QRF-3318782UBYKNLUIRBM0KL8XMDTM",
7
      "LAST_MODIFICATION": "2018-07-23T03:43:51.243Z",
8
      "HAS_TALKED": true,
9
      "_id_": "O0IUBYCHJYSA4PNB0QH7",
10
      "LAST_SEEN": "2018-07-23T03:43:52.279Z",
11
      "variables": {
12
        "svar": "sdas"
13
      },
14
      "tags": [
15
        "testtest2"
16
      ]
17
    },
18
​
19
    "message": {
20
      "BUSINESS_ID": "YPDXTZKM8Y3NXLXVQYAN",
21
      "CREATION_TIME": "2018-07-23T03:43:52.281Z",
22
      "FROM_NAME": "Usuario",
23
      "CUSTOMER_ID": "O0IUBYCHJYSA4PNB0QH7",
24
      "_id_": "LBIJGWZN4SJADFT2HUD2",
25
      "FROM": "0BBSX05QRF-3318782UBYKNLUIRBM0KL8XMDTM",
26
      "OBJECT_TYPE": "Message",
27
      "SESSION_CREATION_TIME": "2018-07-23T03:43:52.281Z",
28
      "AUDIOS_URLS": [],
29
      "MESSAGE": "test",
30
      "CHAT_PLATFORM_ID": "webchat",
31
      "CHAT_CHANNEL_ID": "YPDXTZKM8Y3NXLXVQYAN-webchat-null",
32
      "LAST_MODIFICATION": "2018-07-23T03:43:52.281Z",
33
      "TO": "me",
34
      "TAGS": {}
35
    },
36
​
37
    "params": {}
38
  }
39
}
Copied!
El objeto context
Un objeto solamente lectura tiene información relevante que una acción de código puede requerir. Esto proporciona:
userData: toda información referente a un usuario, incluyendo tags y variables (si hubiera);
message: información referente al último mensaje del usuario;
params: parámetros opcionales que pueden ser enviados por una intención.
Por ejemplo:
1
const userFirstName = context.userData.FIRST_NAME;
Copied!
El objeto user
Este objeto permite leer y escribir variables que persistirán en el usuario. Es muy útil para guardar datos relacionados con el usuario.
Ten presente que los valores tendrán que ser de tipo string
Para leer un valor: user.get('valueKey') => devolverá una string con un valor o nula
Para escribir un valor: user.set('valueKey', 'value')
Por ejemplo:
1
if ( !user.get('neverWasHere') )
2
  user.set('neverWasHere', 'true');
Copied!
El valor neverWasHere será true para siempre, o hasta cuando otra acción de cliente configure un valor diferente.
En la sección de configuración de variables se puede cambiar el tipo de la variable y si es visible a los agentes que atienden conversaciones.
También, es posible que la variable expire con la sesión luego de un periodo de inactividad.
Utilizar entidades (entityLoader)
Cuando se haga upload de un archivo cvs en menu "Entidades" de la plataforma, las Acciones de Cliente tendrán acceso a él. Una lista guardada podrá ser filtrada.
1
/*Entidad cargada:
2
id | name
3
 1 | Gabriel
4
 2 | Dario
5
*/
6
​
7
//Utilizar la función entityLoader para leer las entidades cargadas
8
entityLoader('entity name', json => {
9
​
10
  // here you got your entity object loaded as json
11
  if (!json) {
12
    user.set('error', 'No hay datos');
13
    result.done();
14
    return;
15
  }
16
​
17
  //Buscamos el dato que necesitamos
18
  const data = json.find(row => row.id === 2);
19
  
20
  result.text('Muestro el nombre ->' + data.name);
21
    
22
});
Copied!
El objeto connectRedis
Una instancia db instance está disponible para ser utilizada con Acciones de Clientes. Podrá:
1
const redis = connectRedis();
2
const myKey = redis.get('key');
Copied!
Soporte completo a redes será proporcionado. De una mirada en el node oficial: [redis library](https://github.com/NodeRedis/node_redis)
Resultado de una Acción de Cliente
Cualquier resultado adicional que una Acción de Cliente quiera crear, precisa ser realizado usando el objeto result.
Para decir algo a un usuario usando texto: result.text('a message')
Para mostrar una imagen a un usuario: result.image('https://example.com/image.jpg')
Para mostrar un vídeo a un usuario: result.video('https://example.com/video.mp4')
Para enviar un archivo a un usuario: result.image('https://example.com/myfile.doc')
Para enviar un audio a un usuario: result.audio('https://example.com/audio.mp3')
Igualmente, es posible enviar a un usuario un texto con botones de acción.
1
result.buttonsBuilder()
2
  .text('select an option')
3
  .addURLButton('click me', 'https://www.google.com') // a button that will open a page
4
  .addLocationButton() // ask the user for its location using GPSs
5
  .quickReplies() // marks the button so it's showed as pills
6
  .addPhoneButton('call me', '+11233212312')
7
  .addButton('click me', 'rule with name XX') // when user clicks it will fire the rule named XX
8
  .send(); // send must by always called to finalize
Copied!
Ir a otra intención
Es posible ejecutar una intención, después de finalizada la Acción del Cliente, de forma muy sencilla. Después de decir algo a un usuario, cambiar algún dato o modificar su estado, podrás continuar el flujo de la conversación disparando alguna intención.
1
result.gotoRule('a rule name');
Copied!
Término de Acción de Cliente
result.done() deberá ser ejecutado cuando una Acción de Cliente se dé por finalizada.
Es muy importante llamar result.done() en todo flujo que exista una Acción de Cliente, de modo de finalizar la ejecución del mismo.
El siguiente código muestra una Acción de Cliente bien implementada, con el método done() llamado en todo el flujo.
1
rp({uri: 'https://script.google.com/macros/s/AKfycbyd5AcbAnWi2Yn0xhFRbyzS4qMq1VucMVgVvhul5XqS9HkAyJY/exec?tz=Asia/Tokyo Japan', json: true})
2
    .then(json=> {
3
        // saying the time
4
        result.text('The time in Tokyo is ' + json.fulldate);
5
​
6
        // do not forget to end the execution
7
        result.done();
8
    })
9
    .catch(error => {
10
        result.text('Problems: ' + error + '|' + JSON.stringify(error));
11
        result.done();
12
    });
Copied!
Uso de listas personalizadas (Lista JSON)
Si deseas utilizar las opciones para una pregunta que está configurada dinámicamente y que cambia con el tiempo, es posible agregar un valor a una variable especial dentro de una acción del cliente.
En el código Javascript, será necesario crear una lista de objetos, cada uno con los campos “id” y “nombre”. Puedes agregar otras claves a estos objetos, pero no es obligatorio. Mira el ejemplo:
1
​
2
myJSONList = COUNTRIES.map((country, index) => { return { id: index, name: country }; });
3
​
4
//result.text(JSON.stringify(myJSONList)); user.set('countries', JSON.stringify(myJSONList));
5
​
6
result.done();
Copied!
Para utilizar esta variable en una intención, será necesario declarar que los valores válidos para la pregunta son de una Lista JSON personalizada y hacer referencia a la variable utilizada en el código.
​
 Finalmente, deberías ver algo como:
Crear una Client Action con parametros
​
Se puede crear utilizando la acción “Acción del cliente con parámetros”:
O desde un código, usando un botón que llama a otra Acción del Cliente:
1
	.addClientActionButton('Nombre del boton',   //Nombre que aparecerá en el boton
2
												 'Nombre de la Client Action', //Nombre de la client action
3
												 { 
4
												    'key': 'valor',
5
												    'key2': 'otro_valor'
6
												 })  //Json Object con los parametros que se enviará
7
  .buildButtons();
Copied!
Para usar los parámetros enviados a Client Action:
1
const myVar = context.params.key
2
const myVar2 = context.params.key2 
Copied!
Leer Spreadsheet de Google Drive
Para leer un spreadsheet de google drive debes:
1
 const spreadsheetURI = `https://docs.google.com/spreadsheets/d/${SPREADSHEET_ID}/export?format=csv`;
2
 
3
 rp({uri: spreadsheetURI})
4
     .then(data => {
5
         return new Promise (resolve => {
6
              	csv.fromString(data, {headers: true, ignoreEmpty: true})
7
                    .on("data", data => {
8
                        //Do something with data
9
                    })
10
                    .on("end", () => {
11
                        resolve(json); //finish spreadsheet
12
                    });
13
            });
14
        });
Copied!
​Más información acerca de parametros de google drive