Genesys Cloud - Main

 View Only

Sign Up

  Thread closed by the administrator, not accepting new replies.
  • 1.  Force Agent On-Queue Audit Trail

    Posted 05-05-2022 11:44
    No replies, thread closed.
    Hi all,
    Is there a way to see either in the Audit trails or through an API  who forced an Agent on-queue?  We have some supervisors pushing agents that don't report to them into on-queue but we can't figure out who is doing it.
    #Ask Me Anything (AMA)
    #Routing(ACD/IVR)
    #Unsure/Other

    ------------------------------
    nichole conway
    State of Missouri - Family Support Division
    ------------------------------


  • 2.  RE: Force Agent On-Queue Audit Trail

    Posted 06-04-2022 01:41
    Edited by Paulo Mesquita do not use 06-04-2022 01:46
    No replies, thread closed.
    Hi Nichole,

    Yes, if you have a date/time you can search for these events via API.

    Then, you get something like this. (including the names of who made the change and the affected person).

          "propertyChanges": [
            {
              "property": "PRESENCE",
              "oldValues": [
                "Training"
              ],
              "newValues": [
                "On Queue"
              ]
            }
          ],​




  • 3.  RE: Force Agent On-Queue Audit Trail

    Posted 06-06-2022 08:45
    No replies, thread closed.
    Thanks Paulo. Which API can I use for this?

    ------------------------------
    Nichole Conway
    State of Missouri - Family Support Division
    ------------------------------



  • 4.  RE: Force Agent On-Queue Audit Trail

    Posted 06-06-2022 11:16
    No replies, thread closed.

    Hi Nichole,

    Use the Audit API to see the Presence changes during the defined window.  The /api/v2/audits/query is where you would start (Use a small interval sample window, and "serviceName" : "Presence" at minimum).  Take the transactionID from the initial API query and check it against the results in /api/v2/audits/query/{transactionId}/results.

    As Paulo pointed out, you can see the difference in a Presence change by the "user" section of the results.  A forced Presence change will include the "user" that forced the change:  Picture 1 is an agent changing their own presence, and the second image is the supervisor changing their state to OnQueue.



    Hope this helps!



    ------------------------------
    James Riley
    CX Consultant/Genesys Practice Lead
    Aspen Technology Group, Inc.
    ------------------------------



  • 5.  RE: Force Agent On-Queue Audit Trail

    Posted 06-06-2022 13:04
    No replies, thread closed.
    Thank you, this has been incredibly helpful!  do you now if timezone plays into the API results at all?  I ask because my user report says the agents status was changed at 11:46 am but when I run the API's for timestamp 11:47-11:47 she doesn't come up in my results at all though other agents do.  ​

    ------------------------------
    Nichole Conway
    State of Missouri - Family Support Division
    ------------------------------



  • 6.  RE: Force Agent On-Queue Audit Trail

    Posted 06-06-2022 13:14
    No replies, thread closed.
    All times are UTC in the API...  so for Central Time the below would be 06/05/2022 07:00 through 06/05/2022 17:00

    "interval": "2022-06-05T13:00:00Z/2022-06-05T23:00:00Z",

    ------------------------------
    James Riley
    CX Consultant/Genesys Practice Lead
    Aspen Technology Group, Inc.
    ------------------------------



  • 7.  RE: Force Agent On-Queue Audit Trail

    Posted 06-06-2022 15:25
    No replies, thread closed.
    Thank you so much!  That worked!  I was able to get the id of the supervisor who changed the status and get the name of that supervisor from the User API.  ​

    ------------------------------
    Nichole Conway
    State of Missouri - Family Support Division
    ------------------------------



  • 8.  RE: Force Agent On-Queue Audit Trail

    Posted 06-06-2022 16:52
    No replies, thread closed.
    On the second API call you can expand on the "user" value to get the name in the output as well, to save you that last query.


    ------------------------------
    James Riley
    CX Consultant/Genesys Practice Lead
    Aspen Technology Group, Inc.
    jriley@itsaspen.com
    ------------------------------