ConnectCampaignService / Client / create_campaign

create_campaign#

ConnectCampaignService.Client.create_campaign(**kwargs)#

Creates a campaign for the specified Amazon Connect account. This API is idempotent.

See also: AWS API Documentation

Request Syntax

response = client.create_campaign(
    name='string',
    connectInstanceId='string',
    dialerConfig={
        'progressiveDialerConfig': {
            'bandwidthAllocation': 123.0,
            'dialingCapacity': 123.0
        },
        'predictiveDialerConfig': {
            'bandwidthAllocation': 123.0,
            'dialingCapacity': 123.0
        },
        'agentlessDialerConfig': {
            'dialingCapacity': 123.0
        }
    },
    outboundCallConfig={
        'connectContactFlowId': 'string',
        'connectSourcePhoneNumber': 'string',
        'connectQueueId': 'string',
        'answerMachineDetectionConfig': {
            'enableAnswerMachineDetection': True|False,
            'awaitAnswerMachinePrompt': True|False
        }
    },
    tags={
        'string': 'string'
    }
)
Parameters:
  • name (string) –

    [REQUIRED]

    The name of an Amazon Connect Campaign name.

  • connectInstanceId (string) –

    [REQUIRED]

    Amazon Connect Instance Id

  • dialerConfig (dict) –

    [REQUIRED]

    The possible types of dialer config parameters

    Note

    This is a Tagged Union structure. Only one of the following top level keys can be set: progressiveDialerConfig, predictiveDialerConfig, agentlessDialerConfig.

    • progressiveDialerConfig (dict) –

      Progressive Dialer config

      • bandwidthAllocation (float) – [REQUIRED]

        The bandwidth allocation of a queue resource.

      • dialingCapacity (float) –

        Allocates dialing capacity for this campaign between multiple active campaigns

    • predictiveDialerConfig (dict) –

      Predictive Dialer config

      • bandwidthAllocation (float) – [REQUIRED]

        The bandwidth allocation of a queue resource.

      • dialingCapacity (float) –

        Allocates dialing capacity for this campaign between multiple active campaigns

    • agentlessDialerConfig (dict) –

      Agentless Dialer config

      • dialingCapacity (float) –

        Allocates dialing capacity for this campaign between multiple active campaigns

  • outboundCallConfig (dict) –

    [REQUIRED]

    The configuration used for outbound calls.

    • connectContactFlowId (string) – [REQUIRED]

      The identifier of the contact flow for the outbound call.

    • connectSourcePhoneNumber (string) –

      The phone number associated with the Amazon Connect instance, in E.164 format. If you do not specify a source phone number, you must specify a queue.

    • connectQueueId (string) –

      The queue for the call. If you specify a queue, the phone displayed for caller ID is the phone number specified in the queue. If you do not specify a queue, the queue defined in the contact flow is used. If you do not specify a queue, you must specify a source phone number.

    • answerMachineDetectionConfig (dict) –

      Answering Machine Detection config

      • enableAnswerMachineDetection (boolean) – [REQUIRED]

        Enable or disable answering machine detection

      • awaitAnswerMachinePrompt (boolean) –

        Enable or disable await answer machine prompt

  • tags (dict) –

    Tag map with key and value.

    • (string) –

      Tag key.

      • (string) –

        Tag value.

Return type:

dict

Returns:

Response Syntax

{
    'id': 'string',
    'arn': 'string',
    'tags': {
        'string': 'string'
    }
}

Response Structure

  • (dict) –

    The response for Create Campaign API

    • id (string) –

      Identifier representing a Campaign

    • arn (string) –

      The resource name of an Amazon Connect campaign.

    • tags (dict) –

      Tag map with key and value.

      • (string) –

        Tag key.

        • (string) –

          Tag value.

Exceptions

  • ConnectCampaignService.Client.exceptions.InternalServerException

  • ConnectCampaignService.Client.exceptions.ResourceNotFoundException

  • ConnectCampaignService.Client.exceptions.ValidationException

  • ConnectCampaignService.Client.exceptions.ConflictException

  • ConnectCampaignService.Client.exceptions.AccessDeniedException

  • ConnectCampaignService.Client.exceptions.ServiceQuotaExceededException

  • ConnectCampaignService.Client.exceptions.ThrottlingException