Almacenamiento de valores clave, o cómo nuestras aplicaciones se han vuelto más convenientes

Cualquiera que desarrolle en Voximplant conoce el concepto de "aplicaciones" que conectan scripts en la nube, números de teléfono, usuarios, reglas y colas de llamadas entre sí. En pocas palabras, las aplicaciones son la piedra angular del desarrollo de nuestra plataforma, el punto de entrada a cualquier solución basada en Voximplant, ya que la creación de una aplicación es donde comienza todo.

Anteriormente, las aplicaciones no "recordaban" ni las acciones que realizaban los scripts ni los resultados de los cálculos, por lo que los desarrolladores se veían obligados a almacenar valores en servicios de terceros o en su backend. Si alguna vez ha trabajado con almacenamiento local en un navegador, entonces nuestra nueva funcionalidad es bastante similar a esta, porque... Permite que las aplicaciones recuerden pares clave-valor que son únicos para cada aplicación en su cuenta. El funcionamiento del almacenamiento fue posible gracias al nuevo módulo. Almacenamiento de aplicaciones – debajo del corte encontrarás una breve guía de cómo usarlo, ¡bienvenido!

Necesitarás

• Cuenta Voximplant. Si no lo tienes, entonces el registro vive aquí;
• Aplicación Voximplant, además de un script, una regla y un usuario. Crearemos todo esto en este tutorial;
• cliente web para hacer una llamada - utilice nuestro teléfono web teléfono.voximplant.com.

Configuración de Voximplant

Primero, inicia sesión en tu cuenta: gestionar.voximplant.com/auth. En el menú de la izquierda, haga clic en "Aplicaciones", luego en "Nueva aplicación" y cree una aplicación llamada almacenamiento. Vaya a la nueva aplicación, cambie a la pestaña Scripts para crear un script de countingCalls con el siguiente código:

require(Modules.ApplicationStorage);

VoxEngine.addEventListener(AppEvents.CallAlerting, async (e) => {
let r = {value: -1};

    try {
        r = await ApplicationStorage.get('totalCalls');
        if (r === null) {
            r = await ApplicationStorage.put('totalCalls', 0);
        }
    } catch(e) {
        Logger.write('Failure while getting totalCalls value');
    }

    try {
        await ApplicationStorage.put('totalCalls', (r.value | 0) + 1);
    } catch(e) {
        Logger.write('Failure while updating totalCalls value');
    }
    
    e.call.answer();
    e.call.say(`Приветствую.  Количество прошлых звонков: ${r.value}. `, Language.RU_RUSSIAN_MALE);

    e.call.addEventListener(CallEvents.PlaybackFinished, VoxEngine.terminate);

});

La primera línea conecta el módulo ApplicationStorage, el resto de la lógica se coloca en el controlador de eventos. alerta de llamada.

Primero declaramos una variable para que podamos comparar el valor inicial con el contador de llamadas. Luego intentamos obtener el valor de la clave totalCalls de la tienda. Si dicha clave aún no existe, la creamos:

try {
    r = await ApplicationStorage.get('totalCalls');
    if (r === null) {
        r = await ApplicationStorage.put('totalCalls', 0);
    }
}

A continuación, debe aumentar el valor clave en el almacenamiento:

try {
        await ApplicationStorage.put('totalCalls', (r.value | 0) + 1);
    }

TENGA EN CUENTA

Para cada promesa, debe especificar explícitamente el manejo de fallas, como se muestra en la lista anterior; de lo contrario, el script dejará de ejecutarse y verá un error en los registros. Detalles aquí.

Después de trabajar con el repositorio, el script responde a la llamada entrante mediante síntesis de voz y le indica cuántas veces llamó antes. Después de este mensaje, el script finaliza la sesión.

Una vez que haya guardado el script, vaya a la pestaña Enrutamiento de su aplicación y haga clic en Nueva regla. Llámelo startCounting, especifique el script countingCalls y deje la máscara predeterminada (.*).

Lo último es crear un usuario. Para hacer esto, vaya a "Usuarios", haga clic en "Crear un usuario", especifique un nombre (por ejemplo, usuario1) y una contraseña, luego haga clic en "Crear". Necesitaremos este par de inicio de sesión y contraseña para la autenticación en el teléfono web.

Cheque

Abra el teléfono web usando el enlace teléfono.voximplant.com e inicie sesión con su nombre de cuenta, nombre de la aplicación y par de nombre de usuario y contraseña de la aplicación. Después de iniciar sesión correctamente, ingrese cualquier conjunto de caracteres en el campo de entrada y haga clic en Llamar. ¡Si todo se hizo correctamente, escucharás un saludo sintetizado!

Le deseamos un gran desarrollo en Voximplant y estad atentos para más noticias: tendremos muchas más 😉

Fuente: habr.com