getAgentAvailability

Omnicanal pentru Customer Service oferă o suită de capacități care extinde puterea Dynamics 365 Customer Service Enterprise pentru a permite organizațiilor să se conecteze instantaneu și să interacționeze cu clienții lor prin canale de mesagerie digitală. Este necesară o licență suplimentară pentru a accesa Omnicanal pentru Customer Service. Pentru mai multe informații, consultați paginile Prezentare generală a prețurilor Dynamics 365 Customer Service și Planul de prețuri Dynamics 365 Customer Service .

Preia disponibilitatea agentului pentru o coadă pe baza regulilor de rutare. Dezvoltatorul omnicanal poate utiliza acest API pentru a determina dacă opțiunea de pornire a conversației ar trebui să fie vizibilă pentru client și, de asemenea, pentru a afișa informații precum timpul de așteptare și poziția în cozi.

Notă

  • Ascultați evenimentul lcw:ready generat de un chat live înainte de a apela metodele SDK de chat live. Metodele de chat live pot fi invocate după ce evenimentul lcw:ready este ridicat. Puteți asculta acest eveniment adăugând propriul ascultător de evenimente pe obiectul window.
  • Această metodă poate fi apelată de mai multe ori din partea clientului atunci când se modifică intrarea clientului. Memoria cache din partea clientului este reîmprospătată la fiecare 2 minute sau când parametrii contextului clientului se schimbă.
  • Această metodă poate fi apelată de 100 de ori pe minut numai pentru fiecare organizație. Dacă depășiți limita, vedeți codul de stare a răspunsului http 429 care indică faptul că ați trimis prea multe solicitări într-o anumită perioadă de timp.

Sintaxă

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

Parametrii

Nici unul

Valoare returnată

Nume Type Descriere
queueId Șir Coada țintă în care este direcționată cererea pe baza configurației regulii de rutare și a datelor de intrare (sunt furnizate valoarea entității și a contextului care fac parte din regula de rutare).
isQueueAvailable Boolean Afişează:
- ADEVĂRAT dacă coada este în programul de funcționare.
- FALSO dacă coada este în afara orelor de funcționare.
StartTimeOfNextOperatingHour DateTime Ora de începere (UTC) a orelor de funcționare pentru coadă dacă este în afara orelor de funcționare. În timpul orelor de funcționare, este returnată o valoare de 01-01-0001.
EndTimeOfNextOperatingHour DateTime Ora (UTC) la care se termină orele de funcționare pentru coadă dacă este în afara orelor de funcționare. În timpul orelor de funcționare, este returnată o valoare de 01-01-0001.
nexttransitiontime DateTime Ora (UTC) la care coada este din nou operațională dacă este în afara orelor de funcționare. Ora în care coada nu este operațională este afișată în timpul orelor de funcționare.
positionInQueue Număr Poziția în coadă pentru un client care așteaptă în spatele altor clienți din aceeași coadă.
isAgentAvailable Boolean Afişează:
- TRUE dacă agenții din coadă sunt disponibili în prezent pentru a prelua solicitări pe baza regulilor de rutare și atribuire configurate pentru fluxul de lucru. API-ul returnează, de asemenea, true dacă un bot este atașat la fluxul de lucru sau la o coadă. Vă recomandăm ca acest API să nu fie utilizat atunci când este prezent un bot.
- FALSE dacă agenții nu sunt disponibili pentru a prelua solicitări.
averageWaitTime Număr Durata medie de așteptare în minute pentru clienții din coada țintă pe baza datelor din ultimele 48 de ore.

Exemplu

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

Transmiteți valorile de context personalizate pentru funcție pentru a vă asigura că este primit contextul

Această metodă efectuează un apel intern la funcția setContextProvider și apoi apelează getAgentAvailability sincron, pentru a se asigura că contextul este setat înainte de a continua. Din cauza naturii asincrone a funcțiilor atunci când sunt utilizate separat, este posibil ca contextul să nu fie gata atunci când agentul de consultanță este disponibil.

Notă

Nu trebuie să apelați metoda setContextProvider înainte de a apela getAgentAvailability.

Iată un exemplu de cod care arată cum să utilizați setContextProvider metoda.

// 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
Referință SDK pentru chat live

  • Last updated on