Use this API to create an outbound campaign within your CloudAgent account.
In the BODY PARAMS provide the parameters that apply to create the campaign.
For domestic ccaas - enter the domain: api.cloudagent.ozonetel.com
For International ccaas - enter the domain: ccaas.ozonetel.com
Note:Please consider the following points while using the campaign handling APIs.
- You cannot use Null or empty values for non-mandatory parameters. If those parameters are not required, do not add them to the BODY PARAMS.
 - "position" parameter is not applicable in the Payload.
 - When Fallback is not given in the payload, campaign will be created with Fallback as None.
 - We cannot update campaigns in Running Position.
 - File to Upload is mandatory for ccaas customers, but we will be able to create campaigns with API without Data File.
 - Mapping File Creation is not handled.
 - As of now, Advanced Retry Page is not Handled with the APIs.
 - You cannot update Campaign Name, as update is done based on Campaign Name as Primary value.
 - Actions like Start, Stop, Reset, Force Stop and Delete data are not handled.
 - Rate Limit to create a campaign: 2 request per minute per user, irrespective of the campaign type (Inbound Or Outbound).
 
Parameter (newKey)  | Description (New value)  | 
|---|---|
username*  | Provide the CloudAgnet account name  | 
campaignName*  | Give a name for the campaign to be created  | 
apiKey*  | Provide the API key of your account. Available in CloudAgent after admin login  | 
action*  | To create a campaign - "create"  | 
campaignType*  | "Preview" / "Progressive" / "IVR" / "Predictive"  | 
dialMethod*  | Specify if it's "Nonagentwise" / "Agentwise" / "Skillwise"  | 
did*  | Provide a DID for the campaign  | 
fallbackDID  | Add the fallback DID  | 
dynamicDID  | Add the dynamic DID number  | 
fallbackDynamicDID  | Add the fallback dynamic DID number  | 
runtimeStart*  | Give the start run time in the format HH:MM:SS. Example: 20:00:00  | 
runtimeEnd*  | Give the end run time in the format HH:MM:SS. Example: 23:00:00  | 
mappingName*  | Provide the Map file name  | 
pacingRatio*  | Add the pacing ratio value. Example: 1:2  | 
maxDropRatio*  | Enter the Max Drop Ratio (%) value in digits. Example: 30  | 
maxConcurrentCalls*  | The maximum number of active calls allowed for the campaign. Add the value in numerical  | 
appURL  | Use this parameter to customize the IVR flow through some other application. Enter the App URL if this parameter is used.  | 
noOfTries*  | Enter the number of tries value in digits. Example: 10  | 
priority*  | Give priority to the campaign.  | 
dialInterval*  | Give the dial interval time in seconds. Example: 5  | 
customerRingingTime*  | Give the customer ringing time in seconds. Example: 30  | 
users  | Add the list of users with comma-separated values. Example: user1,user2  | 
urlToPush  | Add the callback URL  | 
hitScreenpopURLAt  | Specify if it is at the "Client Side" / "Server Side" / "Client&Server" / "Client Side OnBusy" / "Plugin" / "Server Side OnBusy"  | 
screenPopUrl  | Give the screen pop URL  | 
pluginName*  | provide the plugin name  | 
callPrefix  | Add the call prefix as required. Example: "+"  | 
playDisclaimerURL  | Provide the audio URL as the parameter value in either .mp3 or .wav format. Note that this parameter is optional.  | 
dispositions*  | Provide the list of dispositions with comma-separated values.  | 
dispositionType*  | Specify the disposition type, whether through the API or toolbar or if no disposition is needed. "API" / "Toolbar" / "None"  | 
wrapUpTime*  | Give the wrap-up time in seconds. Example: 30  | 
blockNumber  | "Block" / "Allow" / "None"  | 
blockNumberGroups  | Provide the block number group name  | 
dailyObdLimitPerNumber  | Specify the numerical value to set the maximum daily outbound dialing attempts for a number within the campaign.  | 
record*  | "Record the call in Full" / "Record only the conversation" / "Do not record calls"  | 
holdMusic  | Audio_New  | 
transferMusic  | Music_new  | 
ivrFlow*  | Name of the IVR flow to be associated with the campaign.  | 
dndEnable  | Setting dndEnableto true activates the Do Not Disturb feature. When this checkbox is checked, the system will reference the Do Not Disturb log and prevent calls from being dialed.  | 
offLineMode  | "false" - providing false as a parameter disables the setting  | 
stdEnabled  | "true" - passing as true automatically dials the numbers with a prefixed 0 (zero) added before the 10-digit phone numbers available in the campaign list.  | 
acwForUnAnsweredCall  | "false" - providing false as a parameter disables the setting  | 
dialByHoldingAgent  | "true" - providing true as a parameter enables the setting.  | 
allowedManual  | "false" - providing false as a parameter disables the setting  | 
applyDNCRegulation  | "false" - providing false as a parameter disables the setting  | 
agentToAgentCalling  | "false" - providing 'false' as a parameter disables the setting. This is an agent-to-agent (internal calling) dialing feature. To know more about the Internal calling feature refer to, Agent to Agent Calling .  | 
skills*  | Provide the list of skill names with comma-separated values.  | 
script  | Add the script for the campaign as you need.  | 
amdDetection  | "false" - providing false as a parameter disables the setting  | 
customerFirst  | "false" - providing false as a parameter disables the setting  | 
amdDetected  | Play Voice Message  | 
voiceMessageURL  | provide the URL  | 
Possible Responses
Providing Valid Campaign Name  | "{  | 
Passing Invalid apiKey Key  | "{  | 
Passing Invalid apiKey Value  | "{  | 
Missing apiKey key / Missing apiKey value  | "{  | 
Passing Invalid userName Key / Missing userName key / Missing userName Value  | "{  | 
Passing Invalid userName Value  | "{  | 
Providing Empty / Null Campaign Name  | "{  | 
Providing Invalid Campaign Name  | {"Message": "Campaign Name should be between 2 to 255 alphanumeric characters long and allows special characters like .,@,_,-"}  | 
Providing Min and Max values to the Campaign Name parameter  | "{  | 
Not Providing Campaign Name Parameter  | "{  | 
Providing valid Campaign Type  | "{  | 
Providing invalid Campaign Type / Providing Empty Campaign Type / Not Providing Campaign Type Parameter  | "{  | 
Providing valid Dial method.  | "{  | 
Providing Invalid Dial Method / providing Empty Dial Method / Not Providing Dial Method Parameter  | "{  | 
Providing valid DID  | "{  | 
Providing Invalid DID / providing valid Fallback DID  | "{  | 
Providing Min and Max values to DID parameter  | "{  | 
Providing Empty DID  | "{  | 
Not Providing DID Parameter  | "{  | 
Providing Invalid Fallback DID  | "{  | 
Providing Empty Fallback WrapUp Time  | "{  | 
Providing Fallback DID when ROLE_Fallback_DID is not assigned and passing the fallBack DID value  | "{  | 
When ROLE_Fallback_DID is not assigned to the account and not passing the fallBack DID value  | "{  | 
Providing Valid Start Run Time  | "{  | 
Providing InValid Start Run Time / Providing Empty/ Null Start Run Time / Not Providing Start Run Time Parameter  | "{  | 
Providing Valid End Run Time  | "{  | 
Providing InValid End Run Time / Providing Empty/ Null End Run Time / Not Providing End Run Time Parameter  | "{  | 
Providing Start Run Time Greater than End Run Time  | "{  | 
Providing Invalid Dial Interval  | "{  | 
Providing Empty/ Null Dial Interval  | "{  | 
Not providing Dial Interval Parameter  | "{  | 
Providing Invalid Priority / Providing Empty Or Null Priority / Not Providing Priority Parameter  | "{  | 
Providing Min and Max values to the Priority Parameter  | "{  | 
When no Role_CAMP_Priority is assigned but passing priority value in parameters.  | "{  | 
Providing InValid "URL To Push" / Providing Empty/ Null "URL To Push" / Not providing "URL To Push" Parameter  | "{  | 
Providing Invalid "Hit ScreenPop URl At" / Providing Empty/ Null "Hit ScreenPop URl At"  | "{  | 
Not providing "Hit ScreenPop URl At" Parameter  | "{  | 
Providing valid "Hit ScreenPop URl At" as Plugin and not passing Plugin Name  | "{  | 
Providing valid "Hit ScreenPop URl At" as Plugin and passing Valid Plugin Name which is in account. (Zoho/idesk)  | "{  | 
Providing valid "ScreenPop URL" / Providing invalid "ScreenPop URL" / Providing Empty/ Null "ScreenPop URL"  | "{  | 
Providing Invalid Prefix  | "{  | 
Providing Min and Max values to the Prefix Parameter  | "{  | 
Providing Empty/ Null Prefix  | "{  | 
Not providing Prefix Parameter  | "{  | 
When no Role_Prefix is assigned and passing prefix key and value.  | "{  | 
Providing Invalid No.Of.Tries / Providing Empty/ Null No.Of.Tries  | "{  | 
Not providing No.Of.Tries Parameter  | "{  | 
Providing Invalid Block Number / Providing Empty Block Number / Not Providing Block Number Parameter  | "{  | 
Providing valid Block Number as "None"  | "{  | 
Providing valid Block Number as "Block" and passing valid Blocknumber Group.  | "{  | 
Providing valid Block Number as "Block" and passing Invalid Blocknumber Group.  | "{  | 
Providing valid Block Number as "Block" and not passing Blocknumber Group.  | "{  | 
Providing valid Block Number as "Allow" and passing valid Blocknumber Group.  | "{  | 
Providing valid Block Number as "Allow" and passing Invalid Blocknumber Group.  | "{  | 
Providing valid Block Number as "Allow" and without passing Blocknumber Group.  | "{  | 
Providing Invalid Record / Providing Empty Record / Not Providing Record Parameter  | "{  | 
Providing Empty / Null Customer Ringing Time  | "{  | 
Providing Invalid Customer Ringing Time  | "{  | 
Providing Min and Max values to the Customer Ringing Time parameter  | "{  | 
Not Providing Customer Ringing Time Parameter  | "{  | 
Providing invalid Dispostion Type / Providing Empty Dispostion Type / Not Providing Dispostion Type Parameter  | "{  | 
Providing valid Disposition  | "{  | 
Providing invalid Disposition / Providing Empty Disposition / Not Providing Disposition Parameter  | "{  | 
Providing Multi level Dispostions  | "{  | 
Providing valid WrapUpTime  | "{  | 
Providing Invalid WrapUp Time  | "{  | 
Providing acceptable values to WrapUp Time parameter  | "{  | 
Providing Empty WrapUp Time / Not Providing WrapUp Time Parameter  | "{  | 
Providing valid User Assigned  | "{  | 
Providing invalid User Assigned / Providing Empty User Assigned  | "{  | 
Not Providing User Assigned Parameter  | "{  | 
Providing valid Mapping Name  | "{  | 
Providing Invalid Mapping Name / Providing Empty Mapping Name / Not Providing Mapping Name Parameter  | "{  | 
Providing valid Music File - On Hold  | "{  | 
Providing Invalid Music File - On Hold  | "{  | 
Providing Empty/Null Music File - On Hold  | "{  | 
Not Providing Music File - On Hold  | "{  | 
Providing valid Music File - On Transfer  | "{  | 
Providing Invalid Music File - On Transfer  | "{  | 
Providing Empty/Null Music File - On Transfer  | "{  | 
Not Providing Music File - On Transfer  | "{  | 
Enabling AMD when "Dial Customer First " is enabled  | "{  | 
Enabling AMD when "Dial Customer First " is not enabled  | "{  | 
Providing AMD when no ROLE_AMD is not assigned  | "{  | 
Providing AMD when no ROLE_AMD is not assigned and not passing parameters  | "{  | 
Providing invalid AMD Type  | "{  | 
Providing "voice Message URL*" and AMD Type as "Play Voice Message"  | "{  | 
Not Providing "voice Message URL*" and providingAMD Type as "Play Voice Message"  | "{  | 
Providing "voice Message URL*" and providing AMD Type as other than "Play Voice Message"  | "{  | 
Creating campaign when ROLE_DND_Check is not assigned  | "{  | 
DND Check=True when ROLE_DND_Check is not assigned  | "{  | 
DND Check=False when ROLE_DND_Check is not assigned  | "{  | 
Providing True to all the check Boxes  | "{  | 
Providing False to all the check Boxes  | "{  | 
Providing Dial Customer First=True,  | "{  | 
Providing Dial Customer First=True,  | "{  | 
Providing Dial By Holding Agent=True,  | "{  | 
Providing Dial By Holding Agent=True,  | "{  | 
Providing ACW for UnAnswered Calls=True,  | "{  | 
Providing ACW for UnAnswered Calls=True, Dial By Holding Agent=True  | "{  | 
Providing valid "Daily Outbound Limit Per Number"  | "{  | 
Providing Invalid "Daily Outbound Limit Per Number"  | "{  | 
Providing acceptable values to "Daily Outbound Limit Per Number" parameter  | "{  | 
Providing Empty "Daily Outbound Limit Per Number"  | "{  | 
Not Providing "Daily Outbound Limit Per Number" Parameter  | "{  | 
Providing valid "Daily Outbound Limit Per Number" when ROLE_Outbound_Restriction is not assigned  | "{  | 
Providing "Daily Outbound Limit Per Number" when ROLE_Outbound_Restriction is not assigned  | "{  | 
Providing Invalid "Daily Outbound Limit Per Number" when Setting "Outbound Dialing rule On" as None.  | "{  | 
Providing valid "Daily Outbound Limit Per Number" when Setting "Outbound Dialing rule On" as None.  | "{  | 
Providing "Apply DNC Regulation"  | "{  | 
Providing "Apply DNC Regulation" and Run Time  | "{  | 
Creating Duplicate campaign  | "{  | 
Creating Campaign w.r.t Role Based Checks  | "{  | 
Updating play disclaimer when the campaign is in Running State.  | "{  | 
