De Script-widget aanpassen in de zoom-app

De Script-widget kan worden toegevoegd en bewerkt door contactcenterbeheerders. Met deze Script-widget kunt u een stroom maken door de gewenste acties naar de widget zelf te verzenden, waardoor u niet meer op de gebruikersinterface hoeft te vertrouwen bij het bouwen van een stroom. Standaard verbergen Script-widgets sleutels, geheimen en andere inloggegevens die eraan zijn gekoppeld.

Belangrijk:

• Zoom Contact Center heeft aangekondigd dat het op 17 september 2022 een nieuwe script-engine zal lanceren die een nieuw syntaxis voor scripts. Deze wijziging heeft geen gevolgen voor bestaande scripts. Er zijn echter een paar regels die gevolgd moeten worden bij het ontwikkelen nieuw script-widgets. Dit artikel bevat voorbeelden van nieuw scriptsyntaxis in de sectie Nieuwe versie.

• De volgende voorbeeldconfiguraties helpen u beter te begrijpen hoe u de Script-widget kunt gebruiken.

Vereisten voor het aanpassen van de Script-widget

• Eigendom of beheerdersrechten van het account

• Of u nu een Business-, Education- of Pro-accounthouder bent

• Een licentie voor Zoom Contact Center is vereist

• Maak spraak-, video-, web-, in-app- of sms-stromen op basis van uw voorkeur

• Een gevorderd begrip van Javascript is vereist

Hoe de Script-widget toe te voegen of te bewerken

1. Het webportaal van Zoom is toegankelijk door in te loggen.

2. Klik op Contact Center Management in het navigatiemenu en klik vervolgens op Flows in de vervolgkeuzelijst.

3. De weergavenaam van een stroom kan worden bewerkt door erop te klikken.

4. Script kan naar de gewenste locatie in de stroom worden gesleept door op de widget in het linkerdeelvenster met widgets te klikken en te slepen.

5. U moet de widget Script selecteren.

6. De widget kan worden hernoemd om deze begrijpelijker te maken voor de eindgebruiker. Klik op Naam wijzigen om uw wijziging.

7. U kunt een nieuw script aan een widget toevoegen door op de knop Script toevoegen te klikken en vervolgens de volgende opties op te geven:

8. Klik op de knop Toevoegen.

9. Als u JavaScript gebruikt, voer dan de onderstaande code in.

10. Het paneel Input Parameters kan worden gebruikt om parameters voor het script in JSON-indeling aan de rechterkant van het scherm in te voeren. Dit wordt gebruikt om het script lokaal te testen. De sleutel/waarde-paren moeten worden opgenomen volgens de JavaScript-code, dus zorg ervoor dat u ze opneemt. De invoerparameter die u moet opgeven, moet alle sleutel/waarde-paren bevatten die u verwacht te zien bij het lokaal testen van uw code.

11. Klik op de knop Uitvoeren.
    In het gedeelte Resultaten kunt u de resultaten bekijken.

12. Sluit het venster door erop te klikken.

13. Om het script op te slaan, klikt u op de knop Opslaan.

14. Klik op de volgende opties op het tabblad Instellingen (optioneel):

15. U kunt uw afsluitinstellingen aanpassen door op te klikken Uitgangen tabblad.

    • Succes: Selecteer de bestemmingswidget als het script met succes is uitgevoerd.

    • Mislukking: Wanneer het script niet kan worden uitgevoerd, selecteert u de widget die de bestemming moet zijn

Opmerking: Bekijk voorbeeldconfiguraties van de scriptwidget om een ​​beter begrip te krijgen van hoe het werkt.

Toewijzing van scriptvariabelen

Het is mogelijk om de waarde van een scriptvariabele toe te wijzen aan een stroomvariabele nadat de scriptwidget is geconfigureerd en uitgevoerd.

• In het script var_set() worden alle variabelen ingesteld in een stroomvariabele met de naam widget die vervolgens wordt geassocieerd met het script var_set(). Het is mogelijk om deze variabele als een lokale variabele te beschouwen.

• Er is een stroomvariabele met de naam waarde onder de widgetnaam die de waarde bevat die door het script wordt geretourneerd wanneer de widget wordt aangeroepen.

• Globaal aangepaste variabelen moeten worden gedefinieerd voor alle variabelen die zijn ingesteld door global_var_set om te worden gebruikt in globale variabelen. Het is mogelijk om naar de volledige naam van de globale variabele in de Script-widget te verwijzen en deze te wijzigen door global_var_set in de Script-widget te gebruiken.

Voorbeeld van scripttoewijzing

Voor meer informatie over rekeningnummers verwijzen wij u naar onderstaand voorbeeld.

Hoe scripts te programmeren

1. Uw code moet alle afhankelijkheden bevatten die u nodig hebt. U kunt de voorbeeldcode hieronder zien in lijnen 2 t/m 4.

2. Om ervoor te zorgen dat de code-engine uw JS-functie kan extraheren, geeft u uw functie door aan module.exports. Async mag alleen worden gebruikt wanneer wachten vereist is in uw functie. De functie hoeft niet te worden aangeroepen vanuit het codepaneel, dus het is niet nodig om het daar aan te roepen.
   Opmerking: Er wordt een automatische schakelaar ingeschakeld om de strikte modus in te schakelen.

Voorbeeld van scriptprogrammering

Nieuwe versie

async function main () {
  // your code starts here
}

Note: 
#### Supported built-in functions: (no need to import again)

## Variable Get/Set:
var_get()(string); var_set(string, string); global_var_set(string, string)

## Http Requests:
req.get(url(, config)); req.delete(url(, config)); req.head(url(, config)); req.options(url(, config))
req.post(url(, data(, config))); req.put(url(, data(, config))); req.patch(url(, data(, config)))

## Logging
log.debug(string), log.info(string), log.warn(string), log.error(string)

Oude versie

// Using Lambda

const log = require('./utils/log');
const req = require('axios'); // this is needed only if you plan to use Axios in your function
var {_get:var_get , _set:var_set, _setGlobalVariable:global_var_set} = require('./utils/variable');

module.exports = async () => {

// add your script logic. See two examples above.

return
}

Opmerking: De Javascript Script-widget geeft momenteel alleen toegang tot de Axios externe module, de enige die op dit moment beschikbaar is.

Hoe logboekregistratie te gebruiken

Door de volgende functie te gebruiken, kunt u de afhankelijkheid importeren:

const log = vereisen(‘./utils/log’);

Opmerking: Er is een nieuw versie van de script-engine die dit al bevat, dus u hoeft het niet opnieuw te importeren omdat het ingebouwd is

Voorbeeld van loggen

De volgende functies kunnen worden gebruikt om logging in uw applicatie te implementeren:

log.debug(“foutopsporing ingeschakeld”) log.error(“fout gedetecteerd”) log.info(“info: ja”) log.warn(“WAARSCHUWINGEN: “)

HTTP-verzoeken implementeren

De HTTP-verzoeken kunnen worden geïmplementeerd met behulp van Axios met behulp van de HTTP-aanvraagbibliotheek. Meer informatie over Axios Support vindt u op de website van het bedrijf.

Door de volgende functie te gebruiken, kunt u de afhankelijkheid importeren:

const req = require('axios');

Opmerking:

• U hoeft het niet opnieuw te importeren omdat dit al is ingebouwd in het nieuw versie van de script-engine.

• De widget HTTP-oproep is een standaardwidget waarmee u HTTP-verzoeken kunt doen met behulp van JavaScript-functies zonder dat u JavaScript hoeft te schrijven. Voor meer geavanceerde use-cases kunt u de Axios-module gebruiken in combinatie met een script dat ook HTTP-verzoeken uitvoert.

Variabelen ophalen in de Script-widget

1. Uw stroom moet een scriptwidget bevatten die u kunt toevoegen en configureren.

2. De variabele afhankelijkheidsimport moet worden toegevoegd aan het JavaScript-bestand.

   Voorbeeld:

var {_get:var_get , _set:var_set, _setGlobalVariable:global_var_set}
      = require('./utils/variable');

Opmerking: U hoeft het niet opnieuw te importeren omdat dit al is ingebouwd in het nieuw versie van de script-engine.

1. Om erachter te komen wat de waarde van een variabele is, kun je bij ons terechtethij var_get functie. Zowel lokale widgetvariabelen als globale variabelen zijn toegankelijk met de functie var_get. Naast de globaal gedefinieerde systeemvariabelen, moet u uw eigen globale variabelen definiëren voordat u ze kunt gebruiken.
   Voorbeeld:

var_get()("global_system.Consumer.firstName")

Opmerking: Variabelen binnen stromen zijn qua reikwijdte beperkt tot de actieve betrokkenheid, ook al zijn globale variabelen globaal in het systeem gedefinieerd. A de waarde van de globale variabele is spspecifiek ingesteld fof een specifieke opdracht wanneer deze binnen een stroom wordt ingesteld/gewijzigd. De bijgewerkte globale variabele waarde setely een ander engagement zal niet tegelijkertijd of later beschikbaar zijn voor andere consumenten in dezelfde stroom.

Lokale variabelen instellen binnen de Script-widget

1. Voeg de Script-widget toe aan uw stroom en configureer deze. De Script-widget moet in dit voorbeeld worden hernoemd naar Script1.

2. De variabele afhankelijkheid moet worden geïmporteerd in een JavaScript-bestand. De afhankelijkheidsimport moet worden toegevoegd.
   Voorbeeld:

var {_get:var_get , _set:var_set, _setGlobalVariable:global_var_set} = require('./utils/variable');

Opmerking:Het is niet nodig om dit opnieuw te importeren aangezien het gebouwd is naar binnen de nieuw versie van de script-engine.

1. Stel de waarde van een lokale variabele in met behulp van de functie var_set. Lokale variabelen krijgen hun volledige naam en hun waarden worden geïdentificeerd door hun waarden.

   Voorbeeld:

var_set("account_number", “99999")

Binnen deze stroom is Script1.account_number toegankelijk als de waarde van deze variabele

Hoe globale variabelen in te stellen binnen de Script-widget

1. Scriptwidget moet worden toegevoegd en geconfigureerd in uw stroom.

2. De variabele afhankelijkheidsimport moet worden toegevoegd aan een JavaScript-bestand.
   Voorbeeld:

var {_get:var_get , _set:var_set, _setGlobalVariable:global_var_set} = require('./utils/variable');

Opmerking: U hoeft het niet opnieuw te importeren omdat het is ingebouwd in het nieuw versie van de script-engine

1. Stel de waarde van een globale variabele in met de functie global_var_set. De volledige naam van een globale variabele is de eerste parameter en de waarde is de tweede.
   Voorbeeld:

global_var_set("global_system.Consumer.firstName", "Your Name")

Opmerking: Flows hebben een beperkte reikwijdte, terwijl globale variabelen globaal op het systeem kunnen worden gedefinieerd.