Le stockage clé-valeur, ou comment nos applications sont devenues plus pratiques

Quiconque développe sur Voximplant connaît le concept d'« applications » qui connectent les scripts cloud, les numéros de téléphone, les utilisateurs, les règles et les files d'attente d'appels entre eux. En termes simples, les applications sont la pierre angulaire du développement sur notre plateforme, le point d'entrée de toute solution basée sur Voximplant, puisque la création d'une application est le point de départ de tout.

Auparavant, les applications ne « se souvenaient » ni des actions effectuées par les scripts ni des résultats des calculs, de sorte que les développeurs étaient obligés de stocker les valeurs​​dans des services tiers ou sur leur backend. Si vous avez déjà travaillé avec le stockage local dans un navigateur, notre nouvelle fonctionnalité est assez similaire à celle-ci, car... Permet aux applications de mémoriser les paires clé-valeur propres à chaque application de votre compte. Le fonctionnement du stockage est devenu possible grâce au nouveau module Stockage d'application – sous la coupe, vous trouverez un petit guide d'utilisation, bienvenue !

Tu auras besoin

• Compte Voximplant. Si vous ne l'avez pas, alors l'inscription vit ici;
• Application Voximplant, ainsi qu'un script, une règle et un utilisateur. Nous allons créer tout cela dans ce tutoriel ;
• client Web pour passer un appel - utilisez notre téléphone Web téléphone.voximplant.com.

Paramètres de l'implant Vox

Tout d'abord, connectez-vous à votre compte : manage.voximplant.com/auth. Dans le menu de gauche, cliquez sur « Applications », puis « Nouvelle application » et créez une application appelée stockage. Accédez à la nouvelle application, passez à l'onglet Scripts pour créer un script countingCalls avec le code suivant :

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 première ligne connecte le module ApplicationStorage, le reste de la logique est placé dans le gestionnaire d'événements Alerte d'appel.

Nous déclarons d’abord une variable afin de pouvoir comparer la valeur initiale avec le compteur d’appels. Ensuite, nous essayons d'obtenir la valeur de la clé totalCalls du magasin. Si une telle clé n'existe pas encore, alors nous la créons :

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

Ensuite, vous devez augmenter la valeur de la clé dans le stockage :

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

S'IL VOUS PLAÎT NOTE

Pour chaque promesse, vous devez spécifier explicitement la gestion des échecs, comme indiqué dans la liste ci-dessus – sinon le script cessera de s'exécuter et vous verrez une erreur dans les journaux. Détails ici.

Après avoir travaillé avec le référentiel, le script répond à l'appel entrant à l'aide de la synthèse vocale et vous indique combien de fois vous avez appelé auparavant. Après ce message, le script met fin à la session.

Une fois le script enregistré, rendez-vous dans l'onglet Routage de votre application et cliquez sur Nouvelle règle. Appelez-le startCounting, spécifiez le script countingCalls et laissez le masque par défaut (.*).

La dernière chose est de créer un utilisateur. Pour cela, allez dans « Utilisateurs », cliquez sur « Créer un utilisateur », précisez un nom (par exemple, user1) et un mot de passe, puis cliquez sur « Créer ». Nous aurons besoin de cette paire login-mot de passe pour l'authentification sur le webphone.

Chèque

Ouvrez le téléphone Web en utilisant le lien téléphone.voximplant.com et connectez-vous en utilisant votre nom de compte, le nom de l'application et la paire nom d'utilisateur-mot de passe de l'application. Une fois la connexion réussie, entrez n'importe quel jeu de caractères dans le champ de saisie et cliquez sur Appeler. Si tout a été fait correctement, vous entendrez un message d'accueil synthétisé !

Nous vous souhaitons un bon développement sur Voximplant et restons à l'écoute pour plus de nouvelles - nous en aurons beaucoup plus 😉

Source: habr.com