StartCampaignRequest

{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "$id": "#/components/schemas/StartCampaignRequest",
  "title": "StartCampaignRequest",
  "required": [
    "id",
    "vendorVersion",
    "campaignType",
    "dialingRate",
    "entryPointId",
    "dialingListFetchURL",
    "outdialANI",
    "recordCount"
  ],
  "type": "object",
  "properties": {
    "id": {
      "type": "string",
      "description": "The id represents the unique id with which the Campaign Request will be started, maximum length 64 characters.",
      "example": "SalesCampaign_Prog"
    },
    "vendorVersion": {
      "type": "string",
      "description": "Vendor specific information, maximum length 32 characters.",
      "example": "myCampaignManager"
    },
    "campaignType": {
      "type": "string",
      "description": "Type of campaign and campaignType should be one of \"progressive\", \"campaign\", \"predictive\", \"progressive_ivr\", \"predictive_ivr\" , \"preview_standard\", \"preview_direct\" ",
      "example": "Progressive"
    },
    "campaignName": {
      "type": "string",
      "description": "(Optional) Used if different than id, maximum length 64 characters.",
      "example": "campaign1"
    },
    "authToken": {
      "type": "string",
      "description": "(Not in use) The token needed by the dialer for querying records.",
      "example": "Bearer <AuthToken>"
    },
    "dialingRate": {
      "type": "number",
      "format": "float",
      "description": "Number of contacts to be dialed out per available Agent. For Progressive 1:1 Dialer, it will support for only 1 contact and for Progressive 1:N Dialer it can support upto 10 contacts to be dialed out per available Agent",
      "example": 1
    },
    "entryPointId": {
      "type": "string",
      "description": "Webex Contact Center outdial entry point, maximum length 36 characters.",
      "example": "510d198d-7aa7-4b75-a5ff-e61759f4f313"
    },
    "dialingListFetchURL": {
      "type": "string",
      "description": "URL the dialer will use to fetch the list of contacts to dial for the campaign from campaign manager, maximum length 1024 characters.",
      "example": "campaignMgr/v1/<campaignId>/dialinglist/"
    },
    "outdialANI": {
      "type": "string",
      "description": "The ANI (E164)  that will be presented to the customer. These must be restricted to the configured outdial Eps in Webex Contact Center, maximum length 50 characters.",
      "example": "9784330011"
    },
    "recordCount": {
      "type": "integer",
      "description": "Value to indicate the recordCount the Campaign Manager expects the dialer to be able to request, the maximum is 400. If the value is greater than 400 it will be set to the maximum when the request is processed.",
      "example": 50
    },
    "noAnswerRingLimit": {
      "type": "integer",
      "description": "(Optional) Number of seconds before a dialed call from the dialer is considered not answered, The range is from 16 to 80, default is 32. This field is not applicable for Direct preview campaigns.",
      "example": 32
    },
    "maxDialingRate": {
      "type": "number",
      "format": "float",
      "description": "Caps the maximum dialing rate per agent at this value. The range is from 1.0 to 10.0 , default is 1.0.",
      "example": 10
    },
    "abandonRatePercentage": {
      "type": "number",
      "format": "float",
      "description": "The percentage of calls that are allowed to be abandoned. The range is from 1.0 to 100.0 with a granularity of 0.1. The Default is 3.0",
      "example": 3
    },
    "predictiveCorrectionPace": {
      "type": "integer",
      "description": "A count of the number of live voice connections that must occur before the dialer adjusts. Increasing this number results in less frequent adjustments based on a larger sample size. The range is from 10 to 5000 , default is 70.",
      "example": 70
    },
    "predictiveGain": {
      "type": "number",
      "format": "float",
      "description": "The size of the adjustment to lines per agent each time an adjustment is made. Increasing this number results in larger per-agent adjustments. The range is 0.1 to 3.0 , default is 1.0.",
      "example": 2
    },
    "reservationPercentage": {
      "type": "integer",
      "description": "(Not in use) The percentage of agents to reserve within the queue associated with the campaign. The range is from 0 to 100 , default is 100",
      "example": 50
    },
    "callProgressAnalysisParams": {
      "$ref": "#/components/schemas/CallProgressAnalysisParamsRequest"
    },
    "ivrPorts": {
      "type": "integer",
      "description": "The number of IVR ports to use for this campaign. IVR ports are in use when calling a customer until the call is either ended or transferred to an agent. One IVR port can be considered equivalent to an agent in an agent based campaign.The range is from 1 to 1000.",
      "example": 10
    },
    "previewOfferTimeout": {
      "type": "integer",
      "description": "(Required if previewOfferTimeoutAutoAction is provided, optional otherwise) The number of seconds dialer waits for an agent to act on a preview campaign record, before performing the provided previewOfferTimeoutAutoAction. The range is from 0 to 7200(2 hours) for ACCEPT auto-action and 10 to 7200(2 hours) for other auto-actions. The default is 600(10 minutes).",
      "example": 300
    },
    "previewOfferTimeoutAutoAction": {
      "type": "string",
      "description": "(Required if previewOfferTimeout is provided, optional otherwise) The automatic action to be performed after the previewOfferTimeout duration has elapsed, if agent takes no action on the preview campaign record offered. Should be one of \"ACCEPT\", \"SKIP\", \"REMOVE\". The default is \"SKIP\".",
      "example": "ACCEPT"
    },
    "previewActionsDisabled": {
      "type": "array",
      "items": {
        "type": "string"
      },
      "description": "(Optional) The list of preview actions to be disabled for the agent when a preview campaign record is offered. Can be empty if no action should be disabled, otherwise should be one of \"SKIP\", \"REMOVE\" or both. The default is an empty list",
      "example": "[\"SKIP\", \"REMOVE\"]"
    }
  }
}