Genesys Cloud - Main

 View Only

Sign Up

  • 1.  API data pull -- what's the best function to call to replicate the Interactions report?

    Posted yesterday

            Hey!

            I currently pull data from Genesys via the Interactions report, having it sent via email attachment and consuming it on the far end.  But I'd like to convert that to an API call.  

            I've worked out all the automation to make an API call from my target destination, but I don't know which API Operation to use to get that basic call-history set of data to start off the process.  There isn't operations labeled "Interactions" or "calls".  I see "conversations" but that seems too broad.

            For someone that has done this before, how much assembly after the call am I going to have to do?  Pulling the complete report is awfully nice via the report scheduler.  How difficult is it for me to get a basic call list, Date, Direction, Duration, ANI, Conversation ID, Caller ID, IVR time, from API calls?

            I will very much appreciate anyone that can point me in the right direction.  Getting Azure to play nice doing this stuff was a bugger.  I'm hoping Genesys offers the basics relatively simply.

                                 J.


    #API/Integrations

    ------------------------------
    John Edwards
    ------------------------------


  • 2.  RE: API data pull -- what's the best function to call to replicate the Interactions report?
    Best Answer

    Posted 23 hours ago

    Hello John,

    If you have not done so already, I would highly recommend taking a look at our API Explorer. There are a ton of API endpoints that you can use on there but you may want to check out these two

    https://developer.genesys.cloud/devapps/api-explorer-standalone#post-api-v2-analytics-conversations-details-query

    https://developer.genesys.cloud/devapps/api-explorer-standalone#post-api-v2-analytics-conversations-details-jobs

    I would start with the Analytics Query Builder in the API Explorer. This lets you build queries without code and generates the JSON structure for you to use. An example may start with the following, looking for the past day of conversations


    {
      "interval": "2026-08-17T00:00:00.000Z/2026-08-18T00:00:00.000Z",
      "order": "desc",
      "orderBy": "conversationStart",
      "paging": {
        "pageSize": 100,
        "pageNumber": 1
      }
    }

    Then, you could add a filter to check for voice calls

    "segmentFilters": [
      {
        "type": "and",
        "predicates": [
          { "dimension": "mediaType", "value": "voice" }
        ]
      }
    ]

    Once you have the response, you should be able to find most of the information under Conversation > Participants > Sessions > Segments. This should have your phone numbers (ANI/DNIS), durations, etc. that you can parse out of the JSON response.



    ------------------------------
    Jason Kleitz
    Online Community Manager/Moderator
    ------------------------------



  • 3.  RE: API data pull -- what's the best function to call to replicate the Interactions report?

    Posted an hour ago

    Thank you for tuning me in!  I'll go after those and see if I can get them to give up what I'm looking for.

    This is via an https call, but I've been able to pass arguments easily enough for my concept-of-operations work.  Let's see if I can get Azure Synapse pipelines to provide the proper format for the more complicated stuff.

    The API Explorer is not exactly overwhelmed by practical examples of usage.  I've had to go through a fair amount of trial and error simply because there isn't concrete examples showing how to do what I'm looking to do.  The doc could use a little more plushing up.



    ------------------------------
    John Edwards
    ------------------------------

    Original Message