API to create a forecast with imported data

[Richard_Chandler]

I am looking to generate a forecast on imported source data but using the API rather than the Genesys Cloud UI. Checking the network log I can see POST /api/v2/workforcemanagement/businessunits/{businessUnitId}/weeks/{weekDateId}/shorttermforecasts Is used with the normal /generate addition to create a short term forecast that you can import data to along with POST https://apps.euw2.pure.cloud/platform/api/v2/workforcemanagement/businessunits/{businessUnitId}/weeks/{weekdateId}/shorttermforecasts/{forecastId}
/sourcedata to add the source data. I cannot seem to find these documented in the public API but have been able to call them but not complete a forecast. Any information appreciated.

[brian.trezise]

There was recently a similar question regarding importing schedules, which I'll link for more information:

Creating schedules in WFM

Hello We have a question : we are trying to import (Create a new) schedule in WFM, using the following API https://developer.genesys.cloud/useragentman/workforcemanagement/upload-import-new-schedule. When testing we used : this as a reference. The result is that the schedule IS created but it is empty. So all of the parameters are not registered and I assume that the query is ok since it passes the api post. we also checked here for a refernce but it is not that related. Therefore here …

The process is identical with the exception of the specific routes involved.

You would call this route first:
POST /api/v2/workforcemanagement/businessunits/{businessUnitId}/weeks/{weekDateId}/shorttermforecasts/import/uploadurl

PUT your data to the returned signed S3 url, then call this route to start the forecast import process by calling this route:
POST /api/v2/workforcemanagement/businessunits/{businessUnitId}/weeks/{weekDateId}/shorttermforecasts/import

These routes are brand new (there was an old way to do this but it was deprecated when we released these routes).

Hope that helps!

[Richard_Chandler]

Thanks Brian,

Unfortunately that is close but not exactly what I need to do I don't want to import a forecast at that point. I need to create a forecast and import source data as shown in the example below. I believe the API you referenced is for the bottom option in the UI.

[brian.trezise]

Apologies, I misread what you wanted. I'll look into it more and someone will get back to you.

[Danny.Chapdelaine]

Hi Richard,

My name is Danny, and I am the product manager of Forecasting in Genesys Cloud. Could you please elaborate on why you are trying to create WHI forecasts through an API call?

We have an API for our Historical Data Import (HDI) you could leverage and then create an ABM forecast using the data from the import.

Thanks,

[Richard_Chandler]

Hi Danny,
The customer in this case is using ServiceNow for digital channels and Genesys Cloud for Voice. An idea I had was if I created holding queues assigned to users and planning groups and exported performance data from ServiceNow this could be used to create a forecast based on that data. This would be merged with an AI forecast for everything else to enable a schedule to cope with both platforms.

[Danny.Chapdelaine]

Hi Richard,

You could use our Historical Data Import (HDI) via the front end or API; here is a link to information on the API Historical data import overview - Genesys Cloud Resource Center. However, a caveat currently with HDI may impact your approach.

You can only upload one file at a time per organization. Any newly uploaded file replaces a previously uploaded file. We are aware of this limitation, and we have plans to improve it.

You can find more info here on HDI
Historical data import overview - Genesys Cloud Resource Center.

If you would like to submit any ideas to improve HDI please follow this link. https://genesyscloud.ideas.aha.io/ideas

Thanks,
Danny