2024/11/15 - AmazonConnectCampaignServiceV2 - 32 new api methods
Changes Added Amazon Connect Outbound Campaigns V2 SDK.
Untag a resource.
See also: AWS API Documentation
Request Syntax
client.untag_resource( arn='string', tagKeys=[ 'string', ] )
string
[REQUIRED]
Amazon Resource Names(ARN)
list
[REQUIRED]
List of tag keys.
(string) --
The key of tag.
None
Get the specific instance onboarding job status.
See also: AWS API Documentation
Request Syntax
client.get_instance_onboarding_job_status( connectInstanceId='string' )
string
[REQUIRED]
Amazon Connect Instance Id
dict
Response Syntax
{ 'connectInstanceOnboardingJobStatus': { 'connectInstanceId': 'string', 'status': 'IN_PROGRESS'|'SUCCEEDED'|'FAILED', 'failureCode': 'EVENT_BRIDGE_ACCESS_DENIED'|'EVENT_BRIDGE_MANAGED_RULE_LIMIT_EXCEEDED'|'IAM_ACCESS_DENIED'|'KMS_ACCESS_DENIED'|'KMS_KEY_NOT_FOUND'|'INTERNAL_FAILURE' } }
Response Structure
(dict) --
The response for GetInstanceOnboardingJobStatus API.
connectInstanceOnboardingJobStatus (dict) --
Instance onboarding job status object
connectInstanceId (string) --
Amazon Connect Instance Id
status (string) --
Enumeration of the possible states for instance onboarding job
failureCode (string) --
Enumeration of the possible failure codes for instance onboarding job
Updates the campaign flow associated with a campaign. This API is idempotent.
See also: AWS API Documentation
Request Syntax
client.update_campaign_flow_association( id='string', connectCampaignFlowArn='string' )
string
[REQUIRED]
Identifier representing a Campaign
string
[REQUIRED]
Amazon Resource Names(ARN)
None
List tags for a resource.
See also: AWS API Documentation
Request Syntax
client.list_tags_for_resource( arn='string' )
string
[REQUIRED]
Amazon Resource Names(ARN)
dict
Response Syntax
{ 'tags': { 'string': 'string' } }
Response Structure
(dict) --
The request for ListTagsForResource API.
tags (dict) --
Tag map with key and value.
(string) --
The key of tag.
(string) --
The value of tag.
Delete the integration for the specified Amazon Connect instance.
See also: AWS API Documentation
Request Syntax
client.delete_connect_instance_integration( connectInstanceId='string', integrationIdentifier={ 'customerProfiles': { 'domainArn': 'string' }, 'qConnect': { 'knowledgeBaseArn': 'string' } } )
string
[REQUIRED]
Amazon Connect Instance Id
dict
[REQUIRED]
Integration identifier for Connect instance
customerProfiles (dict) --
Customer Profiles integration identifier
domainArn (string) -- [REQUIRED]
Amazon Resource Names(ARN)
qConnect (dict) --
Q Connect integration identifier
knowledgeBaseArn (string) -- [REQUIRED]
Amazon Resource Names(ARN)
None
Stops a campaign for the specified Amazon Connect account.
See also: AWS API Documentation
Request Syntax
client.stop_campaign( id='string' )
string
[REQUIRED]
Identifier representing a Campaign
None
Deletes a connect instance config from the specified AWS account.
See also: AWS API Documentation
Request Syntax
client.delete_connect_instance_config( connectInstanceId='string', campaignDeletionPolicy='RETAIN_ALL'|'DELETE_ALL' )
string
[REQUIRED]
Amazon Connect Instance Id
string
Enumeration of the policies to enact on existing campaigns during instance config deletion
None
Deletes the communication time config for a campaign. This API is idempotent.
See also: AWS API Documentation
Request Syntax
client.delete_campaign_communication_time( id='string', config='TELEPHONY'|'SMS'|'EMAIL' )
string
[REQUIRED]
Identifier representing a Campaign
string
[REQUIRED]
The type of campaign communication time config
None
Deletes a campaign from the specified Amazon Connect account.
See also: AWS API Documentation
Request Syntax
client.delete_campaign( id='string' )
string
[REQUIRED]
Identifier representing a Campaign
None
Get the specific Connect instance config.
See also: AWS API Documentation
Request Syntax
client.get_connect_instance_config( connectInstanceId='string' )
string
[REQUIRED]
Amazon Connect Instance Id
dict
Response Syntax
{ 'connectInstanceConfig': { 'connectInstanceId': 'string', 'serviceLinkedRoleArn': 'string', 'encryptionConfig': { 'enabled': True|False, 'encryptionType': 'KMS', 'keyArn': 'string' } } }
Response Structure
(dict) --
The response for GetConnectInstanceConfig API.
connectInstanceConfig (dict) --
Instance config object
connectInstanceId (string) --
Amazon Connect Instance Id
serviceLinkedRoleArn (string) --
Service linked role arn
encryptionConfig (dict) --
Encryption config for Connect Instance. Note that sensitive data will always be encrypted. If disabled, service will perform encryption with its own key. If enabled, a KMS key id needs to be provided and KMS charges will apply. KMS is only type supported
enabled (boolean) --
Boolean to indicate if custom encryption has been enabled.
encryptionType (string) --
Server-side encryption type.
keyArn (string) --
KMS key id/arn for encryption config.
Get state of campaigns for the specified Amazon Connect account.
See also: AWS API Documentation
Request Syntax
client.get_campaign_state_batch( campaignIds=[ 'string', ] )
list
[REQUIRED]
List of CampaignId
(string) --
Identifier representing a Campaign
dict
Response Syntax
{ 'successfulRequests': [ { 'campaignId': 'string', 'state': 'Initialized'|'Running'|'Paused'|'Stopped'|'Failed'|'Completed' }, ], 'failedRequests': [ { 'campaignId': 'string', 'failureCode': 'ResourceNotFound'|'UnknownError' }, ] }
Response Structure
(dict) --
The response for GetCampaignStateBatch API.
successfulRequests (list) --
List of successful response of campaign state
(dict) --
Successful response of campaign state
campaignId (string) --
Identifier representing a Campaign
state (string) --
State of a campaign
failedRequests (list) --
List of failed requests of campaign state
(dict) --
Failed response of campaign state
campaignId (string) --
Identifier representing a Campaign
failureCode (string) --
A predefined code indicating the error that caused the failure in getting state of campaigns
Updates the communication limits config for a campaign. This API is idempotent.
See also: AWS API Documentation
Request Syntax
client.update_campaign_communication_limits( id='string', communicationLimitsOverride={ 'allChannelSubtypes': { 'communicationLimitsList': [ { 'maxCountPerRecipient': 123, 'frequency': 123, 'unit': 'DAY' }, ] } } )
string
[REQUIRED]
Identifier representing a Campaign
dict
[REQUIRED]
Communication limits config
allChannelSubtypes (dict) --
Communication limits
communicationLimitsList (list) --
List of communication limit
(dict) --
Communication Limit
maxCountPerRecipient (integer) -- [REQUIRED]
Maximum number of contacts allowed for a given target within the given frequency.
frequency (integer) -- [REQUIRED]
The number of days to consider with regards to this limit.
unit (string) -- [REQUIRED]
The communication limit time unit.
None
Updates the communication time config for a campaign. This API is idempotent.
See also: AWS API Documentation
Request Syntax
client.update_campaign_communication_time( id='string', communicationTimeConfig={ 'localTimeZoneConfig': { 'defaultTimeZone': 'string', 'localTimeZoneDetection': [ 'ZIP_CODE'|'AREA_CODE', ] }, 'telephony': { 'openHours': { 'dailyHours': { 'string': [ { 'startTime': 'string', 'endTime': 'string' }, ] } }, 'restrictedPeriods': { 'restrictedPeriodList': [ { 'name': 'string', 'startDate': 'string', 'endDate': 'string' }, ] } }, 'sms': { 'openHours': { 'dailyHours': { 'string': [ { 'startTime': 'string', 'endTime': 'string' }, ] } }, 'restrictedPeriods': { 'restrictedPeriodList': [ { 'name': 'string', 'startDate': 'string', 'endDate': 'string' }, ] } }, 'email': { 'openHours': { 'dailyHours': { 'string': [ { 'startTime': 'string', 'endTime': 'string' }, ] } }, 'restrictedPeriods': { 'restrictedPeriodList': [ { 'name': 'string', 'startDate': 'string', 'endDate': 'string' }, ] } } } )
string
[REQUIRED]
Identifier representing a Campaign
dict
[REQUIRED]
Campaign communication time config
localTimeZoneConfig (dict) -- [REQUIRED]
Local time zone config
defaultTimeZone (string) --
Time Zone Id in the IANA format
localTimeZoneDetection (list) --
Local TimeZone Detection method list
(string) --
Local TimeZone Detection method.
telephony (dict) --
Time window config
openHours (dict) -- [REQUIRED]
Open Hours config
dailyHours (dict) --
Daily Hours map
(string) --
Day of week enum
(list) --
List of time range
(dict) --
Time range in 24 hour format
startTime (string) -- [REQUIRED]
Time in ISO 8601 format, e.g. T23:11
endTime (string) -- [REQUIRED]
Time in ISO 8601 format, e.g. T23:11
restrictedPeriods (dict) --
Restricted period config
restrictedPeriodList (list) --
List of restricted period
(dict) --
Restricted period
name (string) --
The name of a restricted period.
startDate (string) -- [REQUIRED]
Date in ISO 8601 format, e.g. 2024-01-01
endDate (string) -- [REQUIRED]
Date in ISO 8601 format, e.g. 2024-01-01
sms (dict) --
Time window config
openHours (dict) -- [REQUIRED]
Open Hours config
dailyHours (dict) --
Daily Hours map
(string) --
Day of week enum
(list) --
List of time range
(dict) --
Time range in 24 hour format
startTime (string) -- [REQUIRED]
Time in ISO 8601 format, e.g. T23:11
endTime (string) -- [REQUIRED]
Time in ISO 8601 format, e.g. T23:11
restrictedPeriods (dict) --
Restricted period config
restrictedPeriodList (list) --
List of restricted period
(dict) --
Restricted period
name (string) --
The name of a restricted period.
startDate (string) -- [REQUIRED]
Date in ISO 8601 format, e.g. 2024-01-01
endDate (string) -- [REQUIRED]
Date in ISO 8601 format, e.g. 2024-01-01
email (dict) --
Time window config
openHours (dict) -- [REQUIRED]
Open Hours config
dailyHours (dict) --
Daily Hours map
(string) --
Day of week enum
(list) --
List of time range
(dict) --
Time range in 24 hour format
startTime (string) -- [REQUIRED]
Time in ISO 8601 format, e.g. T23:11
endTime (string) -- [REQUIRED]
Time in ISO 8601 format, e.g. T23:11
restrictedPeriods (dict) --
Restricted period config
restrictedPeriodList (list) --
List of restricted period
(dict) --
Restricted period
name (string) --
The name of a restricted period.
startDate (string) -- [REQUIRED]
Date in ISO 8601 format, e.g. 2024-01-01
endDate (string) -- [REQUIRED]
Date in ISO 8601 format, e.g. 2024-01-01
None
Starts a campaign for the specified Amazon Connect account.
See also: AWS API Documentation
Request Syntax
client.start_campaign( id='string' )
string
[REQUIRED]
Identifier representing a Campaign
None
Creates a campaign for the specified Amazon Connect account. This API is idempotent.
See also: AWS API Documentation
Request Syntax
client.create_campaign( name='string', connectInstanceId='string', channelSubtypeConfig={ 'telephony': { 'capacity': 123.0, 'connectQueueId': 'string', 'outboundMode': { 'progressive': { 'bandwidthAllocation': 123.0 }, 'predictive': { 'bandwidthAllocation': 123.0 }, 'agentless': {} }, 'defaultOutboundConfig': { 'connectContactFlowId': 'string', 'connectSourcePhoneNumber': 'string', 'answerMachineDetectionConfig': { 'enableAnswerMachineDetection': True|False, 'awaitAnswerMachinePrompt': True|False } } }, 'sms': { 'capacity': 123.0, 'outboundMode': { 'agentless': {} }, 'defaultOutboundConfig': { 'connectSourcePhoneNumberArn': 'string', 'wisdomTemplateArn': 'string' } }, 'email': { 'capacity': 123.0, 'outboundMode': { 'agentless': {} }, 'defaultOutboundConfig': { 'connectSourceEmailAddress': 'string', 'sourceEmailAddressDisplayName': 'string', 'wisdomTemplateArn': 'string' } } }, source={ 'customerProfilesSegmentArn': 'string' }, connectCampaignFlowArn='string', schedule={ 'startTime': datetime(2015, 1, 1), 'endTime': datetime(2015, 1, 1), 'refreshFrequency': 'string' }, communicationTimeConfig={ 'localTimeZoneConfig': { 'defaultTimeZone': 'string', 'localTimeZoneDetection': [ 'ZIP_CODE'|'AREA_CODE', ] }, 'telephony': { 'openHours': { 'dailyHours': { 'string': [ { 'startTime': 'string', 'endTime': 'string' }, ] } }, 'restrictedPeriods': { 'restrictedPeriodList': [ { 'name': 'string', 'startDate': 'string', 'endDate': 'string' }, ] } }, 'sms': { 'openHours': { 'dailyHours': { 'string': [ { 'startTime': 'string', 'endTime': 'string' }, ] } }, 'restrictedPeriods': { 'restrictedPeriodList': [ { 'name': 'string', 'startDate': 'string', 'endDate': 'string' }, ] } }, 'email': { 'openHours': { 'dailyHours': { 'string': [ { 'startTime': 'string', 'endTime': 'string' }, ] } }, 'restrictedPeriods': { 'restrictedPeriodList': [ { 'name': 'string', 'startDate': 'string', 'endDate': 'string' }, ] } } }, communicationLimitsOverride={ 'allChannelSubtypes': { 'communicationLimitsList': [ { 'maxCountPerRecipient': 123, 'frequency': 123, 'unit': 'DAY' }, ] } }, tags={ 'string': 'string' } )
string
[REQUIRED]
The name of an Amazon Connect Campaign name.
string
[REQUIRED]
Amazon Connect Instance Id
dict
[REQUIRED]
Campaign Channel Subtype config
telephony (dict) --
Telephony Channel Subtype config
capacity (float) --
Allocates outbound capacity for the specific channel subtype of this campaign between multiple active campaigns
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.
outboundMode (dict) -- [REQUIRED]
Telephony Outbound Mode
progressive (dict) --
Progressive config
bandwidthAllocation (float) -- [REQUIRED]
The bandwidth allocation of a queue resource.
predictive (dict) --
Predictive config
bandwidthAllocation (float) -- [REQUIRED]
The bandwidth allocation of a queue resource.
agentless (dict) --
Agentless config
defaultOutboundConfig (dict) -- [REQUIRED]
Default Telephony Outbound config
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.
answerMachineDetectionConfig (dict) --
Answering Machine Detection config
enableAnswerMachineDetection (boolean) -- [REQUIRED]
Enable or disable answering machine detection
awaitAnswerMachinePrompt (boolean) --
Enable or disable await answer machine prompt
sms (dict) --
SMS Channel Subtype config
capacity (float) --
Allocates outbound capacity for the specific channel subtype of this campaign between multiple active campaigns
outboundMode (dict) -- [REQUIRED]
SMS Outbound Mode
agentless (dict) --
Agentless config
defaultOutboundConfig (dict) -- [REQUIRED]
Default SMS Outbound config
connectSourcePhoneNumberArn (string) -- [REQUIRED]
Amazon Resource Names(ARN)
wisdomTemplateArn (string) -- [REQUIRED]
Amazon Resource Names(ARN)
email (dict) --
Email Channel Subtype config
capacity (float) --
Allocates outbound capacity for the specific channel subtype of this campaign between multiple active campaigns
outboundMode (dict) -- [REQUIRED]
Email Outbound Mode
agentless (dict) --
Agentless config
defaultOutboundConfig (dict) -- [REQUIRED]
Default Email Outbound config
connectSourceEmailAddress (string) -- [REQUIRED]
Source/Destination Email address used for Email messages
sourceEmailAddressDisplayName (string) --
Display name for Email Address
wisdomTemplateArn (string) -- [REQUIRED]
Amazon Resource Names(ARN)
dict
Source of the campaign
customerProfilesSegmentArn (string) --
Amazon Resource Names(ARN)
string
Amazon Resource Names(ARN)
dict
Campaign schedule
startTime (datetime) -- [REQUIRED]
Timestamp with no UTC offset or timezone
endTime (datetime) -- [REQUIRED]
Timestamp with no UTC offset or timezone
refreshFrequency (string) --
Time duration in ISO 8601 format
dict
Campaign communication time config
localTimeZoneConfig (dict) -- [REQUIRED]
Local time zone config
defaultTimeZone (string) --
Time Zone Id in the IANA format
localTimeZoneDetection (list) --
Local TimeZone Detection method list
(string) --
Local TimeZone Detection method.
telephony (dict) --
Time window config
openHours (dict) -- [REQUIRED]
Open Hours config
dailyHours (dict) --
Daily Hours map
(string) --
Day of week enum
(list) --
List of time range
(dict) --
Time range in 24 hour format
startTime (string) -- [REQUIRED]
Time in ISO 8601 format, e.g. T23:11
endTime (string) -- [REQUIRED]
Time in ISO 8601 format, e.g. T23:11
restrictedPeriods (dict) --
Restricted period config
restrictedPeriodList (list) --
List of restricted period
(dict) --
Restricted period
name (string) --
The name of a restricted period.
startDate (string) -- [REQUIRED]
Date in ISO 8601 format, e.g. 2024-01-01
endDate (string) -- [REQUIRED]
Date in ISO 8601 format, e.g. 2024-01-01
sms (dict) --
Time window config
openHours (dict) -- [REQUIRED]
Open Hours config
dailyHours (dict) --
Daily Hours map
(string) --
Day of week enum
(list) --
List of time range
(dict) --
Time range in 24 hour format
startTime (string) -- [REQUIRED]
Time in ISO 8601 format, e.g. T23:11
endTime (string) -- [REQUIRED]
Time in ISO 8601 format, e.g. T23:11
restrictedPeriods (dict) --
Restricted period config
restrictedPeriodList (list) --
List of restricted period
(dict) --
Restricted period
name (string) --
The name of a restricted period.
startDate (string) -- [REQUIRED]
Date in ISO 8601 format, e.g. 2024-01-01
endDate (string) -- [REQUIRED]
Date in ISO 8601 format, e.g. 2024-01-01
email (dict) --
Time window config
openHours (dict) -- [REQUIRED]
Open Hours config
dailyHours (dict) --
Daily Hours map
(string) --
Day of week enum
(list) --
List of time range
(dict) --
Time range in 24 hour format
startTime (string) -- [REQUIRED]
Time in ISO 8601 format, e.g. T23:11
endTime (string) -- [REQUIRED]
Time in ISO 8601 format, e.g. T23:11
restrictedPeriods (dict) --
Restricted period config
restrictedPeriodList (list) --
List of restricted period
(dict) --
Restricted period
name (string) --
The name of a restricted period.
startDate (string) -- [REQUIRED]
Date in ISO 8601 format, e.g. 2024-01-01
endDate (string) -- [REQUIRED]
Date in ISO 8601 format, e.g. 2024-01-01
dict
Communication limits config
allChannelSubtypes (dict) --
Communication limits
communicationLimitsList (list) --
List of communication limit
(dict) --
Communication Limit
maxCountPerRecipient (integer) -- [REQUIRED]
Maximum number of contacts allowed for a given target within the given frequency.
frequency (integer) -- [REQUIRED]
The number of days to consider with regards to this limit.
unit (string) -- [REQUIRED]
The communication limit time unit.
dict
Tag map with key and value.
(string) --
The key of tag.
(string) --
The value of tag.
dict
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) --
The key of tag.
(string) --
The value of tag.
Deletes the communication limits config for a campaign. This API is idempotent.
See also: AWS API Documentation
Request Syntax
client.delete_campaign_communication_limits( id='string', config='ALL_CHANNEL_SUBTYPES' )
string
[REQUIRED]
Identifier representing a Campaign
string
[REQUIRED]
The type of campaign communication limits config.
None
Put or update the integration for the specified Amazon Connect instance.
See also: AWS API Documentation
Request Syntax
client.put_connect_instance_integration( connectInstanceId='string', integrationConfig={ 'customerProfiles': { 'domainArn': 'string', 'objectTypeNames': { 'string': 'string' } }, 'qConnect': { 'knowledgeBaseArn': 'string' } } )
string
[REQUIRED]
Amazon Connect Instance Id
dict
[REQUIRED]
Integration config for Connect Instance
customerProfiles (dict) --
Customer Profiles integration config
domainArn (string) -- [REQUIRED]
Amazon Resource Names(ARN)
objectTypeNames (dict) -- [REQUIRED]
Object type names map.
(string) --
Enumeration of Customer Profiles event type
(string) --
Object type name
qConnect (dict) --
Q Connect integration config
knowledgeBaseArn (string) -- [REQUIRED]
Amazon Resource Names(ARN)
None
Updates the name of a campaign. This API is idempotent.
See also: AWS API Documentation
Request Syntax
client.update_campaign_name( id='string', name='string' )
string
[REQUIRED]
Identifier representing a Campaign
string
[REQUIRED]
The name of an Amazon Connect Campaign name.
None
Provides summary information about the integration under the specified Connect instance.
See also: AWS API Documentation
Request Syntax
client.list_connect_instance_integrations( connectInstanceId='string', maxResults=123, nextToken='string' )
string
[REQUIRED]
Amazon Connect Instance Id
integer
The maximum number of results to return per page.
string
The token for the next set of results.
dict
Response Syntax
{ 'nextToken': 'string', 'integrationSummaryList': [ { 'customerProfiles': { 'domainArn': 'string', 'objectTypeNames': { 'string': 'string' } }, 'qConnect': { 'knowledgeBaseArn': 'string' } }, ] }
Response Structure
(dict) --
The response for ListConnectInstanceIntegrations API.
nextToken (string) --
The token for the next set of results.
integrationSummaryList (list) --
A list of Amazon Connect Instance Integrations.
(dict) --
Integration summary for Connect instance.
customerProfiles (dict) --
Customer Profiles integration summary
domainArn (string) --
Amazon Resource Names(ARN)
objectTypeNames (dict) --
Object type names map.
(string) --
Enumeration of Customer Profiles event type
(string) --
Object type name
qConnect (dict) --
Q Connect integration summary
knowledgeBaseArn (string) --
Amazon Resource Names(ARN)
Pauses a campaign for the specified Amazon Connect account.
See also: AWS API Documentation
Request Syntax
client.pause_campaign( id='string' )
string
[REQUIRED]
Identifier representing a Campaign
None
Tag a resource.
See also: AWS API Documentation
Request Syntax
client.tag_resource( arn='string', tags={ 'string': 'string' } )
string
[REQUIRED]
Amazon Resource Names(ARN)
dict
[REQUIRED]
Tag map with key and value.
(string) --
The key of tag.
(string) --
The value of tag.
None
Get state of a campaign for the specified Amazon Connect account.
See also: AWS API Documentation
Request Syntax
client.get_campaign_state( id='string' )
string
[REQUIRED]
Identifier representing a Campaign
dict
Response Syntax
{ 'state': 'Initialized'|'Running'|'Paused'|'Stopped'|'Failed'|'Completed' }
Response Structure
(dict) --
The response for GetCampaignState API.
state (string) --
State of a campaign
Deletes the channel subtype config of a campaign. This API is idempotent.
See also: AWS API Documentation
Request Syntax
client.delete_campaign_channel_subtype_config( id='string', channelSubtype='TELEPHONY'|'SMS'|'EMAIL' )
string
[REQUIRED]
Identifier representing a Campaign
string
[REQUIRED]
The type of campaign channel subtype.
None
Describes the specific campaign.
See also: AWS API Documentation
Request Syntax
client.describe_campaign( id='string' )
string
[REQUIRED]
Identifier representing a Campaign
dict
Response Syntax
{ 'campaign': { 'id': 'string', 'arn': 'string', 'name': 'string', 'connectInstanceId': 'string', 'channelSubtypeConfig': { 'telephony': { 'capacity': 123.0, 'connectQueueId': 'string', 'outboundMode': { 'progressive': { 'bandwidthAllocation': 123.0 }, 'predictive': { 'bandwidthAllocation': 123.0 }, 'agentless': {} }, 'defaultOutboundConfig': { 'connectContactFlowId': 'string', 'connectSourcePhoneNumber': 'string', 'answerMachineDetectionConfig': { 'enableAnswerMachineDetection': True|False, 'awaitAnswerMachinePrompt': True|False } } }, 'sms': { 'capacity': 123.0, 'outboundMode': { 'agentless': {} }, 'defaultOutboundConfig': { 'connectSourcePhoneNumberArn': 'string', 'wisdomTemplateArn': 'string' } }, 'email': { 'capacity': 123.0, 'outboundMode': { 'agentless': {} }, 'defaultOutboundConfig': { 'connectSourceEmailAddress': 'string', 'sourceEmailAddressDisplayName': 'string', 'wisdomTemplateArn': 'string' } } }, 'source': { 'customerProfilesSegmentArn': 'string' }, 'connectCampaignFlowArn': 'string', 'schedule': { 'startTime': datetime(2015, 1, 1), 'endTime': datetime(2015, 1, 1), 'refreshFrequency': 'string' }, 'communicationTimeConfig': { 'localTimeZoneConfig': { 'defaultTimeZone': 'string', 'localTimeZoneDetection': [ 'ZIP_CODE'|'AREA_CODE', ] }, 'telephony': { 'openHours': { 'dailyHours': { 'string': [ { 'startTime': 'string', 'endTime': 'string' }, ] } }, 'restrictedPeriods': { 'restrictedPeriodList': [ { 'name': 'string', 'startDate': 'string', 'endDate': 'string' }, ] } }, 'sms': { 'openHours': { 'dailyHours': { 'string': [ { 'startTime': 'string', 'endTime': 'string' }, ] } }, 'restrictedPeriods': { 'restrictedPeriodList': [ { 'name': 'string', 'startDate': 'string', 'endDate': 'string' }, ] } }, 'email': { 'openHours': { 'dailyHours': { 'string': [ { 'startTime': 'string', 'endTime': 'string' }, ] } }, 'restrictedPeriods': { 'restrictedPeriodList': [ { 'name': 'string', 'startDate': 'string', 'endDate': 'string' }, ] } } }, 'communicationLimitsOverride': { 'allChannelSubtypes': { 'communicationLimitsList': [ { 'maxCountPerRecipient': 123, 'frequency': 123, 'unit': 'DAY' }, ] } }, 'tags': { 'string': 'string' } } }
Response Structure
(dict) --
The response for DescribeCampaign API.
campaign (dict) --
An Amazon Connect campaign.
id (string) --
Identifier representing a Campaign
arn (string) --
The resource name of an Amazon Connect campaign.
name (string) --
The name of an Amazon Connect Campaign name.
connectInstanceId (string) --
Amazon Connect Instance Id
channelSubtypeConfig (dict) --
Campaign Channel Subtype config
telephony (dict) --
Telephony Channel Subtype config
capacity (float) --
Allocates outbound capacity for the specific channel subtype of this campaign between multiple active campaigns
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.
outboundMode (dict) --
Telephony Outbound Mode
progressive (dict) --
Progressive config
bandwidthAllocation (float) --
The bandwidth allocation of a queue resource.
predictive (dict) --
Predictive config
bandwidthAllocation (float) --
The bandwidth allocation of a queue resource.
agentless (dict) --
Agentless config
defaultOutboundConfig (dict) --
Default Telephony Outbound config
connectContactFlowId (string) --
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.
answerMachineDetectionConfig (dict) --
Answering Machine Detection config
enableAnswerMachineDetection (boolean) --
Enable or disable answering machine detection
awaitAnswerMachinePrompt (boolean) --
Enable or disable await answer machine prompt
sms (dict) --
SMS Channel Subtype config
capacity (float) --
Allocates outbound capacity for the specific channel subtype of this campaign between multiple active campaigns
outboundMode (dict) --
SMS Outbound Mode
agentless (dict) --
Agentless config
defaultOutboundConfig (dict) --
Default SMS Outbound config
connectSourcePhoneNumberArn (string) --
Amazon Resource Names(ARN)
wisdomTemplateArn (string) --
Amazon Resource Names(ARN)
email (dict) --
Email Channel Subtype config
capacity (float) --
Allocates outbound capacity for the specific channel subtype of this campaign between multiple active campaigns
outboundMode (dict) --
Email Outbound Mode
agentless (dict) --
Agentless config
defaultOutboundConfig (dict) --
Default Email Outbound config
connectSourceEmailAddress (string) --
Source/Destination Email address used for Email messages
sourceEmailAddressDisplayName (string) --
Display name for Email Address
wisdomTemplateArn (string) --
Amazon Resource Names(ARN)
source (dict) --
Source of the campaign
customerProfilesSegmentArn (string) --
Amazon Resource Names(ARN)
connectCampaignFlowArn (string) --
Amazon Resource Names(ARN)
schedule (dict) --
Campaign schedule
startTime (datetime) --
Timestamp with no UTC offset or timezone
endTime (datetime) --
Timestamp with no UTC offset or timezone
refreshFrequency (string) --
Time duration in ISO 8601 format
communicationTimeConfig (dict) --
Campaign communication time config
localTimeZoneConfig (dict) --
Local time zone config
defaultTimeZone (string) --
Time Zone Id in the IANA format
localTimeZoneDetection (list) --
Local TimeZone Detection method list
(string) --
Local TimeZone Detection method.
telephony (dict) --
Time window config
openHours (dict) --
Open Hours config
dailyHours (dict) --
Daily Hours map
(string) --
Day of week enum
(list) --
List of time range
(dict) --
Time range in 24 hour format
startTime (string) --
Time in ISO 8601 format, e.g. T23:11
endTime (string) --
Time in ISO 8601 format, e.g. T23:11
restrictedPeriods (dict) --
Restricted period config
restrictedPeriodList (list) --
List of restricted period
(dict) --
Restricted period
name (string) --
The name of a restricted period.
startDate (string) --
Date in ISO 8601 format, e.g. 2024-01-01
endDate (string) --
Date in ISO 8601 format, e.g. 2024-01-01
sms (dict) --
Time window config
openHours (dict) --
Open Hours config
dailyHours (dict) --
Daily Hours map
(string) --
Day of week enum
(list) --
List of time range
(dict) --
Time range in 24 hour format
startTime (string) --
Time in ISO 8601 format, e.g. T23:11
endTime (string) --
Time in ISO 8601 format, e.g. T23:11
restrictedPeriods (dict) --
Restricted period config
restrictedPeriodList (list) --
List of restricted period
(dict) --
Restricted period
name (string) --
The name of a restricted period.
startDate (string) --
Date in ISO 8601 format, e.g. 2024-01-01
endDate (string) --
Date in ISO 8601 format, e.g. 2024-01-01
email (dict) --
Time window config
openHours (dict) --
Open Hours config
dailyHours (dict) --
Daily Hours map
(string) --
Day of week enum
(list) --
List of time range
(dict) --
Time range in 24 hour format
startTime (string) --
Time in ISO 8601 format, e.g. T23:11
endTime (string) --
Time in ISO 8601 format, e.g. T23:11
restrictedPeriods (dict) --
Restricted period config
restrictedPeriodList (list) --
List of restricted period
(dict) --
Restricted period
name (string) --
The name of a restricted period.
startDate (string) --
Date in ISO 8601 format, e.g. 2024-01-01
endDate (string) --
Date in ISO 8601 format, e.g. 2024-01-01
communicationLimitsOverride (dict) --
Communication limits config
allChannelSubtypes (dict) --
Communication limits
communicationLimitsList (list) --
List of communication limit
(dict) --
Communication Limit
maxCountPerRecipient (integer) --
Maximum number of contacts allowed for a given target within the given frequency.
frequency (integer) --
The number of days to consider with regards to this limit.
unit (string) --
The communication limit time unit.
tags (dict) --
Tag map with key and value.
(string) --
The key of tag.
(string) --
The value of tag.
Onboard the specific Amazon Connect instance to Connect Campaigns.
See also: AWS API Documentation
Request Syntax
client.start_instance_onboarding_job( connectInstanceId='string', encryptionConfig={ 'enabled': True|False, 'encryptionType': 'KMS', 'keyArn': 'string' } )
string
[REQUIRED]
Amazon Connect Instance Id
dict
[REQUIRED]
Encryption config for Connect Instance. Note that sensitive data will always be encrypted. If disabled, service will perform encryption with its own key. If enabled, a KMS key id needs to be provided and KMS charges will apply. KMS is only type supported
enabled (boolean) -- [REQUIRED]
Boolean to indicate if custom encryption has been enabled.
encryptionType (string) --
Server-side encryption type.
keyArn (string) --
KMS key id/arn for encryption config.
dict
Response Syntax
{ 'connectInstanceOnboardingJobStatus': { 'connectInstanceId': 'string', 'status': 'IN_PROGRESS'|'SUCCEEDED'|'FAILED', 'failureCode': 'EVENT_BRIDGE_ACCESS_DENIED'|'EVENT_BRIDGE_MANAGED_RULE_LIMIT_EXCEEDED'|'IAM_ACCESS_DENIED'|'KMS_ACCESS_DENIED'|'KMS_KEY_NOT_FOUND'|'INTERNAL_FAILURE' } }
Response Structure
(dict) --
The response for StartInstanceOnboardingJob API.
connectInstanceOnboardingJobStatus (dict) --
Instance onboarding job status object
connectInstanceId (string) --
Amazon Connect Instance Id
status (string) --
Enumeration of the possible states for instance onboarding job
failureCode (string) --
Enumeration of the possible failure codes for instance onboarding job
Updates the channel subtype config of a campaign. This API is idempotent.
See also: AWS API Documentation
Request Syntax
client.update_campaign_channel_subtype_config( id='string', channelSubtypeConfig={ 'telephony': { 'capacity': 123.0, 'connectQueueId': 'string', 'outboundMode': { 'progressive': { 'bandwidthAllocation': 123.0 }, 'predictive': { 'bandwidthAllocation': 123.0 }, 'agentless': {} }, 'defaultOutboundConfig': { 'connectContactFlowId': 'string', 'connectSourcePhoneNumber': 'string', 'answerMachineDetectionConfig': { 'enableAnswerMachineDetection': True|False, 'awaitAnswerMachinePrompt': True|False } } }, 'sms': { 'capacity': 123.0, 'outboundMode': { 'agentless': {} }, 'defaultOutboundConfig': { 'connectSourcePhoneNumberArn': 'string', 'wisdomTemplateArn': 'string' } }, 'email': { 'capacity': 123.0, 'outboundMode': { 'agentless': {} }, 'defaultOutboundConfig': { 'connectSourceEmailAddress': 'string', 'sourceEmailAddressDisplayName': 'string', 'wisdomTemplateArn': 'string' } } } )
string
[REQUIRED]
Identifier representing a Campaign
dict
[REQUIRED]
Campaign Channel Subtype config
telephony (dict) --
Telephony Channel Subtype config
capacity (float) --
Allocates outbound capacity for the specific channel subtype of this campaign between multiple active campaigns
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.
outboundMode (dict) -- [REQUIRED]
Telephony Outbound Mode
progressive (dict) --
Progressive config
bandwidthAllocation (float) -- [REQUIRED]
The bandwidth allocation of a queue resource.
predictive (dict) --
Predictive config
bandwidthAllocation (float) -- [REQUIRED]
The bandwidth allocation of a queue resource.
agentless (dict) --
Agentless config
defaultOutboundConfig (dict) -- [REQUIRED]
Default Telephony Outbound config
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.
answerMachineDetectionConfig (dict) --
Answering Machine Detection config
enableAnswerMachineDetection (boolean) -- [REQUIRED]
Enable or disable answering machine detection
awaitAnswerMachinePrompt (boolean) --
Enable or disable await answer machine prompt
sms (dict) --
SMS Channel Subtype config
capacity (float) --
Allocates outbound capacity for the specific channel subtype of this campaign between multiple active campaigns
outboundMode (dict) -- [REQUIRED]
SMS Outbound Mode
agentless (dict) --
Agentless config
defaultOutboundConfig (dict) -- [REQUIRED]
Default SMS Outbound config
connectSourcePhoneNumberArn (string) -- [REQUIRED]
Amazon Resource Names(ARN)
wisdomTemplateArn (string) -- [REQUIRED]
Amazon Resource Names(ARN)
email (dict) --
Email Channel Subtype config
capacity (float) --
Allocates outbound capacity for the specific channel subtype of this campaign between multiple active campaigns
outboundMode (dict) -- [REQUIRED]
Email Outbound Mode
agentless (dict) --
Agentless config
defaultOutboundConfig (dict) -- [REQUIRED]
Default Email Outbound config
connectSourceEmailAddress (string) -- [REQUIRED]
Source/Destination Email address used for Email messages
sourceEmailAddressDisplayName (string) --
Display name for Email Address
wisdomTemplateArn (string) -- [REQUIRED]
Amazon Resource Names(ARN)
None
Updates the campaign source with a campaign. This API is idempotent.
See also: AWS API Documentation
Request Syntax
client.update_campaign_source( id='string', source={ 'customerProfilesSegmentArn': 'string' } )
string
[REQUIRED]
Identifier representing a Campaign
dict
[REQUIRED]
Source of the campaign
customerProfilesSegmentArn (string) --
Amazon Resource Names(ARN)
None
Stops a campaign for the specified Amazon Connect account.
See also: AWS API Documentation
Request Syntax
client.resume_campaign( id='string' )
string
[REQUIRED]
Identifier representing a Campaign
None
Creates outbound requests for the specified campaign Amazon Connect account. This API is idempotent.
See also: AWS API Documentation
Request Syntax
client.put_outbound_request_batch( id='string', outboundRequests=[ { 'clientToken': 'string', 'expirationTime': datetime(2015, 1, 1), 'channelSubtypeParameters': { 'telephony': { 'destinationPhoneNumber': 'string', 'attributes': { 'string': 'string' }, 'connectSourcePhoneNumber': 'string', 'answerMachineDetectionConfig': { 'enableAnswerMachineDetection': True|False, 'awaitAnswerMachinePrompt': True|False } }, 'sms': { 'destinationPhoneNumber': 'string', 'connectSourcePhoneNumberArn': 'string', 'templateArn': 'string', 'templateParameters': { 'string': 'string' } }, 'email': { 'destinationEmailAddress': 'string', 'connectSourceEmailAddress': 'string', 'templateArn': 'string', 'templateParameters': { 'string': 'string' } } } }, ] )
string
[REQUIRED]
Identifier representing a Campaign
list
[REQUIRED]
A list of outbound requests.
(dict) --
An outbound request for a campaign.
clientToken (string) -- [REQUIRED]
Client provided parameter used for idempotency. Its value must be unique for each request.
expirationTime (datetime) -- [REQUIRED]
Timestamp with no UTC offset or timezone
channelSubtypeParameters (dict) -- [REQUIRED]
ChannelSubtypeParameters for an outbound request
telephony (dict) --
Parameters for the Telephony Channel Subtype
destinationPhoneNumber (string) -- [REQUIRED]
The phone number of the customer, in E.164 format.
attributes (dict) -- [REQUIRED]
A custom key-value pair using an attribute map. The attributes are standard Amazon Connect attributes, and can be accessed in contact flows just like any other contact attributes.
(string) --
The key of the attribute. Attribute keys can include only alphanumeric, dash, and underscore characters.
(string) --
The value of the attribute.
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.
answerMachineDetectionConfig (dict) --
Answering Machine Detection config
enableAnswerMachineDetection (boolean) -- [REQUIRED]
Enable or disable answering machine detection
awaitAnswerMachinePrompt (boolean) --
Enable or disable await answer machine prompt
sms (dict) --
Parameters for the SMS Channel Subtype
destinationPhoneNumber (string) -- [REQUIRED]
The phone number of the customer, in E.164 format.
connectSourcePhoneNumberArn (string) --
Amazon Resource Names(ARN)
templateArn (string) --
Amazon Resource Names(ARN)
templateParameters (dict) -- [REQUIRED]
A custom key-value pair using an attribute map. The attributes are standard Amazon Connect attributes, and can be accessed in contact flows just like any other contact attributes.
(string) --
The key of the attribute. Attribute keys can include only alphanumeric, dash, and underscore characters.
(string) --
The value of the attribute.
email (dict) --
Parameters for the Email Channel Subtype
destinationEmailAddress (string) -- [REQUIRED]
Source/Destination Email address used for Email messages
connectSourceEmailAddress (string) --
Source/Destination Email address used for Email messages
templateArn (string) --
Amazon Resource Names(ARN)
templateParameters (dict) -- [REQUIRED]
A custom key-value pair using an attribute map. The attributes are standard Amazon Connect attributes, and can be accessed in contact flows just like any other contact attributes.
(string) --
The key of the attribute. Attribute keys can include only alphanumeric, dash, and underscore characters.
(string) --
The value of the attribute.
dict
Response Syntax
{ 'successfulRequests': [ { 'clientToken': 'string', 'id': 'string' }, ], 'failedRequests': [ { 'clientToken': 'string', 'id': 'string', 'failureCode': 'InvalidInput'|'RequestThrottled'|'UnknownError'|'BufferLimitExceeded' }, ] }
Response Structure
(dict) --
The response for PutOutboundRequestBatch API.
successfulRequests (list) --
A list of successful requests identified by the unique client token.
(dict) --
A successful request identified by the unique client token.
clientToken (string) --
Client provided parameter used for idempotency. Its value must be unique for each request.
id (string) --
Identifier representing a Dial request
failedRequests (list) --
A list of failed requests.
(dict) --
A failed request identified by the unique client token.
clientToken (string) --
Client provided parameter used for idempotency. Its value must be unique for each request.
id (string) --
Identifier representing a Dial request
failureCode (string) --
A predefined code indicating the error that caused the failure.
Delete the Connect Campaigns onboarding job for the specified Amazon Connect instance.
See also: AWS API Documentation
Request Syntax
client.delete_instance_onboarding_job( connectInstanceId='string' )
string
[REQUIRED]
Amazon Connect Instance Id
None
Updates the schedule for a campaign. This API is idempotent.
See also: AWS API Documentation
Request Syntax
client.update_campaign_schedule( id='string', schedule={ 'startTime': datetime(2015, 1, 1), 'endTime': datetime(2015, 1, 1), 'refreshFrequency': 'string' } )
string
[REQUIRED]
Identifier representing a Campaign
dict
[REQUIRED]
Campaign schedule
startTime (datetime) -- [REQUIRED]
Timestamp with no UTC offset or timezone
endTime (datetime) -- [REQUIRED]
Timestamp with no UTC offset or timezone
refreshFrequency (string) --
Time duration in ISO 8601 format
None
Provides summary information about the campaigns under the specified Amazon Connect account.
See also: AWS API Documentation
Request Syntax
client.list_campaigns( maxResults=123, nextToken='string', filters={ 'instanceIdFilter': { 'value': 'string', 'operator': 'Eq' } } )
integer
The maximum number of results to return per page.
string
The token for the next set of results.
dict
Filter model by type
instanceIdFilter (dict) --
Connect instance identifier filter
value (string) -- [REQUIRED]
Amazon Connect Instance Id
operator (string) -- [REQUIRED]
Operators for Connect instance identifier filter
dict
Response Syntax
{ 'nextToken': 'string', 'campaignSummaryList': [ { 'id': 'string', 'arn': 'string', 'name': 'string', 'connectInstanceId': 'string', 'channelSubtypes': [ 'TELEPHONY'|'SMS'|'EMAIL', ], 'schedule': { 'startTime': datetime(2015, 1, 1), 'endTime': datetime(2015, 1, 1), 'refreshFrequency': 'string' }, 'connectCampaignFlowArn': 'string' }, ] }
Response Structure
(dict) --
The response for ListCampaigns API.
nextToken (string) --
The token for the next set of results.
campaignSummaryList (list) --
A list of Amazon Connect campaigns.
(dict) --
An Amazon Connect campaign summary.
id (string) --
Identifier representing a Campaign
arn (string) --
The resource name of an Amazon Connect campaign.
name (string) --
The name of an Amazon Connect Campaign name.
connectInstanceId (string) --
Amazon Connect Instance Id
channelSubtypes (list) --
Channel subtype list
(string) --
The type of campaign channel subtype.
schedule (dict) --
Campaign schedule
startTime (datetime) --
Timestamp with no UTC offset or timezone
endTime (datetime) --
Timestamp with no UTC offset or timezone
refreshFrequency (string) --
Time duration in ISO 8601 format
connectCampaignFlowArn (string) --
Amazon Resource Names(ARN)