getAgentAvailability

Customer Service'i omnikanal pakub võimaluste komplekti, mis laiendab Dynamics 365 Customer Service Enterprisei võimsust, et võimaldada organisatsioonidel koheselt suhelda ja suhelda oma klientidega digitaalsete sõnumsidekanalite kaudu. Customer Service'i omnikanalile juurdepääsuks on vaja lisalitsentsi. Lisateabe saamiseks vaadake Dynamics 365 Customer Service'i hinnaülevaade ja Dynamics 365 Customer Service'i hinnaplaan lehekülge.

Toob järjekorra agendi saadavuse marsruutimisreeglite põhjal. Omnikanali arendaja saab seda API-d kasutada selleks, et määrata, kas vestluse alustamise suvand peaks olema kliendile nähtav, ja ka teabe kuvamiseks, nagu ooteaeg ja positsioon järjekordades.

Märkus.

  • Enne reaalajas vestluse SDK meetodite kutsumist kuulake reaalajas vestluse tõstatatud sündmust lcw:ready. Reaalajas vestluse meetodeid saab käivitada pärast sündmuse lcw:ready tõstatamist. Saate seda sündmust kuulata, lisades aknaobjektile oma sündmuse kuulaja.
  • Seda meetodit saab kliendi poolelt mitu korda kutsuda, kui kliendi sisend muutub. Kliendipoolset vahemälu värskendatakse iga 2 minuti järel või siis, kui kliendi konteksti parameetrid muutuvad.
  • Seda meetodit saab kasutada ainult 100 korda minutis organisatsiooni kohta. Kui ületate limiidi, näete http 429 vastuse olekukoodi, mis näitab, et saatsite määratud aja jooksul liiga palju taotlusi.

Süntaks

Microsoft.Omnichannel.LiveChatWidget.SDK.getAgentAvailability();

Parameetrid

Pole

Tagastusväärtus

Nimi Tüüp Kirjeldus
queueId String Sihtjärjekord, kuhu taotlus marsruuditakse marsruutimisreegli konfiguratsiooni ja sisendandmete põhjal (esitatakse olemi väärtus ja kontekst, mis on osa marsruutimisreeglist).
isQueueAvailable loogiline Kuvab:
- TRUE, kui järjekord on tööaja piires.
- VÄÄR, kui järjekord on väljaspool tööaega.
StartTimeOfNextOperatingHour Kuupäev ja kellaaeg Järjekorra töötundide algusaeg (UTC), kui see on väljaspool tööaega. Tööajal tagastatakse väärtus 01-01-0001.
EndTimeOfNextOperatingHour Kuupäev ja kellaaeg Aeg (UTC), millal järjekorra tööaeg lõpeb, kui see on väljaspool tööaega. Tööajal tagastatakse väärtus 01-01-0001.
nexttransitiontime Kuupäev ja kellaaeg Aeg (UTC), mil järjekord on jälle töökorras, kui see on väljaspool tööaega. Kellaaeg, mil järjekord ei tööta, kuvatakse tööajal.
positionInQueue Number Positsioon järjekorras kliendi jaoks, kes ootab teiste samas järjekorras olevate klientide taga.
isAgentAvailable loogiline Kuvab:
- TRUE, kui järjekorras olevad agendid on praegu saadaval taotluste vastuvõtmiseks töövoo konfigureeritud marsruutimis- ja määramisreeglite alusel. API tagastab tõese ka siis, kui robot on töövoogu või järjekorda manustatud. Soovitame seda API-d mitte kasutada, kui robot on olemas.
- VALE, kui agendid ei ole päringute vastuvõtmiseks saadaval.
averageWaitTime Number Sihtjärjekorras olevate klientide keskmine ooteaeg minutites viimase 48 tunni andmete põhjal.

Näide

window.addEventListener("lcw:ready", function handleLivechatReadyEvent(){
               // Gets the agent availability
               Microsoft.Omnichannel.LiveChatWidget.SDK.getAgentAvailability();
});

Edastage funktsiooni jaoks kohandatud kontekstiväärtused, et veenduda, et kontekst võetakse vastu

See meetod teeb sisemise kutse funktsioonile setContextProvider ja kutsub seejärel sünkroonselt getAgentAvailability, et veenduda, et kontekst on enne jätkamist määratud. Funktsioonide asünkroonse olemuse tõttu, kui neid kasutatakse eraldi, ei pruugi kontekst olla valmis, kui konsultatsiooniagent on saadaval.

Märkus.

Enne getAgentAvailability kutsumist ei pea te kutsuma meetodit setContextProvider.

Siin on näidiskood, mis näitab, kuidas meetodit setContextProvider kasutada.

// To set the custom context, pass the custom context object as input parameter to agent availability

    // provider as part of the logic, so there is no need to set custom context before this call.

    Microsoft.Omnichannel.LiveChatWidget.SDK.getAgentAvailability({

        customContext : {

                'jwtToken': {'value':'token','isDisplayable':true},

                'Email': {'value':'mae.gibbins@contoso.com','isDisplayable':true},

                'client': {'value':'true','isDisplayable':true},

                'Emailing': {'value':'true','isDisplayable':true}

        }

    }

    );

startChat
setContextProvider
Reaalajas vestluse SDK viide

  • Last updated on