Genesys Cloud - Developer Community!

 View Only

Sign Up

  • 1.  Recording API batchrequest job

    Posted 4 days ago

    Hello Community!

    I'm creating an application to download recordings from the cloud, using API and dotnet.
    I'm doing it by retrieving the conversations for dates range and then by posting a list of conversationIds in recording batch request.

    I'm getting job id and then checking periodically for the status of the job I'm waiting for the job to complete.

    Then just getting the results, downloading files and it' done.

    The questions are:

    1. Is there any possibility to get all the jobs currently registered?
    2. What is the time of life of such job?

    Thanks!


    #PlatformAPI

    ------------------------------
    Igor Zagańczyk
    Service Engineer
    ------------------------------


  • 2.  RE: Recording API batchrequest job

    Posted 3 days ago

    Hi @Igor Zagańczyk

    Sharing some information that may help clarify the topic, and others can complement or adjust if needed.

    To retrieve the currently registered recording bulk jobs, you can use the endpoint:

    GET /api/v2/recording/jobs

    This endpoint allows retrieving the recording bulk jobs available in the organization. You can also filter the results to return only the jobs you executed, using the appropriate query parameters (for example, limiting to jobs created by the current user).

    Regarding job lifetime, the documentation references the setting "Recording Batch Download URL Time-to-live," which defines how long the generated download URLs remain valid (between 2 and 60 minutes, with 60 minutes as default).

    API reference:
    https://developer.genesys.cloud/analyticsdatamanagement/recording/recordings-downloader

    Admin setting reference:
    https://help.mypurecloud.com/articles/configure-recording-settings/



    ------------------------------
    Luiz Rosa
    Full stack developer
    ------------------------------



  • 3.  RE: Recording API batchrequest job

    Posted yesterday

    Hi @Luiz Rosa,
    Thank you for your response.

    Sorry for not including details. The key is the 'batch request' I use.

    I get the list of conversations using /api/v2/analytics/conversations/details/query providing the interval parameter.

    Next, I register a job by posting conversationIds to /api/v2/recording/batchrequests. This request returns the job id.

    Problem is I can't find any endpoint to retrieve the list of such jobs. api/v2/recording/jobs does not return these.

    Thank you.



    ------------------------------
    Igor Zagańczyk
    Service Engineer
    ------------------------------



  • 4.  RE: Recording API batchrequest job

    Posted yesterday
    Here we developed the same application concept, using it both for external export and for the bucket.

    About the AWS S3 recording bulk actions integration View summary - Genesys Cloud Resource Center

     

    Criar Job de Exportação

    POST /api/v2/Recording/jobs

     

      "action": "EXPORT",

      "actionDate": "2021-08-23T12:00:00Z",

      "includeScreenRecordings": true,

      "integrationId": "<ID_da_integração_S3>",

      "order": "asc",

      "orderBy": "conversationStart",

      "conversationQuery": {

        "interval": "2021-08-23T12:00:00.000Z/2021-08-24T12:00:00.000Z",

        "conversationFilters": [

          {

            "type": "or",

            "predicates": [

              {

                "type": "dimension",

                "dimension": "conversationEnd",

                "operator": "exists"

              }

            ]

          }

        ]

      }

    }

    Consultar Status do Job

    GET /api/v2/Recording/Jobs/{jobId}

     

    Iniciar o Processamento do Job

    PUT /api/v2/Recording/Jobs/{jobId}

    payload 

    {

      "state": "PROCESSING"

    }



    ------------------------------
    Victor Soares
    Gerente técnico
    ------------------------------