CCaaS_GetRepresentativeAvailabilityForConversation

Använd CCaaS_GetRepresentativeAvailabilityForConversation-API för att kontrollera tillgängligheten för kön och tjänstrepresentanten under en aktiv konversation med ett giltigt konversations-ID.

När till exempel en kund som chattar med en IVR- eller AI-agent begär eskalering till en tjänstrepresentant anropar AI-agenten detta API för att fastställa tjänstrepresentantens tillgänglighet och dirigera konversationen baserat på svaret.

Begär information

URL

/\<orgurl\>/api/data/v9.2/CCaaS\_ GetRepresentativeAvailabilityForConversation

Metod

POST

Version

1.0

Rubrik för begäran

Namn Beskrivning
Authorization Obligatorisk. Microsoft Entra ID autentiseringstoken för API-anroparen i kontaktcenterinstansen. Läs mer i Installationstoken för API-auktorisering

Exempelbegärantext

Beskrivning Exempelbegäran
Avgör kö- och representativ tillgänglighet för en aktiv konversation. curl --request POST \ --url https://<org-url>/api/data/v9.2/CCaaS_GetRepresentativeAvailabilityForConversation \ --header 'Authorization: Bearer token' \ --data '{ "ApiVersion": "1.0", "ConversationId": "2f2508bd-b58e-4982-b142-651e36dc8df3" }'
Bestäm kö- och representants tillgänglighet för en konversation där reglerna för routning till kö behöver fler kontextobjekt. curl --request POST \ --url https://<org-url>/api/data/v9.2/CCaaS_GetRepresentativeAvailabilityForConversation \ --header 'Authorization: Bearer token' \ --data '{ "ApiVersion": "1.0", "ConversationId": "cf21df54-6d64-4aea-b668-405b8aa42b07", "CustomContextItems": "{\"contextItem1\": {\"value\": \"contextItemValue1\", \"isDisplayable\": true, \"datatype\": \"DataType1\"}, \"contextItem2\": {\"value\": \"contextItemValue2\", \"isDisplayable\": true, \"datatype\": \"DataType2\"}}" }'
Regeln gäller för undersökning av kontextobjekt (typ: Text, värde: Indien) curl --request POST \ --url https://<org-url>/api/data/v9.2/CCaaS_GetRepresentativeAvailabilityForConversation \ --header 'Authorization: Bearer <Token>' \ --header 'Content-Type: application/json' \ --data '{ "ApiVersion": "1.0", "ConversationId": "94c002c8-b14e-4a0e-8069-78dcf0d6c208", "CustomContextItems": "{\"Survey\": {\"value\": \"India\", \"isDisplayable\": true, \"datatype\": \"192350000\"}}" }'

Anmärkning

  • I begärandetexten CustomContextItems är en sträng med de kontextobjekt som används i regler för routning till kö. Exempellistan över kontextobjekt:

    {
  "contextItemName1": {
    "value": "contextItemValue1",
    "isDisplayable": true,
    "datatype": "DataType1"
  },
  "contextItemName2": {
    "value": "contextItemValue2",
    "isDisplayable": true,
    "datatype": "DataType2"
  }
}

  • isDisplayable anger om kontextobjektet visas på skärmen. Det här värdet är antingen Sant eller Falskt.

  • datatype kan bara vara Text = 192350000 eller Heltal = 192350001

Svar

Om det lyckas returnerar den här metoden en 200 OK-svarskod. Metoden returnerar också följande statuskoder.

HTTP-status Beskrivning
400 Dålig begäran (Fel inmatningsparametrar)
401 Unauthorized
404 Resurs ej hittad
429 Hastighetsgräns (För många förfrågningar)
405 API är inte tillåtet
500 Internt serverfel

Svarsvärden

Namn Type Beskrivning
queueId String Målkön där begäran dirigeras baserat på konfigurationer av routningsregel och indata, till exempel entitetsvärden och kontext som ingår i routningsregeln.
isQueueAvailable Boolesk Visar TRUE om kön är inom drifttimmar. FALSKT om kön är utanför drifttimmarna.
NästaDriftstimsStarttid Datum och tid Starttiden (UTC) för driftstimmar för kön om det för närvarande är utanför driftstimmarna. Returnerar 01-01-0001 under kontorstid.
EndTimeOfNextOperatingHour Datum och tid Tiden (UTC) när drifttimmarna slutar för kön, om det för närvarande är utanför de aktuella drifttimmarna. Returnerar 01-01-0001 under kontorstid.
nexttransitiontime Datum och tid Tiden (UTC) när kön är i drift igen om den är utanför arbetstid. Under drifttimmar visas det när kön blir icke-operativ.
positionInQueue Siffra Kundens position i kön bakom andra i samma kö.
ärAgentTillgänglig Boolesk Visar:
  • SANT om kundtjänstrepresentanter i kön för närvarande är tillgängliga för att ta emot begäranden baserat på dirigering- och tilldelningsreglerna för arbetsström.
  • FALSKT om tjänstrepresentanter inte är tillgängliga för att ta emot begäranden.
genomsnittlig väntetid Siffra Genomsnittlig väntetid i minuter för kunder i målkön.
GenomsnittligVäntetidIsekunder Numbers Genomsnittlig väntetid i sekunder för kunder i målkön.
AntalExperterTillgängligaIKön Numbers Antalet tjänstrepresentanter som för närvarande är tillgängliga för att acceptera konversationer i målkön.

Exempelsvar

{  
"@odata.context": "https://<org-url>/api/data/v9.2/\$metadata#Microsoft.Dynamics.CRM.CCaaS_GetRepresentativeAvailabilityForConversationResponse",  
"NextTransitionTime": "9999-12-31T23:59:59Z",
"NumberOfExpertsAvailableInQueue": 5,
"AverageWaitTimeInSeconds": 45  
"PositionInQueue": 1,  
"AverageWaitTime": null,  
"StartTimeOfNextOperatingHour": "0001-01-01T00:00:00Z",  
"EndTimeOfNextOperatingHour": "0001-01-01T00:00:00Z",  
"QueueId": "85e55877-f27a-e911-a81a-000d3a1ca610",  
"IsAgentAvailable": true,  
"IsQueueAvailable": true  
}

Använda API:er för representativ tillgänglighet
CCaaS_GetRepresentativeAvailabilityBeforeConversation

  • Last updated on