Sdílet prostřednictvím

getAgentAvailability

Omnikanál pro Customer Service nabízí sadu funkcí, které rozšiřují výkon Dynamics 365 Customer Service Enterprise, což umožňuje organizacím okamžitě se spojit a komunikovat se svými zákazníky prostřednictvím kanálů digitálního zasílání zpráv. Pro přístup k Omnikanálu pro Customer Service je vyžadována další licence. Více informací naleznete na stránkách Přehled cen Dynamics 365 Customer Service a Cenový plán Dynamics 365 Customer Service.

Načte dostupnost agenta pro frontu na základě pravidel směrování. Vývojář omnichannel může pomocí tohoto API určit, zda má být možnost zahájení konverzace viditelná pro zákazníka, a také pro zobrazení informací, jako je čekací doba a pozice ve frontách.

Poznámka:

  • Před voláním metod sady SDK pro živý chat si poslechněte událost lcw:ready vyvolanou živým chatem. Metody živého chatu lze vyvolat po vyvolání události lcw:ready . Tuto událost můžete poslouchat přidáním vlastního posluchače událostí na objekt window.
  • Tuto metodu je možné volat vícekrát ze strany klienta při změně vstupu zákazníka. Mezipaměť na straně klienta se aktualizuje každé 2 minuty nebo při změně parametrů kontextu zákazníka.
  • Tuto metodu lze volat pouze 100krát za minutu pro každou organizaci. Pokud limit překročíte, zobrazí se stavový kód odpovědi http 429 označující, že jste odeslali příliš mnoho požadavků v zadaném čase.

Syntaxe

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

Parametry

None

Návratová hodnota

Název Typ Description
queueId String Cílová fronta, do které je požadavek směrován na základě konfigurace směrovacího pravidla a vstupních dat (je uvedena hodnota entity a kontext, které jsou součástí směrovacího pravidla).
isQueueAvailable logický Zobrazuje:
- TRUE, pokud je fronta v provozní době.
- FALSE, pokud je fronta mimo provozní dobu.
StartTimeOfNextOperatingHour DateTime Čas zahájení (UTC) provozní doby fronty, pokud je mimo provozní dobu. Během provozní doby je vrácena hodnota 01-01-0001.
EndTimeOfNextOperatingHour DateTime Čas (UTC), kdy končí provozní doba fronty, pokud je mimo provozní dobu. Během provozní doby je vrácena hodnota 01-01-0001.
nexttransitiontime DateTime Čas (UTC), kdy je fronta opět v provozu, pokud je mimo provozní dobu. Čas, kdy fronta není v provozu, je zobrazen v provozní době.
positionInQueue Number Pozice ve frontě pro zákazníka čekajícího za ostatními zákazníky ve stejné frontě.
isAgentAvailable logický Zobrazuje:
- TRUE, pokud jsou agenti ve frontě aktuálně k dispozici pro přijímání požadavků na základě nakonfigurovaných pravidel směrování a přiřazení pro tok práce. Rozhraní API také vrátí hodnotu true, pokud je robot připojen k toku práce nebo frontě. Doporučujeme toto rozhraní API nepoužívat, pokud je přítomen robot.
- FALSE, pokud nejsou k dispozici agenti, kteří by mohli přijímat požadavky.
averageWaitTime Number Průměrná čekací doba v minutách pro zákazníky v cílové frontě na základě údajů za posledních 48 hodin.

Example

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

Předejte vlastní hodnoty kontextu pro funkci, abyste se ujistili, že je kontext přijat

Tato metoda provede interní volání funkce setContextProvider a poté synchronně zavolá getAgentAvailability, aby se ujistila, že je před pokračováním nastaven kontext. Vzhledem k asynchronní povaze funkcí, pokud jsou používány samostatně, nemusí být kontext připraven, když je k dispozici konzultační agent.

Poznámka:

Před voláním metody getAgentAvailability není nutné volat metodu setContextProvider.

Zde je ukázkový kód, který ukazuje, jak tuto setContextProvider metodu používat.

// 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':'test@test.com','isDisplayable':true},

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

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

        }

    }

    );

StartChat
setContextProvider
Informace o sadě SDK pro živý chat

  • Last updated on