Class: Aws::Connect::Client

Inherits:
Seahorse::Client::Base show all
Includes:
Aws::ClientStubs
Defined in:
gems/aws-sdk-connect/lib/aws-sdk-connect/client.rb

Overview

An API client for Connect. To construct a client, you need to configure a :region and :credentials.

client = Aws::Connect::Client.new(
  region: region_name,
  credentials: credentials,
  # ...
)

For details on configuring region and credentials see the developer guide.

See #initialize for a full list of supported configuration options.

Instance Attribute Summary

Attributes inherited from Seahorse::Client::Base

#config, #handlers

API Operations collapse

Instance Method Summary collapse

Methods included from Aws::ClientStubs

#api_requests, #stub_data, #stub_responses

Methods inherited from Seahorse::Client::Base

add_plugin, api, clear_plugins, define, new, #operation_names, plugins, remove_plugin, set_api, set_plugins

Methods included from Seahorse::Client::HandlerBuilder

#handle, #handle_request, #handle_response

Constructor Details

#initialize(options) ⇒ Client

Returns a new instance of Client.

Parameters:

  • options (Hash)

Options Hash (options):

  • :credentials (required, Aws::CredentialProvider)

    Your AWS credentials. This can be an instance of any one of the following classes:

    • Aws::Credentials - Used for configuring static, non-refreshing credentials.

    • Aws::SharedCredentials - Used for loading static credentials from a shared file, such as ~/.aws/config.

    • Aws::AssumeRoleCredentials - Used when you need to assume a role.

    • Aws::AssumeRoleWebIdentityCredentials - Used when you need to assume a role after providing credentials via the web.

    • Aws::SSOCredentials - Used for loading credentials from AWS SSO using an access token generated from aws login.

    • Aws::ProcessCredentials - Used for loading credentials from a process that outputs to stdout.

    • Aws::InstanceProfileCredentials - Used for loading credentials from an EC2 IMDS on an EC2 instance.

    • Aws::ECSCredentials - Used for loading credentials from instances running in ECS.

    • Aws::CognitoIdentityCredentials - Used for loading credentials from the Cognito Identity service.

    When :credentials are not configured directly, the following locations will be searched for credentials:

    • Aws.config[:credentials]
    • The :access_key_id, :secret_access_key, and :session_token options.
    • ENV['AWS_ACCESS_KEY_ID'], ENV['AWS_SECRET_ACCESS_KEY']
    • ~/.aws/credentials
    • ~/.aws/config
    • EC2/ECS IMDS instance profile - When used by default, the timeouts are very aggressive. Construct and pass an instance of Aws::InstanceProfileCredentails or Aws::ECSCredentials to enable retries and extended timeouts. Instance profile credential fetching can be disabled by setting ENV['AWS_EC2_METADATA_DISABLED'] to true.
  • :region (required, String)

    The AWS region to connect to. The configured :region is used to determine the service :endpoint. When not passed, a default :region is searched for in the following locations:

    • Aws.config[:region]
    • ENV['AWS_REGION']
    • ENV['AMAZON_REGION']
    • ENV['AWS_DEFAULT_REGION']
    • ~/.aws/credentials
    • ~/.aws/config
  • :access_key_id (String)
  • :active_endpoint_cache (Boolean) — default: false

    When set to true, a thread polling for endpoints will be running in the background every 60 secs (default). Defaults to false.

  • :adaptive_retry_wait_to_fill (Boolean) — default: true

    Used only in adaptive retry mode. When true, the request will sleep until there is sufficent client side capacity to retry the request. When false, the request will raise a RetryCapacityNotAvailableError and will not retry instead of sleeping.

  • :client_side_monitoring (Boolean) — default: false

    When true, client-side metrics will be collected for all API requests from this client.

  • :client_side_monitoring_client_id (String) — default: ""

    Allows you to provide an identifier for this client which will be attached to all generated client side metrics. Defaults to an empty string.

  • :client_side_monitoring_host (String) — default: "127.0.0.1"

    Allows you to specify the DNS hostname or IPv4 or IPv6 address that the client side monitoring agent is running on, where client metrics will be published via UDP.

  • :client_side_monitoring_port (Integer) — default: 31000

    Required for publishing client metrics. The port that the client side monitoring agent is running on, where client metrics will be published via UDP.

  • :client_side_monitoring_publisher (Aws::ClientSideMonitoring::Publisher) — default: Aws::ClientSideMonitoring::Publisher

    Allows you to provide a custom client-side monitoring publisher class. By default, will use the Client Side Monitoring Agent Publisher.

  • :convert_params (Boolean) — default: true

    When true, an attempt is made to coerce request parameters into the required types.

  • :correct_clock_skew (Boolean) — default: true

    Used only in standard and adaptive retry modes. Specifies whether to apply a clock skew correction and retry requests with skewed client clocks.

  • :defaults_mode (String) — default: "legacy"

    See DefaultsModeConfiguration for a list of the accepted modes and the configuration defaults that are included.

  • :disable_host_prefix_injection (Boolean) — default: false

    Set to true to disable SDK automatically adding host prefix to default service endpoint when available.

  • :disable_request_compression (Boolean) — default: false

    When set to 'true' the request body will not be compressed for supported operations.

  • :endpoint (String)

    The client endpoint is normally constructed from the :region option. You should only configure an :endpoint when connecting to test or custom endpoints. This should be a valid HTTP(S) URI.

  • :endpoint_cache_max_entries (Integer) — default: 1000

    Used for the maximum size limit of the LRU cache storing endpoints data for endpoint discovery enabled operations. Defaults to 1000.

  • :endpoint_cache_max_threads (Integer) — default: 10

    Used for the maximum threads in use for polling endpoints to be cached, defaults to 10.

  • :endpoint_cache_poll_interval (Integer) — default: 60

    When :endpoint_discovery and :active_endpoint_cache is enabled, Use this option to config the time interval in seconds for making requests fetching endpoints information. Defaults to 60 sec.

  • :endpoint_discovery (Boolean) — default: false

    When set to true, endpoint discovery will be enabled for operations when available.

  • :ignore_configured_endpoint_urls (Boolean)

    Setting to true disables use of endpoint URLs provided via environment variables and the shared configuration file.

  • :log_formatter (Aws::Log::Formatter) — default: Aws::Log::Formatter.default

    The log formatter.

  • :log_level (Symbol) — default: :info

    The log level to send messages to the :logger at.

  • :logger (Logger)

    The Logger instance to send log messages to. If this option is not set, logging will be disabled.

  • :max_attempts (Integer) — default: 3

    An integer representing the maximum number attempts that will be made for a single request, including the initial attempt. For example, setting this value to 5 will result in a request being retried up to 4 times. Used in standard and adaptive retry modes.

  • :profile (String) — default: "default"

    Used when loading credentials from the shared credentials file at HOME/.aws/credentials. When not specified, 'default' is used.

  • :request_min_compression_size_bytes (Integer) — default: 10240

    The minimum size in bytes that triggers compression for request bodies. The value must be non-negative integer value between 0 and 10485780 bytes inclusive.

  • :retry_backoff (Proc)

    A proc or lambda used for backoff. Defaults to 2**retries * retry_base_delay. This option is only used in the legacy retry mode.

  • :retry_base_delay (Float) — default: 0.3

    The base delay in seconds used by the default backoff function. This option is only used in the legacy retry mode.

  • :retry_jitter (Symbol) — default: :none

    A delay randomiser function used by the default backoff function. Some predefined functions can be referenced by name - :none, :equal, :full, otherwise a Proc that takes and returns a number. This option is only used in the legacy retry mode.

    @see https://www.awsarchitectureblog.com/2015/03/backoff.html

  • :retry_limit (Integer) — default: 3

    The maximum number of times to retry failed requests. Only ~ 500 level server errors and certain ~ 400 level client errors are retried. Generally, these are throttling errors, data checksum errors, networking errors, timeout errors, auth errors, endpoint discovery, and errors from expired credentials. This option is only used in the legacy retry mode.

  • :retry_max_delay (Integer) — default: 0

    The maximum number of seconds to delay between retries (0 for no limit) used by the default backoff function. This option is only used in the legacy retry mode.

  • :retry_mode (String) — default: "legacy"

    Specifies which retry algorithm to use. Values are:

    • legacy - The pre-existing retry behavior. This is default value if no retry mode is provided.

    • standard - A standardized set of retry rules across the AWS SDKs. This includes support for retry quotas, which limit the number of unsuccessful retries a client can make.

    • adaptive - An experimental retry mode that includes all the functionality of standard mode along with automatic client side throttling. This is a provisional mode that may change behavior in the future.

  • :sdk_ua_app_id (String)

    A unique and opaque application ID that is appended to the User-Agent header as app/. It should have a maximum length of 50.

  • :secret_access_key (String)
  • :session_token (String)
  • :stub_responses (Boolean) — default: false

    Causes the client to return stubbed responses. By default fake responses are generated and returned. You can specify the response data to return or errors to raise by calling Aws::ClientStubs#stub_responses. See Aws::ClientStubs for more information.

    Please note When response stubbing is enabled, no HTTP requests are made, and retries are disabled.

  • :token_provider (Aws::TokenProvider)

    A Bearer Token Provider. This can be an instance of any one of the following classes:

    • Aws::StaticTokenProvider - Used for configuring static, non-refreshing tokens.

    • Aws::SSOTokenProvider - Used for loading tokens from AWS SSO using an access token generated from aws login.

    When :token_provider is not configured directly, the Aws::TokenProviderChain will be used to search for tokens configured for your profile in shared configuration files.

  • :use_dualstack_endpoint (Boolean)

    When set to true, dualstack enabled endpoints (with .aws TLD) will be used if available.

  • :use_fips_endpoint (Boolean)

    When set to true, fips compatible endpoints will be used if available. When a fips region is used, the region is normalized and this config is set to true.

  • :validate_params (Boolean) — default: true

    When true, request parameters are validated before sending the request.

  • :endpoint_provider (Aws::Connect::EndpointProvider)

    The endpoint provider used to resolve endpoints. Any object that responds to #resolve_endpoint(parameters) where parameters is a Struct similar to Aws::Connect::EndpointParameters

  • :http_proxy (URI::HTTP, String)

    A proxy to send requests through. Formatted like 'http://proxy.com:123'.

  • :http_open_timeout (Float) — default: 15

    The number of seconds to wait when opening a HTTP session before raising a Timeout::Error.

  • :http_read_timeout (Float) — default: 60

    The default number of seconds to wait for response data. This value can safely be set per-request on the session.

  • :http_idle_timeout (Float) — default: 5

    The number of seconds a connection is allowed to sit idle before it is considered stale. Stale connections are closed and removed from the pool before making a request.

  • :http_continue_timeout (Float) — default: 1

    The number of seconds to wait for a 100-continue response before sending the request body. This option has no effect unless the request has "Expect" header set to "100-continue". Defaults to nil which disables this behaviour. This value can safely be set per request on the session.

  • :ssl_timeout (Float) — default: nil

    Sets the SSL timeout in seconds.

  • :http_wire_trace (Boolean) — default: false

    When true, HTTP debug output will be sent to the :logger.

  • :ssl_verify_peer (Boolean) — default: true

    When true, SSL peer certificates are verified when establishing a connection.

  • :ssl_ca_bundle (String)

    Full path to the SSL certificate authority bundle file that should be used when verifying peer certificates. If you do not pass :ssl_ca_bundle or :ssl_ca_directory the the system default will be used if available.

  • :ssl_ca_directory (String)

    Full path of the directory that contains the unbundled SSL certificate authority files for verifying peer certificates. If you do not pass :ssl_ca_bundle or :ssl_ca_directory the the system default will be used if available.



385
386
387
# File 'gems/aws-sdk-connect/lib/aws-sdk-connect/client.rb', line 385

def initialize(*args)
  super
end

Instance Method Details

#activate_evaluation_form(params = {}) ⇒ Types::ActivateEvaluationFormResponse

Activates an evaluation form in the specified Amazon Connect instance. After the evaluation form is activated, it is available to start new evaluations based on the form.

Examples:

Request syntax with placeholder values


resp = client.activate_evaluation_form({
  instance_id: "InstanceId", # required
  evaluation_form_id: "ResourceId", # required
  evaluation_form_version: 1, # required
})

Response structure


resp.evaluation_form_id #=> String
resp.evaluation_form_arn #=> String
resp.evaluation_form_version #=> Integer

Parameters:

  • params (Hash) (defaults to: {})

    ({})

Options Hash (params):

  • :instance_id (required, String)

    The identifier of the Amazon Connect instance. You can find the instance ID in the Amazon Resource Name (ARN) of the instance.

  • :evaluation_form_id (required, String)

    The unique identifier for the evaluation form.

  • :evaluation_form_version (required, Integer)

    The version of the evaluation form to activate. If the version property is not provided, the latest version of the evaluation form is activated.

Returns:

See Also:



435
436
437
438
# File 'gems/aws-sdk-connect/lib/aws-sdk-connect/client.rb', line 435

def activate_evaluation_form(params = {}, options = {})
  req = build_request(:activate_evaluation_form, params)
  req.send_request(options)
end

#associate_analytics_data_set(params = {}) ⇒ Types::AssociateAnalyticsDataSetResponse

This API is in preview release for Amazon Connect and is subject to change.

Associates the specified dataset for a Amazon Connect instance with the target account. You can associate only one dataset in a single call.

Examples:

Request syntax with placeholder values


resp = client.associate_analytics_data_set({
  instance_id: "InstanceId", # required
  data_set_id: "DataSetId", # required
  target_account_id: "AWSAccountId",
})

Response structure


resp.data_set_id #=> String
resp. #=> String
resp.resource_share_id #=> String
resp.resource_share_arn #=> String

Parameters:

  • params (Hash) (defaults to: {})

    ({})

Options Hash (params):

  • :instance_id (required, String)

    The identifier of the Amazon Connect instance. You can find the instance ID in the Amazon Resource Name (ARN) of the instance.

  • :data_set_id (required, String)

    The identifier of the dataset to associate with the target account.

  • :target_account_id (String)

    The identifier of the target account. Use to associate a dataset to a different account than the one containing the Amazon Connect instance. If not specified, by default this value is the Amazon Web Services account that has the Amazon Connect instance.

Returns:

See Also:



490
491
492
493
# File 'gems/aws-sdk-connect/lib/aws-sdk-connect/client.rb', line 490

def associate_analytics_data_set(params = {}, options = {})
  req = build_request(:associate_analytics_data_set, params)
  req.send_request(options)
end

#associate_approved_origin(params = {}) ⇒ Struct

This API is in preview release for Amazon Connect and is subject to change.

Associates an approved origin to an Amazon Connect instance.

Examples:

Request syntax with placeholder values


resp = client.associate_approved_origin({
  instance_id: "InstanceId", # required
  origin: "Origin", # required
})

Parameters:

  • params (Hash) (defaults to: {})

    ({})

Options Hash (params):

  • :instance_id (required, String)

    The identifier of the Amazon Connect instance. You can find the instance ID in the Amazon Resource Name (ARN) of the instance.

  • :origin (required, String)

    The domain to add to your allow list.

Returns:

  • (Struct)

    Returns an empty response.

See Also:



524
525
526
527
# File 'gems/aws-sdk-connect/lib/aws-sdk-connect/client.rb', line 524

def associate_approved_origin(params = {}, options = {})
  req = build_request(:associate_approved_origin, params)
  req.send_request(options)
end

#associate_bot(params = {}) ⇒ Struct

This API is in preview release for Amazon Connect and is subject to change.

Allows the specified Amazon Connect instance to access the specified Amazon Lex or Amazon Lex V2 bot.

Examples:

Request syntax with placeholder values


resp = client.associate_bot({
  instance_id: "InstanceId", # required
  lex_bot: {
    name: "BotName", # required
    lex_region: "LexRegion", # required
  },
  lex_v2_bot: {
    alias_arn: "AliasArn",
  },
})

Parameters:

  • params (Hash) (defaults to: {})

    ({})

Options Hash (params):

  • :instance_id (required, String)

    The identifier of the Amazon Connect instance. You can find the instance ID in the Amazon Resource Name (ARN) of the instance.

  • :lex_bot (Types::LexBot)

    Configuration information of an Amazon Lex bot.

  • :lex_v2_bot (Types::LexV2Bot)

    The Amazon Lex V2 bot to associate with the instance.

Returns:

  • (Struct)

    Returns an empty response.

See Also:



568
569
570
571
# File 'gems/aws-sdk-connect/lib/aws-sdk-connect/client.rb', line 568

def associate_bot(params = {}, options = {})
  req = build_request(:associate_bot, params)
  req.send_request(options)
end

#associate_default_vocabulary(params = {}) ⇒ Struct

Associates an existing vocabulary as the default. Contact Lens for Amazon Connect uses the vocabulary in post-call and real-time analysis sessions for the given language.

Examples:

Request syntax with placeholder values


resp = client.associate_default_vocabulary({
  instance_id: "InstanceId", # required
  language_code: "ar-AE", # required, accepts ar-AE, de-CH, de-DE, en-AB, en-AU, en-GB, en-IE, en-IN, en-US, en-WL, es-ES, es-US, fr-CA, fr-FR, hi-IN, it-IT, ja-JP, ko-KR, pt-BR, pt-PT, zh-CN, en-NZ, en-ZA
  vocabulary_id: "VocabularyId",
})

Parameters:

  • params (Hash) (defaults to: {})

    ({})

Options Hash (params):

  • :instance_id (required, String)

    The identifier of the Amazon Connect instance. You can find the instance ID in the Amazon Resource Name (ARN) of the instance.

  • :language_code (required, String)

    The language code of the vocabulary entries. For a list of languages and their corresponding language codes, see What is Amazon Transcribe?

  • :vocabulary_id (String)

    The identifier of the custom vocabulary. If this is empty, the default is set to none.

Returns:

  • (Struct)

    Returns an empty response.

See Also:



612
613
614
615
# File 'gems/aws-sdk-connect/lib/aws-sdk-connect/client.rb', line 612

def associate_default_vocabulary(params = {}, options = {})
  req = build_request(:associate_default_vocabulary, params)
  req.send_request(options)
end

#associate_flow(params = {}) ⇒ Struct

Associates a connect resource to a flow.

Examples:

Request syntax with placeholder values


resp = client.associate_flow({
  instance_id: "InstanceId", # required
  resource_id: "ARN", # required
  flow_id: "ARN", # required
  resource_type: "SMS_PHONE_NUMBER", # required, accepts SMS_PHONE_NUMBER
})

Parameters:

  • params (Hash) (defaults to: {})

    ({})

Options Hash (params):

  • :instance_id (required, String)

    The identifier of the Amazon Connect instance. You can find the instance ID in the Amazon Resource Name (ARN) of the instance.

  • :resource_id (required, String)

    The identifier of the resource.

  • :flow_id (required, String)

    The identifier of the flow.

  • :resource_type (required, String)

    A valid resource type.

Returns:

  • (Struct)

    Returns an empty response.

See Also:



651
652
653
654
# File 'gems/aws-sdk-connect/lib/aws-sdk-connect/client.rb', line 651

def associate_flow(params = {}, options = {})
  req = build_request(:associate_flow, params)
  req.send_request(options)
end

#associate_instance_storage_config(params = {}) ⇒ Types::AssociateInstanceStorageConfigResponse

This API is in preview release for Amazon Connect and is subject to change.

Associates a storage resource type for the first time. You can only associate one type of storage configuration in a single call. This means, for example, that you can't define an instance with multiple S3 buckets for storing chat transcripts.

This API does not create a resource that doesn't exist. It only associates it to the instance. Ensure that the resource being specified in the storage configuration, like an S3 bucket, exists when being used for association.

Examples:

Request syntax with placeholder values


resp = client.associate_instance_storage_config({
  instance_id: "InstanceId", # required
  resource_type: "CHAT_TRANSCRIPTS", # required, accepts CHAT_TRANSCRIPTS, CALL_RECORDINGS, SCHEDULED_REPORTS, MEDIA_STREAMS, CONTACT_TRACE_RECORDS, AGENT_EVENTS, REAL_TIME_CONTACT_ANALYSIS_SEGMENTS, ATTACHMENTS, CONTACT_EVALUATIONS, SCREEN_RECORDINGS
  storage_config: { # required
    association_id: "AssociationId",
    storage_type: "S3", # required, accepts S3, KINESIS_VIDEO_STREAM, KINESIS_STREAM, KINESIS_FIREHOSE
    s3_config: {
      bucket_name: "BucketName", # required
      bucket_prefix: "Prefix", # required
      encryption_config: {
        encryption_type: "KMS", # required, accepts KMS
        key_id: "KeyId", # required
      },
    },
    kinesis_video_stream_config: {
      prefix: "Prefix", # required
      retention_period_hours: 1, # required
      encryption_config: { # required
        encryption_type: "KMS", # required, accepts KMS
        key_id: "KeyId", # required
      },
    },
    kinesis_stream_config: {
      stream_arn: "ARN", # required
    },
    kinesis_firehose_config: {
      firehose_arn: "ARN", # required
    },
  },
})

Response structure


resp.association_id #=> String

Parameters:

  • params (Hash) (defaults to: {})

    ({})

Options Hash (params):

  • :instance_id (required, String)

    The identifier of the Amazon Connect instance. You can find the instance ID in the Amazon Resource Name (ARN) of the instance.

  • :resource_type (required, String)

    A valid resource type.

  • :storage_config (required, Types::InstanceStorageConfig)

    A valid storage type.

Returns:

See Also:



728
729
730
731
# File 'gems/aws-sdk-connect/lib/aws-sdk-connect/client.rb', line 728

def associate_instance_storage_config(params = {}, options = {})
  req = build_request(:associate_instance_storage_config, params)
  req.send_request(options)
end

#associate_lambda_function(params = {}) ⇒ Struct

This API is in preview release for Amazon Connect and is subject to change.

Allows the specified Amazon Connect instance to access the specified Lambda function.

Examples:

Request syntax with placeholder values


resp = client.associate_lambda_function({
  instance_id: "InstanceId", # required
  function_arn: "FunctionArn", # required
})

Parameters:

  • params (Hash) (defaults to: {})

    ({})

Options Hash (params):

  • :instance_id (required, String)

    The identifier of the Amazon Connect instance. You can find the instance ID in the Amazon Resource Name (ARN) of the instance.

  • :function_arn (required, String)

    The Amazon Resource Name (ARN) for the Lambda function being associated. Maximum number of characters allowed is 140.

Returns:

  • (Struct)

    Returns an empty response.

See Also:



764
765
766
767
# File 'gems/aws-sdk-connect/lib/aws-sdk-connect/client.rb', line 764

def associate_lambda_function(params = {}, options = {})
  req = build_request(:associate_lambda_function, params)
  req.send_request(options)
end

#associate_lex_bot(params = {}) ⇒ Struct

This API is in preview release for Amazon Connect and is subject to change.

Allows the specified Amazon Connect instance to access the specified Amazon Lex V1 bot. This API only supports the association of Amazon Lex V1 bots.

Examples:

Request syntax with placeholder values


resp = client.associate_lex_bot({
  instance_id: "InstanceId", # required
  lex_bot: { # required
    name: "BotName", # required
    lex_region: "LexRegion", # required
  },
})

Parameters:

  • params (Hash) (defaults to: {})

    ({})

Options Hash (params):

  • :instance_id (required, String)

    The identifier of the Amazon Connect instance. You can find the instance ID in the Amazon Resource Name (ARN) of the instance.

  • :lex_bot (required, Types::LexBot)

    The Amazon Lex bot to associate with the instance.

Returns:

  • (Struct)

    Returns an empty response.

See Also:



803
804
805
806
# File 'gems/aws-sdk-connect/lib/aws-sdk-connect/client.rb', line 803

def associate_lex_bot(params = {}, options = {})
  req = build_request(:associate_lex_bot, params)
  req.send_request(options)
end

#associate_phone_number_contact_flow(params = {}) ⇒ Struct

Associates a flow with a phone number claimed to your Amazon Connect instance.

If the number is claimed to a traffic distribution group, and you are calling this API using an instance in the Amazon Web Services Region where the traffic distribution group was created, you can use either a full phone number ARN or UUID value for the PhoneNumberId URI request parameter. However, if the number is claimed to a traffic distribution group and you are calling this API using an instance in the alternate Amazon Web Services Region associated with the traffic distribution group, you must provide a full phone number ARN. If a UUID is provided in this scenario, you will receive a ResourceNotFoundException.

Examples:

Request syntax with placeholder values


resp = client.associate_phone_number_contact_flow({
  phone_number_id: "PhoneNumberId", # required
  instance_id: "InstanceId", # required
  contact_flow_id: "ContactFlowId", # required
})

Parameters:

  • params (Hash) (defaults to: {})

    ({})

Options Hash (params):

  • :phone_number_id (required, String)

    A unique identifier for the phone number.

  • :instance_id (required, String)

    The identifier of the Amazon Connect instance. You can find the instance ID in the Amazon Resource Name (ARN) of the instance.

  • :contact_flow_id (required, String)

    The identifier of the flow.

Returns:

  • (Struct)

    Returns an empty response.

See Also:



850
851
852
853
# File 'gems/aws-sdk-connect/lib/aws-sdk-connect/client.rb', line 850

def associate_phone_number_contact_flow(params = {}, options = {})
  req = build_request(:associate_phone_number_contact_flow, params)
  req.send_request(options)
end

#associate_queue_quick_connects(params = {}) ⇒ Struct

This API is in preview release for Amazon Connect and is subject to change.

Associates a set of quick connects with a queue.

Examples:

Request syntax with placeholder values


resp = client.associate_queue_quick_connects({
  instance_id: "InstanceId", # required
  queue_id: "QueueId", # required
  quick_connect_ids: ["QuickConnectId"], # required
})

Parameters:

  • params (Hash) (defaults to: {})

    ({})

Options Hash (params):

  • :instance_id (required, String)

    The identifier of the Amazon Connect instance. You can find the instance ID in the Amazon Resource Name (ARN) of the instance.

  • :queue_id (required, String)

    The identifier for the queue.

  • :quick_connect_ids (required, Array<String>)

    The quick connects to associate with this queue.

Returns:

  • (Struct)

    Returns an empty response.

See Also:



888
889
890
891
# File 'gems/aws-sdk-connect/lib/aws-sdk-connect/client.rb', line 888

def associate_queue_quick_connects(params = {}, options = {})
  req = build_request(:associate_queue_quick_connects, params)
  req.send_request(options)
end

#associate_routing_profile_queues(params = {}) ⇒ Struct

Associates a set of queues with a routing profile.

Examples:

Request syntax with placeholder values


resp = client.associate_routing_profile_queues({
  instance_id: "InstanceId", # required
  routing_profile_id: "RoutingProfileId", # required
  queue_configs: [ # required
    {
      queue_reference: { # required
        queue_id: "QueueId", # required
        channel: "VOICE", # required, accepts VOICE, CHAT, TASK
      },
      priority: 1, # required
      delay: 1, # required
    },
  ],
})

Parameters:

  • params (Hash) (defaults to: {})

    ({})

Options Hash (params):

  • :instance_id (required, String)

    The identifier of the Amazon Connect instance. You can find the instance ID in the Amazon Resource Name (ARN) of the instance.

  • :routing_profile_id (required, String)

    The identifier of the routing profile.

  • :queue_configs (required, Array<Types::RoutingProfileQueueConfig>)

    The queues to associate with this routing profile.

Returns:

  • (Struct)

    Returns an empty response.

See Also:



932
933
934
935
# File 'gems/aws-sdk-connect/lib/aws-sdk-connect/client.rb', line 932

def associate_routing_profile_queues(params = {}, options = {})
  req = build_request(:associate_routing_profile_queues, params)
  req.send_request(options)
end

#associate_security_key(params = {}) ⇒ Types::AssociateSecurityKeyResponse

This API is in preview release for Amazon Connect and is subject to change.

Associates a security key to the instance.

Examples:

Request syntax with placeholder values


resp = client.associate_security_key({
  instance_id: "InstanceId", # required
  key: "PEM", # required
})

Response structure


resp.association_id #=> String

Parameters:

  • params (Hash) (defaults to: {})

    ({})

Options Hash (params):

  • :instance_id (required, String)

    The identifier of the Amazon Connect instance. You can find the instance ID in the Amazon Resource Name (ARN) of the instance.

  • :key (required, String)

    A valid security key in PEM format.

Returns:

See Also:



972
973
974
975
# File 'gems/aws-sdk-connect/lib/aws-sdk-connect/client.rb', line 972

def associate_security_key(params = {}, options = {})
  req = build_request(:associate_security_key, params)
  req.send_request(options)
end

#associate_traffic_distribution_group_user(params = {}) ⇒ Struct

Associates an agent with a traffic distribution group.

Examples:

Request syntax with placeholder values


resp = client.associate_traffic_distribution_group_user({
  traffic_distribution_group_id: "TrafficDistributionGroupIdOrArn", # required
  user_id: "UserId", # required
  instance_id: "InstanceId", # required
})

Parameters:

  • params (Hash) (defaults to: {})

    ({})

Options Hash (params):

  • :traffic_distribution_group_id (required, String)

    The identifier of the traffic distribution group. This can be the ID or the ARN if the API is being called in the Region where the traffic distribution group was created. The ARN must be provided if the call is from the replicated Region.

  • :user_id (required, String)

    The identifier of the user account. This can be the ID or the ARN of the user.

  • :instance_id (required, String)

    The identifier of the Amazon Connect instance. You can find the instance ID in the Amazon Resource Name (ARN) of the instance.

Returns:

  • (Struct)

    Returns an empty response.

See Also:



1011
1012
1013
1014
# File 'gems/aws-sdk-connect/lib/aws-sdk-connect/client.rb', line 1011

def associate_traffic_distribution_group_user(params = {}, options = {})
  req = build_request(:associate_traffic_distribution_group_user, params)
  req.send_request(options)
end

#associate_user_proficiencies(params = {}) ⇒ Struct

>Associates a set of proficiencies with a user.

Examples:

Request syntax with placeholder values


resp = client.associate_user_proficiencies({
  instance_id: "InstanceId", # required
  user_id: "UserId", # required
  user_proficiencies: [ # required
    {
      attribute_name: "PredefinedAttributeName", # required
      attribute_value: "PredefinedAttributeStringValue", # required
      level: 1.0, # required
    },
  ],
})

Parameters:

  • params (Hash) (defaults to: {})

    ({})

Options Hash (params):

  • :instance_id (required, String)

    The identifier of the Amazon Connect instance. You can find the instance ID in the Amazon Resource Name (ARN of the instance).

  • :user_id (required, String)

    The identifier of the user account.

  • :user_proficiencies (required, Array<Types::UserProficiency>)

    The proficiencies to associate with the user.

Returns:

  • (Struct)

    Returns an empty response.

See Also:



1048
1049
1050
1051
# File 'gems/aws-sdk-connect/lib/aws-sdk-connect/client.rb', line 1048

def associate_user_proficiencies(params = {}, options = {})
  req = build_request(:associate_user_proficiencies, params)
  req.send_request(options)
end

#batch_associate_analytics_data_set(params = {}) ⇒ Types::BatchAssociateAnalyticsDataSetResponse

This API is in preview release for Amazon Connect and is subject to change.

Associates a list of analytics datasets for a given Amazon Connect instance to a target account. You can associate multiple datasets in a single call.

Examples:

Request syntax with placeholder values


resp = client.batch_associate_analytics_data_set({
  instance_id: "InstanceId", # required
  data_set_ids: ["DataSetId"], # required
  target_account_id: "AWSAccountId",
})

Response structure


resp.created #=> Array
resp.created[0].data_set_id #=> String
resp.created[0]. #=> String
resp.created[0].resource_share_id #=> String
resp.created[0].resource_share_arn #=> String
resp.errors #=> Array
resp.errors[0].error_code #=> String
resp.errors[0].error_message #=> String

Parameters:

  • params (Hash) (defaults to: {})

    ({})

Options Hash (params):

  • :instance_id (required, String)

    The identifier of the Amazon Connect instance. You can find the instance ID in the Amazon Resource Name (ARN) of the instance.

  • :data_set_ids (required, Array<String>)

    An array of dataset identifiers to associate.

  • :target_account_id (String)

    The identifier of the target account. Use to associate a dataset to a different account than the one containing the Amazon Connect instance. If not specified, by default this value is the Amazon Web Services account that has the Amazon Connect instance.

Returns:

See Also:



1105
1106
1107
1108
# File 'gems/aws-sdk-connect/lib/aws-sdk-connect/client.rb', line 1105

def batch_associate_analytics_data_set(params = {}, options = {})
  req = build_request(:batch_associate_analytics_data_set, params)
  req.send_request(options)
end

#batch_disassociate_analytics_data_set(params = {}) ⇒ Types::BatchDisassociateAnalyticsDataSetResponse

This API is in preview release for Amazon Connect and is subject to change.

Removes a list of analytics datasets associated with a given Amazon Connect instance. You can disassociate multiple datasets in a single call.

Examples:

Request syntax with placeholder values


resp = client.batch_disassociate_analytics_data_set({
  instance_id: "InstanceId", # required
  data_set_ids: ["DataSetId"], # required
  target_account_id: "AWSAccountId",
})

Response structure


resp.deleted #=> Array
resp.deleted[0] #=> String
resp.errors #=> Array
resp.errors[0].error_code #=> String
resp.errors[0].error_message #=> String

Parameters:

  • params (Hash) (defaults to: {})

    ({})

Options Hash (params):

  • :instance_id (required, String)

    The identifier of the Amazon Connect instance. You can find the instance ID in the Amazon Resource Name (ARN) of the instance.

  • :data_set_ids (required, Array<String>)

    An array of associated dataset identifiers to remove.

  • :target_account_id (String)

    The identifier of the target account. Use to disassociate a dataset from a different account than the one containing the Amazon Connect instance. If not specified, by default this value is the Amazon Web Services account that has the Amazon Connect instance.

Returns:

See Also:



1159
1160
1161
1162
# File 'gems/aws-sdk-connect/lib/aws-sdk-connect/client.rb', line 1159

def batch_disassociate_analytics_data_set(params = {}, options = {})
  req = build_request(:batch_disassociate_analytics_data_set, params)
  req.send_request(options)
end

#batch_get_flow_association(params = {}) ⇒ Types::BatchGetFlowAssociationResponse

Retrieve the flow associations for the given resources.

Examples:

Request syntax with placeholder values


resp = client.batch_get_flow_association({
  instance_id: "InstanceId", # required
  resource_ids: ["ARN"], # required
  resource_type: "VOICE_PHONE_NUMBER", # accepts VOICE_PHONE_NUMBER
})

Response structure


resp.flow_association_summary_list #=> Array
resp.flow_association_summary_list[0].resource_id #=> String
resp.flow_association_summary_list[0].flow_id #=> String
resp.flow_association_summary_list[0].resource_type #=> String, one of "VOICE_PHONE_NUMBER"

Parameters:

  • params (Hash) (defaults to: {})

    ({})

Options Hash (params):

  • :instance_id (required, String)

    The identifier of the Amazon Connect instance. You can find the instance ID in the Amazon Resource Name (ARN) of the instance.

  • :resource_ids (required, Array<String>)

    A list of resource identifiers to retrieve flow associations.

  • :resource_type (String)

    The type of resource association.

Returns:

See Also:



1203
1204
1205
1206
# File 'gems/aws-sdk-connect/lib/aws-sdk-connect/client.rb', line 1203

def batch_get_flow_association(params = {}, options = {})
  req = build_request(:batch_get_flow_association, params)
  req.send_request(options)
end

#batch_put_contact(params = {}) ⇒ Types::BatchPutContactResponse

Only the Amazon Connect outbound campaigns service principal is allowed to assume a role in your account and call this API.

Allows you to create a batch of contacts in Amazon Connect. The outbound campaigns capability ingests dial requests via the PutDialRequestBatch API. It then uses BatchPutContact to create contacts corresponding to those dial requests. If agents are available, the dial requests are dialed out, which results in a voice call. The resulting voice call uses the same contactId that was created by BatchPutContact.

Examples:

Request syntax with placeholder values


resp = client.batch_put_contact({
  client_token: "ClientToken",
  instance_id: "InstanceId", # required
  contact_data_request_list: [ # required
    {
      system_endpoint: {
        type: "TELEPHONE_NUMBER", # accepts TELEPHONE_NUMBER, VOIP, CONTACT_FLOW
        address: "EndpointAddress",
      },
      customer_endpoint: {
        type: "TELEPHONE_NUMBER", # accepts TELEPHONE_NUMBER, VOIP, CONTACT_FLOW
        address: "EndpointAddress",
      },
      request_identifier: "RequestIdentifier",
      queue_id: "QueueId",
      attributes: {
        "AttributeName" => "AttributeValue",
      },
      campaign: {
        campaign_id: "CampaignId",
      },
    },
  ],
})

Response structure


resp.successful_request_list #=> Array
resp.successful_request_list[0].request_identifier #=> String
resp.successful_request_list[0].contact_id #=> String
resp.failed_request_list #=> Array
resp.failed_request_list[0].request_identifier #=> String
resp.failed_request_list[0].failure_reason_code #=> String, one of "INVALID_ATTRIBUTE_KEY", "INVALID_CUSTOMER_ENDPOINT", "INVALID_SYSTEM_ENDPOINT", "INVALID_QUEUE", "MISSING_CAMPAIGN", "MISSING_CUSTOMER_ENDPOINT", "MISSING_QUEUE_ID_AND_SYSTEM_ENDPOINT", "REQUEST_THROTTLED", "IDEMPOTENCY_EXCEPTION", "INTERNAL_ERROR"
resp.failed_request_list[0].failure_reason_message #=> String

Parameters:

  • params (Hash) (defaults to: {})

    ({})

Options Hash (params):

  • :client_token (String)

    A unique, case-sensitive identifier that you provide to ensure the idempotency of the request. If not provided, the Amazon Web Services SDK populates this field. For more information about idempotency, see Making retries safe with idempotent APIs.

    A suitable default value is auto-generated. You should normally not need to pass this option.**

  • :instance_id (required, String)

    The identifier of the Amazon Connect instance. You can find the instance ID in the Amazon Resource Name (ARN) of the instance.

  • :contact_data_request_list (required, Array<Types::ContactDataRequest>)

    List of individual contact requests.

Returns:

See Also:



1295
1296
1297
1298
# File 'gems/aws-sdk-connect/lib/aws-sdk-connect/client.rb', line 1295

def batch_put_contact(params = {}, options = {})
  req = build_request(:batch_put_contact, params)
  req.send_request(options)
end

#claim_phone_number(params = {}) ⇒ Types::ClaimPhoneNumberResponse

Claims an available phone number to your Amazon Connect instance or traffic distribution group. You can call this API only in the same Amazon Web Services Region where the Amazon Connect instance or traffic distribution group was created.

For more information about how to use this operation, see Claim a phone number in your country and Claim phone numbers to traffic distribution groups in the Amazon Connect Administrator Guide.

You can call the SearchAvailablePhoneNumbers API for available phone numbers that you can claim. Call the DescribePhoneNumber API to verify the status of a previous ClaimPhoneNumber operation.

If you plan to claim and release numbers frequently during a 30 day period, contact us for a service quota exception. Otherwise, it is possible you will be blocked from claiming and releasing any more numbers until 30 days past the oldest number released has expired.

By default you can claim and release up to 200% of your maximum number of active phone numbers during any 30 day period. If you claim and release phone numbers using the UI or API during a rolling 30 day cycle that exceeds 200% of your phone number service level quota, you will be blocked from claiming any more numbers until 30 days past the oldest number released has expired.

For example, if you already have 99 claimed numbers and a service level quota of 99 phone numbers, and in any 30 day period you release 99, claim 99, and then release 99, you will have exceeded the 200% limit. At that point you are blocked from claiming any more numbers until you open an Amazon Web Services support ticket.

Examples:

Request syntax with placeholder values


resp = client.claim_phone_number({
  target_arn: "ARN",
  instance_id: "InstanceId",
  phone_number: "PhoneNumber", # required
  phone_number_description: "PhoneNumberDescription",
  tags: {
    "TagKey" => "TagValue",
  },
  client_token: "ClientToken",
})

Response structure


resp.phone_number_id #=> String
resp.phone_number_arn #=> String

Parameters:

  • params (Hash) (defaults to: {})

    ({})

Options Hash (params):

  • :target_arn (String)

    The Amazon Resource Name (ARN) for Amazon Connect instances or traffic distribution groups that phone number inbound traffic is routed through. You must enter InstanceId or TargetArn.

  • :instance_id (String)

    The identifier of the Amazon Connect instance that phone numbers are claimed to. You can find the instance ID in the Amazon Resource Name (ARN) of the instance. You must enter InstanceId or TargetArn.

  • :phone_number (required, String)

    The phone number you want to claim. Phone numbers are formatted [+] [country code] [subscriber number including area code].

  • :phone_number_description (String)

    The description of the phone number.

  • :tags (Hash<String,String>)

    The tags used to organize, track, or control access for this resource. For example, \{ "Tags": {"key1":"value1", "key2":"value2"\} \}.

  • :client_token (String)

    A unique, case-sensitive identifier that you provide to ensure the idempotency of the request. If not provided, the Amazon Web Services SDK populates this field. For more information about idempotency, see Making retries safe with idempotent APIs.

    Pattern: ^[a-f0-9]\{8\}-[a-f0-9]\{4\}-[a-f0-9]\{4\}-[a-f0-9]\{4\}-[a-f0-9]\{12\}$

    A suitable default value is auto-generated. You should normally not need to pass this option.**

Returns:

See Also:



1410
1411
1412
1413
# File 'gems/aws-sdk-connect/lib/aws-sdk-connect/client.rb', line 1410

def claim_phone_number(params = {}, options = {})
  req = build_request(:claim_phone_number, params)
  req.send_request(options)
end

#create_agent_status(params = {}) ⇒ Types::CreateAgentStatusResponse

This API is in preview release for Amazon Connect and is subject to change.

Creates an agent status for the specified Amazon Connect instance.

Examples:

Request syntax with placeholder values


resp = client.create_agent_status({
  instance_id: "InstanceId", # required
  name: "AgentStatusName", # required
  description: "AgentStatusDescription",
  state: "ENABLED", # required, accepts ENABLED, DISABLED
  display_order: 1,
  tags: {
    "TagKey" => "TagValue",
  },
})

Response structure


resp.agent_status_arn #=> String
resp.agent_status_id #=> String

Parameters:

  • params (Hash) (defaults to: {})

    ({})

Options Hash (params):

  • :instance_id (required, String)

    The identifier of the Amazon Connect instance. You can find the instance ID in the Amazon Resource Name (ARN) of the instance.

  • :name (required, String)

    The name of the status.

  • :description (String)

    The description of the status.

  • :state (required, String)

    The state of the status.

  • :display_order (Integer)

    The display order of the status.

  • :tags (Hash<String,String>)

    The tags used to organize, track, or control access for this resource. For example, \{ "Tags": {"key1":"value1", "key2":"value2"\} \}.

Returns:

See Also:



1472
1473
1474
1475
# File 'gems/aws-sdk-connect/lib/aws-sdk-connect/client.rb', line 1472

def create_agent_status(params = {}, options = {})
  req = build_request(:create_agent_status, params)
  req.send_request(options)
end

#create_contact_flow(params = {}) ⇒ Types::CreateContactFlowResponse

Creates a flow for the specified Amazon Connect instance.

You can also create and update flows using the Amazon Connect Flow language.

Examples:

Request syntax with placeholder values


resp = client.create_contact_flow({
  instance_id: "InstanceId", # required
  name: "ContactFlowName", # required
  type: "CONTACT_FLOW", # required, accepts CONTACT_FLOW, CUSTOMER_QUEUE, CUSTOMER_HOLD, CUSTOMER_WHISPER, AGENT_HOLD, AGENT_WHISPER, OUTBOUND_WHISPER, AGENT_TRANSFER, QUEUE_TRANSFER
  description: "ContactFlowDescription",
  content: "ContactFlowContent", # required
  tags: {
    "TagKey" => "TagValue",
  },
})

Response structure


resp.contact_flow_id #=> String
resp.contact_flow_arn #=> String

Parameters:

  • params (Hash) (defaults to: {})

    ({})

Options Hash (params):

  • :instance_id (required, String)

    The identifier of the Amazon Connect instance.

  • :name (required, String)

    The name of the flow.

  • :type (required, String)

    The type of the flow. For descriptions of the available types, see Choose a flow type in the Amazon Connect Administrator Guide.

  • :description (String)

    The description of the flow.

  • :content (required, String)

    The JSON string that represents the content of the flow. For an example, see Example flow in Amazon Connect Flow language.

    Length Constraints: Minimum length of 1. Maximum length of 256000.

  • :tags (Hash<String,String>)

    The tags used to organize, track, or control access for this resource. For example, \{ "Tags": {"key1":"value1", "key2":"value2"\} \}.

Returns:

See Also:



1545
1546
1547
1548
# File 'gems/aws-sdk-connect/lib/aws-sdk-connect/client.rb', line 1545

def create_contact_flow(params = {}, options = {})
  req = build_request(:create_contact_flow, params)
  req.send_request(options)
end

#create_contact_flow_module(params = {}) ⇒ Types::CreateContactFlowModuleResponse

Creates a flow module for the specified Amazon Connect instance.

Examples:

Request syntax with placeholder values


resp = client.create_contact_flow_module({
  instance_id: "InstanceId", # required
  name: "ContactFlowModuleName", # required
  description: "ContactFlowModuleDescription",
  content: "ContactFlowModuleContent", # required
  tags: {
    "TagKey" => "TagValue",
  },
  client_token: "ClientToken",
})

Response structure


resp.id #=> String
resp.arn #=> String

Parameters:

  • params (Hash) (defaults to: {})

    ({})

Options Hash (params):

  • :instance_id (required, String)

    The identifier of the Amazon Connect instance. You can find the instance ID in the Amazon Resource Name (ARN) of the instance.

  • :name (required, String)

    The name of the flow module.

  • :description (String)

    The description of the flow module.

  • :content (required, String)

    The JSON string that represents the content of the flow. For an example, see Example flow in Amazon Connect Flow language.

  • :tags (Hash<String,String>)

    The tags used to organize, track, or control access for this resource. For example, \{ "Tags": {"key1":"value1", "key2":"value2"\} \}.

  • :client_token (String)

    A unique, case-sensitive identifier that you provide to ensure the idempotency of the request. If not provided, the Amazon Web Services SDK populates this field. For more information about idempotency, see Making retries safe with idempotent APIs.

    A suitable default value is auto-generated. You should normally not need to pass this option.**

Returns:

See Also:



1619
1620
1621
1622
# File 'gems/aws-sdk-connect/lib/aws-sdk-connect/client.rb', line 1619

def create_contact_flow_module(params = {}, options = {})
  req = build_request(:create_contact_flow_module, params)
  req.send_request(options)
end

#create_evaluation_form(params = {}) ⇒ Types::CreateEvaluationFormResponse

Creates an evaluation form in the specified Amazon Connect instance. The form can be used to define questions related to agent performance, and create sections to organize such questions. Question and section identifiers cannot be duplicated within the same evaluation form.

Examples:

Request syntax with placeholder values


resp = client.create_evaluation_form({
  instance_id: "InstanceId", # required
  title: "EvaluationFormTitle", # required
  description: "EvaluationFormDescription",
  items: [ # required
    {
      section: {
        title: "EvaluationFormSectionTitle", # required
        ref_id: "ReferenceId", # required
        instructions: "EvaluationFormQuestionInstructions",
        items: { # required
          # recursive EvaluationFormItemsList
        },
        weight: 1.0,
      },
      question: {
        title: "EvaluationFormQuestionTitle", # required
        instructions: "EvaluationFormQuestionInstructions",
        ref_id: "ReferenceId", # required
        not_applicable_enabled: false,
        question_type: "TEXT", # required, accepts TEXT, SINGLESELECT, NUMERIC
        question_type_properties: {
          numeric: {
            min_value: 1, # required
            max_value: 1, # required
            options: [
              {
                min_value: 1, # required
                max_value: 1, # required
                score: 1,
                automatic_fail: false,
              },
            ],
            automation: {
              property_value: {
                label: "OVERALL_CUSTOMER_SENTIMENT_SCORE", # required, accepts OVERALL_CUSTOMER_SENTIMENT_SCORE, OVERALL_AGENT_SENTIMENT_SCORE, NON_TALK_TIME, NON_TALK_TIME_PERCENTAGE, NUMBER_OF_INTERRUPTIONS, CONTACT_DURATION, AGENT_INTERACTION_DURATION, CUSTOMER_HOLD_TIME
              },
            },
          },
          single_select: {
            options: [ # required
              {
                ref_id: "ReferenceId", # required
                text: "EvaluationFormSingleSelectQuestionOptionText", # required
                score: 1,
                automatic_fail: false,
              },
            ],
            display_as: "DROPDOWN", # accepts DROPDOWN, RADIO
            automation: {
              options: [ # required
                {
                  rule_category: {
                    category: "SingleSelectQuestionRuleCategoryAutomationLabel", # required
                    condition: "PRESENT", # required, accepts PRESENT, NOT_PRESENT
                    option_ref_id: "ReferenceId", # required
                  },
                },
              ],
              default_option_ref_id: "ReferenceId",
            },
          },
        },
        weight: 1.0,
      },
    },
  ],
  scoring_strategy: {
    mode: "QUESTION_ONLY", # required, accepts QUESTION_ONLY, SECTION_ONLY
    status: "ENABLED", # required, accepts ENABLED, DISABLED
  },
  client_token: "ClientToken",
})

Response structure


resp.evaluation_form_id #=> String
resp.evaluation_form_arn #=> String

Parameters:

  • params (Hash) (defaults to: {})

    ({})

Options Hash (params):

  • :instance_id (required, String)

    The identifier of the Amazon Connect instance. You can find the instance ID in the Amazon Resource Name (ARN) of the instance.

  • :title (required, String)

    A title of the evaluation form.

  • :description (String)

    The description of the evaluation form.

  • :items (required, Array<Types::EvaluationFormItem>)

    Items that are part of the evaluation form. The total number of sections and questions must not exceed 100 each. Questions must be contained in a section.

  • :scoring_strategy (Types::EvaluationFormScoringStrategy)

    A scoring strategy of the evaluation form.

  • :client_token (String)

    A unique, case-sensitive identifier that you provide to ensure the idempotency of the request. If not provided, the Amazon Web Services SDK populates this field. For more information about idempotency, see Making retries safe with idempotent APIs.

    A suitable default value is auto-generated. You should normally not need to pass this option.**

Returns:

See Also:



1754
1755
1756
1757
# File 'gems/aws-sdk-connect/lib/aws-sdk-connect/client.rb', line 1754

def create_evaluation_form(params = {}, options = {})
  req = build_request(:create_evaluation_form, params)
  req.send_request(options)
end

#create_hours_of_operation(params = {}) ⇒ Types::CreateHoursOfOperationResponse

This API is in preview release for Amazon Connect and is subject to change.

Creates hours of operation.

Examples:

Request syntax with placeholder values


resp = client.create_hours_of_operation({
  instance_id: "InstanceId", # required
  name: "CommonNameLength127", # required
  description: "HoursOfOperationDescription",
  time_zone: "TimeZone", # required
  config: [ # required
    {
      day: "SUNDAY", # required, accepts SUNDAY, MONDAY, TUESDAY, WEDNESDAY, THURSDAY, FRIDAY, SATURDAY
      start_time: { # required
        hours: 1, # required
        minutes: 1, # required
      },
      end_time: { # required
        hours: 1, # required
        minutes: 1, # required
      },
    },
  ],
  tags: {
    "TagKey" => "TagValue",
  },
})

Response structure


resp.hours_of_operation_id #=> String
resp.hours_of_operation_arn #=> String

Parameters:

  • params (Hash) (defaults to: {})

    ({})

Options Hash (params):

  • :instance_id (required, String)

    The identifier of the Amazon Connect instance. You can find the instance ID in the Amazon Resource Name (ARN) of the instance.

  • :name (required, String)

    The name of the hours of operation.

  • :description (String)

    The description of the hours of operation.

  • :time_zone (required, String)

    The time zone of the hours of operation.

  • :config (required, Array<Types::HoursOfOperationConfig>)

    Configuration information for the hours of operation: day, start time, and end time.

  • :tags (Hash<String,String>)

    The tags used to organize, track, or control access for this resource. For example, \{ "Tags": {"key1":"value1", "key2":"value2"\} \}.

Returns:

See Also:



1829
1830
1831
1832
# File 'gems/aws-sdk-connect/lib/aws-sdk-connect/client.rb', line 1829

def create_hours_of_operation(params = {}, options = {})
  req = build_request(:create_hours_of_operation, params)
  req.send_request(options)
end

#create_instance(params = {}) ⇒ Types::CreateInstanceResponse

This API is in preview release for Amazon Connect and is subject to change.

Initiates an Amazon Connect instance with all the supported channels enabled. It does not attach any storage, such as Amazon Simple Storage Service (Amazon S3) or Amazon Kinesis. It also does not allow for any configurations on features, such as Contact Lens for Amazon Connect.

Amazon Connect enforces a limit on the total number of instances that you can create or delete in 30 days. If you exceed this limit, you will get an error message indicating there has been an excessive number of attempts at creating or deleting instances. You must wait 30 days before you can restart creating and deleting instances in your account.

Examples:

Request syntax with placeholder values


resp = client.create_instance({
  client_token: "ClientToken",
  identity_management_type: "SAML", # required, accepts SAML, CONNECT_MANAGED, EXISTING_DIRECTORY
  instance_alias: "DirectoryAlias",
  directory_id: "DirectoryId",
  inbound_calls_enabled: false, # required
  outbound_calls_enabled: false, # required
  tags: {
    "TagKey" => "TagValue",
  },
})

Response structure


resp.id #=> String
resp.arn #=> String

Parameters:

  • params (Hash) (defaults to: {})

    ({})

Options Hash (params):

  • :client_token (String)

    The idempotency token.

  • :identity_management_type (required, String)

    The type of identity management for your Amazon Connect users.

  • :instance_alias (String)

    The name for your instance.

  • :directory_id (String)

    The identifier for the directory.

  • :inbound_calls_enabled (required, Boolean)

    Your contact center handles incoming contacts.

  • :outbound_calls_enabled (required, Boolean)

    Your contact center allows outbound calls.

  • :tags (Hash<String,String>)

    The tags used to organize, track, or control access for this resource. For example, \{ "tags": \{"key1":"value1", "key2":"value2"\} \}.

Returns:

See Also:



1899
1900
1901
1902
# File 'gems/aws-sdk-connect/lib/aws-sdk-connect/client.rb', line 1899

def create_instance(params = {}, options = {})
  req = build_request(:create_instance, params)
  req.send_request(options)
end

#create_integration_association(params = {}) ⇒ Types::CreateIntegrationAssociationResponse

Creates an Amazon Web Services resource association with an Amazon Connect instance.

Examples:

Request syntax with placeholder values


resp = client.create_integration_association({
  instance_id: "InstanceId", # required
  integration_type: "EVENT", # required, accepts EVENT, VOICE_ID, PINPOINT_APP, WISDOM_ASSISTANT, WISDOM_KNOWLEDGE_BASE, WISDOM_QUICK_RESPONSES, CASES_DOMAIN, APPLICATION, FILE_SCANNER
  integration_arn: "ARN", # required
  source_application_url: "URI",
  source_application_name: "SourceApplicationName",
  source_type: "SALESFORCE", # accepts SALESFORCE, ZENDESK, CASES
  tags: {
    "TagKey" => "TagValue",
  },
})

Response structure


resp.integration_association_id #=> String
resp.integration_association_arn #=> String

Parameters:

  • params (Hash) (defaults to: {})

    ({})

Options Hash (params):

  • :instance_id (required, String)

    The identifier of the Amazon Connect instance. You can find the instance ID in the Amazon Resource Name (ARN) of the instance.

  • :integration_type (required, String)

    The type of information to be ingested.

  • :integration_arn (required, String)

    The Amazon Resource Name (ARN) of the integration.

    When integrating with Amazon Pinpoint, the Amazon Connect and Amazon Pinpoint instances must be in the same account.

  • :source_application_url (String)

    The URL for the external application. This field is only required for the EVENT integration type.

  • :source_application_name (String)

    The name of the external application. This field is only required for the EVENT integration type.

  • :source_type (String)

    The type of the data source. This field is only required for the EVENT integration type.

  • :tags (Hash<String,String>)

    The tags used to organize, track, or control access for this resource. For example, \{ "Tags": {"key1":"value1", "key2":"value2"\} \}.

Returns:

See Also:



1971
1972
1973
1974
# File 'gems/aws-sdk-connect/lib/aws-sdk-connect/client.rb', line 1971

def create_integration_association(params = {}, options = {})
  req = build_request(:create_integration_association, params)
  req.send_request(options)
end

#create_participant(params = {}) ⇒ Types::CreateParticipantResponse

Adds a new participant into an on-going chat contact. For more information, see Customize chat flow experiences by integrating custom participants.

Examples:

Request syntax with placeholder values


resp = client.create_participant({
  instance_id: "InstanceId", # required
  contact_id: "ContactId", # required
  client_token: "ClientToken",
  participant_details: { # required
    participant_role: "AGENT", # accepts AGENT, CUSTOMER, SYSTEM, CUSTOM_BOT, SUPERVISOR
    display_name: "DisplayName",
  },
})

Response structure


resp.participant_credentials.participant_token #=> String
resp.participant_credentials.expiry #=> String
resp.participant_id #=> String

Parameters:

  • params (Hash) (defaults to: {})

    ({})

Options Hash (params):

  • :instance_id (required, String)

    The identifier of the Amazon Connect instance. You can find the instance ID in the Amazon Resource Name (ARN) of the instance.

  • :contact_id (required, String)

    The identifier of the contact in this instance of Amazon Connect. Only contacts in the CHAT channel are supported.

  • :client_token (String)

    A unique, case-sensitive identifier that you provide to ensure the idempotency of the request. If not provided, the Amazon Web Services SDK populates this field. For more information about idempotency, see Making retries safe with idempotent APIs.

    A suitable default value is auto-generated. You should normally not need to pass this option.**

  • :participant_details (required, Types::ParticipantDetailsToAdd)

    Information identifying the participant.

    The only Valid value for ParticipantRole is CUSTOM_BOT.

    DisplayName is Required.

Returns:

See Also:



2043
2044
2045
2046
# File 'gems/aws-sdk-connect/lib/aws-sdk-connect/client.rb', line 2043

def create_participant(params = {}, options = {})
  req = build_request(:create_participant, params)
  req.send_request(options)
end

#create_persistent_contact_association(params = {}) ⇒ Types::CreatePersistentContactAssociationResponse

Enables rehydration of chats for the lifespan of a contact. For more information about chat rehydration, see Enable persistent chat in the Amazon Connect Administrator Guide.

Examples:

Request syntax with placeholder values


resp = client.create_persistent_contact_association({
  instance_id: "InstanceId", # required
  initial_contact_id: "ContactId", # required
  rehydration_type: "ENTIRE_PAST_SESSION", # required, accepts ENTIRE_PAST_SESSION, FROM_SEGMENT
  source_contact_id: "ContactId", # required
  client_token: "ClientToken",
})

Response structure


resp.continued_from_contact_id #=> String

Parameters:

  • params (Hash) (defaults to: {})

    ({})

Options Hash (params):

  • :instance_id (required, String)

    The identifier of the Amazon Connect instance. You can find the instance ID in the Amazon Resource Name (ARN) of the instance.

  • :initial_contact_id (required, String)

    This is the contactId of the current contact that the CreatePersistentContactAssociation API is being called from.

  • :rehydration_type (required, String)

    The contactId chosen for rehydration depends on the type chosen.

    • ENTIRE_PAST_SESSION: Rehydrates a chat from the most recently terminated past chat contact of the specified past ended chat session. To use this type, provide the initialContactId of the past ended chat session in the sourceContactId field. In this type, Amazon Connect determines what the most recent chat contact on the past ended chat session and uses it to start a persistent chat.

    • FROM_SEGMENT: Rehydrates a chat from the specified past chat contact provided in the sourceContactId field.

    The actual contactId used for rehydration is provided in the response of this API.

    To illustrate how to use rehydration type, consider the following example: A customer starts a chat session. Agent a1 accepts the chat and a conversation starts between the customer and Agent a1. This first contact creates a contact ID C1. Agent a1 then transfers the chat to Agent a2. This creates another contact ID C2. At this point Agent a2 ends the chat. The customer is forwarded to the disconnect flow for a post chat survey that creates another contact ID C3. After the chat survey, the chat session ends. Later, the customer returns and wants to resume their past chat session. At this point, the customer can have following use cases:

    • Use Case 1: The customer wants to continue the past chat session but they want to hide the post chat survey. For this they will use the following configuration:

      • Configuration

        • SourceContactId = "C2"

        • RehydrationType = "FROM_SEGMENT"

      • Expected behavior

        • This starts a persistent chat session from the specified past ended contact (C2). Transcripts of past chat sessions C2 and C1 are accessible in the current persistent chat session. Note that chat segment C3 is dropped from the persistent chat session.

        ^

    • Use Case 2: The customer wants to continue the past chat session and see the transcript of the entire past engagement, including the post chat survey. For this they will use the following configuration:

      • Configuration

        • SourceContactId = "C1"

        • RehydrationType = "ENTIRE_PAST_SESSION"

      • Expected behavior

        • This starts a persistent chat session from the most recently ended chat contact (C3). Transcripts of past chat sessions C3, C2 and C1 are accessible in the current persistent chat session.

        ^

  • :source_contact_id (required, String)

    The contactId from which a persistent chat session must be started.

  • :client_token (String)

    A unique, case-sensitive identifier that you provide to ensure the idempotency of the request. If not provided, the Amazon Web Services SDK populates this field. For more information about idempotency, see Making retries safe with idempotent APIs.

Returns:

See Also:



2168
2169
2170
2171
# File 'gems/aws-sdk-connect/lib/aws-sdk-connect/client.rb', line 2168

def create_persistent_contact_association(params = {}, options = {})
  req = build_request(:create_persistent_contact_association, params)
  req.send_request(options)
end

#create_predefined_attribute(params = {}) ⇒ Struct

Creates a new predefined attribute for the specified Amazon Connect instance.

Examples:

Request syntax with placeholder values


resp = client.create_predefined_attribute({
  instance_id: "InstanceId", # required
  name: "PredefinedAttributeName", # required
  values: { # required
    string_list: ["PredefinedAttributeStringValue"],
  },
})

Parameters:

  • params (Hash) (defaults to: {})

    ({})

Options Hash (params):

  • :instance_id (required, String)

    The identifier of the Amazon Connect instance. You can find the instance ID in the Amazon Resource Name (ARN) of the instance.

  • :name (required, String)

    The name of the predefined attribute.

  • :values (required, Types::PredefinedAttributeValues)

    The values of the predefined attribute.

Returns:

  • (Struct)

    Returns an empty response.

See Also:



2202
2203
2204
2205
# File 'gems/aws-sdk-connect/lib/aws-sdk-connect/client.rb', line 2202

def create_predefined_attribute(params = {}, options = {})
  req = build_request(:create_predefined_attribute, params)
  req.send_request(options)
end

#create_prompt(params = {}) ⇒ Types::CreatePromptResponse

Creates a prompt. For more information about prompts, such as supported file types and maximum length, see Create prompts in the Amazon Connect Administrator's Guide.

Examples:

Request syntax with placeholder values


resp = client.create_prompt({
  instance_id: "InstanceId", # required
  name: "CommonNameLength127", # required
  description: "PromptDescription",
  s3_uri: "S3Uri", # required
  tags: {
    "TagKey" => "TagValue",
  },
})

Response structure


resp.prompt_arn #=> String
resp.prompt_id #=> String

Parameters:

  • params (Hash) (defaults to: {})

    ({})

Options Hash (params):

  • :instance_id (required, String)

    The identifier of the Amazon Connect instance. You can find the instance ID in the Amazon Resource Name (ARN) of the instance.

  • :name (required, String)

    The name of the prompt.

  • :description (String)

    The description of the prompt.

  • :s3_uri (required, String)

    The URI for the S3 bucket where the prompt is stored. You can provide S3 pre-signed URLs returned by the GetPromptFile API instead of providing S3 URIs.

  • :tags (Hash<String,String>)

    The tags used to organize, track, or control access for this resource. For example, \{ "Tags": {"key1":"value1", "key2":"value2"\} \}.

Returns:

See Also:



2269
2270
2271
2272
# File 'gems/aws-sdk-connect/lib/aws-sdk-connect/client.rb', line 2269

def create_prompt(params = {}, options = {})
  req = build_request(:create_prompt, params)
  req.send_request(options)
end

#create_queue(params = {}) ⇒ Types::CreateQueueResponse

This API is in preview release for Amazon Connect and is subject to change.

Creates a new queue for the specified Amazon Connect instance.

  • If the phone number is claimed to a traffic distribution group that was created in the same Region as the Amazon Connect instance where you are calling this API, then you can use a full phone number ARN or a UUID for OutboundCallerIdNumberId. However, if the phone number is claimed to a traffic distribution group that is in one Region, and you are calling this API from an instance in another Amazon Web Services Region that is associated with the traffic distribution group, you must provide a full phone number ARN. If a UUID is provided in this scenario, you will receive a ResourceNotFoundException.

  • Only use the phone number ARN format that doesn't contain instance in the path, for example, arn:aws:connect:us-east-1:1234567890:phone-number/uuid. This is the same ARN format that is returned when you call the ListPhoneNumbersV2 API.

  • If you plan to use IAM policies to allow/deny access to this API for phone number resources claimed to a traffic distribution group, see Allow or Deny queue API actions for phone numbers in a replica Region.

Examples:

Request syntax with placeholder values


resp = client.create_queue({
  instance_id: "InstanceId", # required
  name: "CommonNameLength127", # required
  description: "QueueDescription",
  outbound_caller_config: {
    outbound_caller_id_name: "OutboundCallerIdName",
    outbound_caller_id_number_id: "PhoneNumberId",
    outbound_flow_id: "ContactFlowId",
  },
  hours_of_operation_id: "HoursOfOperationId", # required
  max_contacts: 1,
  quick_connect_ids: ["QuickConnectId"],
  tags: {
    "TagKey" => "TagValue",
  },
})

Response structure


resp.queue_arn #=> String
resp.queue_id #=> String

Parameters:

  • params (Hash) (defaults to: {})

    ({})

Options Hash (params):

  • :instance_id (required, String)

    The identifier of the Amazon Connect instance. You can find the instance ID in the Amazon Resource Name (ARN) of the instance.

  • :name (required, String)

    The name of the queue.

  • :description (String)

    The description of the queue.

  • :outbound_caller_config (Types::OutboundCallerConfig)

    The outbound caller ID name, number, and outbound whisper flow.

  • :hours_of_operation_id (required, String)

    The identifier for the hours of operation.

  • :max_contacts (Integer)

    The maximum number of contacts that can be in the queue before it is considered full.

  • :quick_connect_ids (Array<String>)

    The quick connects available to agents who are working the queue.

  • :tags (Hash<String,String>)

    The tags used to organize, track, or control access for this resource. For example, \{ "Tags": {"key1":"value1", "key2":"value2"\} \}.

Returns:

See Also:



2371
2372
2373
2374
# File 'gems/aws-sdk-connect/lib/aws-sdk-connect/client.rb', line 2371

def create_queue(params = {}, options = {})
  req = build_request(:create_queue, params)
  req.send_request(options)
end

#create_quick_connect(params = {}) ⇒ Types::CreateQuickConnectResponse

Creates a quick connect for the specified Amazon Connect instance.

Examples:

Request syntax with placeholder values


resp = client.create_quick_connect({
  instance_id: "InstanceId", # required
  name: "QuickConnectName", # required
  description: "QuickConnectDescription",
  quick_connect_config: { # required
    quick_connect_type: "USER", # required, accepts USER, QUEUE, PHONE_NUMBER
    user_config: {
      user_id: "UserId", # required
      contact_flow_id: "ContactFlowId", # required
    },
    queue_config: {
      queue_id: "QueueId", # required
      contact_flow_id: "ContactFlowId", # required
    },
    phone_config: {
      phone_number: "PhoneNumber", # required
    },
  },
  tags: {
    "TagKey" => "TagValue",
  },
})

Response structure


resp.quick_connect_arn #=> String
resp.quick_connect_id #=> String

Parameters:

  • params (Hash) (defaults to: {})

    ({})

Options Hash (params):

  • :instance_id (required, String)

    The identifier of the Amazon Connect instance. You can find the instance ID in the Amazon Resource Name (ARN) of the instance.

  • :name (required, String)

    A unique name of the quick connect.

  • :description (String)

    The description of the quick connect.

  • :quick_connect_config (required, Types::QuickConnectConfig)

    Configuration settings for the quick connect.

  • :tags (Hash<String,String>)

    The tags used to organize, track, or control access for this resource. For example, \{ "Tags": {"key1":"value1", "key2":"value2"\} \}.

Returns:

See Also:



2439
2440
2441
2442
# File 'gems/aws-sdk-connect/lib/aws-sdk-connect/client.rb', line 2439

def create_quick_connect(params = {}, options = {})
  req = build_request(:create_quick_connect, params)
  req.send_request(options)
end

#create_routing_profile(params = {}) ⇒ Types::CreateRoutingProfileResponse

Creates a new routing profile.

Examples:

Request syntax with placeholder values


resp = client.create_routing_profile({
  instance_id: "InstanceId", # required
  name: "RoutingProfileName", # required
  description: "RoutingProfileDescription", # required
  default_outbound_queue_id: "QueueId", # required
  queue_configs: [
    {
      queue_reference: { # required
        queue_id: "QueueId", # required
        channel: "VOICE", # required, accepts VOICE, CHAT, TASK
      },
      priority: 1, # required
      delay: 1, # required
    },
  ],
  media_concurrencies: [ # required
    {
      channel: "VOICE", # required, accepts VOICE, CHAT, TASK
      concurrency: 1, # required
      cross_channel_behavior: {
        behavior_type: "ROUTE_CURRENT_CHANNEL_ONLY", # required, accepts ROUTE_CURRENT_CHANNEL_ONLY, ROUTE_ANY_CHANNEL
      },
    },
  ],
  tags: {
    "TagKey" => "TagValue",
  },
  agent_availability_timer: "TIME_SINCE_LAST_ACTIVITY", # accepts TIME_SINCE_LAST_ACTIVITY, TIME_SINCE_LAST_INBOUND
})

Response structure


resp.routing_profile_arn #=> String
resp.routing_profile_id #=> String

Parameters:

  • params (Hash) (defaults to: {})

    ({})

Options Hash (params):

  • :instance_id (required, String)

    The identifier of the Amazon Connect instance. You can find the instance ID in the Amazon Resource Name (ARN) of the instance.

  • :name (required, String)

    The name of the routing profile. Must not be more than 127 characters.

  • :description (required, String)

    Description of the routing profile. Must not be more than 250 characters.

  • :default_outbound_queue_id (required, String)

    The default outbound queue for the routing profile.

  • :queue_configs (Array<Types::RoutingProfileQueueConfig>)

    The inbound queues associated with the routing profile. If no queue is added, the agent can make only outbound calls.

    The limit of 10 array members applies to the maximum number of RoutingProfileQueueConfig objects that can be passed during a CreateRoutingProfile API request. It is different from the quota of 50 queues per routing profile per instance that is listed in Amazon Connect service quotas.

  • :media_concurrencies (required, Array<Types::MediaConcurrency>)

    The channels that agents can handle in the Contact Control Panel (CCP) for this routing profile.

  • :tags (Hash<String,String>)

    The tags used to organize, track, or control access for this resource. For example, \{ "Tags": {"key1":"value1", "key2":"value2"\} \}.

  • :agent_availability_timer (String)

    Whether agents with this routing profile will have their routing order calculated based on longest idle time or time since their last inbound contact.

Returns:

See Also:



2538
2539
2540
2541
# File 'gems/aws-sdk-connect/lib/aws-sdk-connect/client.rb', line 2538

def create_routing_profile(params = {}, options = {})
  req = build_request(:create_routing_profile, params)
  req.send_request(options)
end

#create_rule(params = {}) ⇒ Types::CreateRuleResponse

Creates a rule for the specified Amazon Connect instance.

Use the Rules Function language to code conditions for the rule.

Examples:

Request syntax with placeholder values


resp = client.create_rule({
  instance_id: "InstanceId", # required
  name: "RuleName", # required
  trigger_event_source: { # required
    event_source_name: "OnPostCallAnalysisAvailable", # required, accepts OnPostCallAnalysisAvailable, OnRealTimeCallAnalysisAvailable, OnRealTimeChatAnalysisAvailable, OnPostChatAnalysisAvailable, OnZendeskTicketCreate, OnZendeskTicketStatusUpdate, OnSalesforceCaseCreate, OnContactEvaluationSubmit, OnMetricDataUpdate, OnCaseCreate, OnCaseUpdate
    integration_association_id: "IntegrationAssociationId",
  },
  function: "RuleFunction", # required
  actions: [ # required
    {
      action_type: "CREATE_TASK", # required, accepts CREATE_TASK, ASSIGN_CONTACT_CATEGORY, GENERATE_EVENTBRIDGE_EVENT, SEND_NOTIFICATION, CREATE_CASE, UPDATE_CASE, END_ASSOCIATED_TASKS
      task_action: {
        name: "TaskNameExpression", # required
        description: "TaskDescriptionExpression",
        contact_flow_id: "ContactFlowId", # required
        references: {
          "ReferenceKey" => {
            value: "ReferenceValue", # required
            type: "URL", # required, accepts URL, ATTACHMENT, NUMBER, STRING, DATE, EMAIL
          },
        },
      },
      event_bridge_action: {
        name: "EventBridgeActionName", # required
      },
      assign_contact_category_action: {
      },
      send_notification_action: {
        delivery_method: "EMAIL", # required, accepts EMAIL
        subject: "Subject",
        content: "Content", # required
        content_type: "PLAIN_TEXT", # required, accepts PLAIN_TEXT
        recipient: { # required
          user_tags: {
            "String" => "String",
          },
          user_ids: ["UserId"],
        },
      },
      create_case_action: {
        fields: [ # required
          {
            id: "FieldValueId", # required
            value: { # required
              boolean_value: false,
              double_value: 1.0,
              empty_value: {
              },
              string_value: "FieldStringValue",
            },
          },
        ],
        template_id: "TemplateId", # required
      },
      update_case_action: {
        fields: [ # required
          {
            id: "FieldValueId", # required
            value: { # required
              boolean_value: false,
              double_value: 1.0,
              empty_value: {
              },
              string_value: "FieldStringValue",
            },
          },
        ],
      },
      end_associated_tasks_action: {
      },
    },
  ],
  publish_status: "DRAFT", # required, accepts DRAFT, PUBLISHED
  client_token: "ClientToken",
})

Response structure


resp.rule_arn #=> String
resp.rule_id #=> String

Parameters:

  • params (Hash) (defaults to: {})

    ({})

Options Hash (params):

  • :instance_id (required, String)

    The identifier of the Amazon Connect instance. You can find the instance ID in the Amazon Resource Name (ARN) of the instance.

  • :name (required, String)

    A unique name for the rule.

  • :trigger_event_source (required, Types::RuleTriggerEventSource)

    The event source to trigger the rule.

  • :function (required, String)

    The conditions of the rule.

  • :actions (required, Array<Types::RuleAction>)

    A list of actions to be run when the rule is triggered.

  • :publish_status (required, String)

    The publish status of the rule.

  • :client_token (String)

    A unique, case-sensitive identifier that you provide to ensure the idempotency of the request. If not provided, the Amazon Web Services SDK populates this field. For more information about idempotency, see Making retries safe with idempotent APIs.

    A suitable default value is auto-generated. You should normally not need to pass this option.**

Returns:

See Also:



2679
2680
2681
2682
# File 'gems/aws-sdk-connect/lib/aws-sdk-connect/client.rb', line 2679

def create_rule(params = {}, options = {})
  req = build_request(:create_rule, params)
  req.send_request(options)
end

#create_security_profile(params = {}) ⇒ Types::CreateSecurityProfileResponse

Creates a security profile.

Examples:

Request syntax with placeholder values


resp = client.create_security_profile({
  security_profile_name: "CreateSecurityProfileName", # required
  description: "SecurityProfileDescription",
  permissions: ["SecurityProfilePermission"],
  instance_id: "InstanceId", # required
  tags: {
    "TagKey" => "TagValue",
  },
  allowed_access_control_tags: {
    "SecurityProfilePolicyKey" => "SecurityProfilePolicyValue",
  },
  tag_restricted_resources: ["TagRestrictedResourceName"],
  applications: [
    {
      namespace: "Namespace",
      application_permissions: ["Permission"],
    },
  ],
})

Response structure


resp.security_profile_id #=> String
resp.security_profile_arn #=> String

Parameters:

  • params (Hash) (defaults to: {})

    ({})

Options Hash (params):

  • :security_profile_name (required, String)

    The name of the security profile.

  • :description (String)

    The description of the security profile.

  • :permissions (Array<String>)

    Permissions assigned to the security profile. For a list of valid permissions, see List of security profile permissions.

  • :instance_id (required, String)

    The identifier of the Amazon Connect instance. You can find the instance ID in the Amazon Resource Name (ARN) of the instance.

  • :tags (Hash<String,String>)

    The tags used to organize, track, or control access for this resource. For example, \{ "Tags": {"key1":"value1", "key2":"value2"\} \}.

  • :allowed_access_control_tags (Hash<String,String>)

    The list of tags that a security profile uses to restrict access to resources in Amazon Connect.

  • :tag_restricted_resources (Array<String>)

    The list of resources that a security profile applies tag restrictions to in Amazon Connect. Following are acceptable ResourceNames: User | SecurityProfile | Queue | RoutingProfile

  • :applications (Array<Types::Application>)

    This API is in preview release for Amazon Connect and is subject to change.

    A list of third-party applications that the security profile will give access to.

Returns:

See Also:



2765
2766
2767
2768
# File 'gems/aws-sdk-connect/lib/aws-sdk-connect/client.rb', line 2765

def create_security_profile(params = {}, options = {})
  req = build_request(:create_security_profile, params)
  req.send_request(options)
end

#create_task_template(params = {}) ⇒ Types::CreateTaskTemplateResponse

Creates a new task template in the specified Amazon Connect instance.

Examples:

Request syntax with placeholder values


resp = client.create_task_template({
  instance_id: "InstanceId", # required
  name: "TaskTemplateName", # required
  description: "TaskTemplateDescription",
  contact_flow_id: "ContactFlowId",
  constraints: {
    required_fields: [
      {
        id: {
          name: "TaskTemplateFieldName",
        },
      },
    ],
    read_only_fields: [
      {
        id: {
          name: "TaskTemplateFieldName",
        },
      },
    ],
    invisible_fields: [
      {
        id: {
          name: "TaskTemplateFieldName",
        },
      },
    ],
  },
  defaults: {
    default_field_values: [
      {
        id: {
          name: "TaskTemplateFieldName",
        },
        default_value: "TaskTemplateFieldValue",
      },
    ],
  },
  status: "ACTIVE", # accepts ACTIVE, INACTIVE
  fields: [ # required
    {
      id: { # required
        name: "TaskTemplateFieldName",
      },
      description: "TaskTemplateFieldDescription",
      type: "NAME", # accepts NAME, DESCRIPTION, SCHEDULED_TIME, QUICK_CONNECT, URL, NUMBER, TEXT, TEXT_AREA, DATE_TIME, BOOLEAN, SINGLE_SELECT, EMAIL
      single_select_options: ["TaskTemplateSingleSelectOption"],
    },
  ],
  client_token: "ClientToken",
})

Response structure


resp.id #=> String
resp.arn #=> String

Parameters:

  • params (Hash) (defaults to: {})

    ({})

Options Hash (params):

  • :instance_id (required, String)

    The identifier of the Amazon Connect instance. You can find the instance ID in the Amazon Resource Name (ARN) of the instance.

  • :name (required, String)

    The name of the task template.

  • :description (String)

    The description of the task template.

  • :contact_flow_id (String)

    The identifier of the flow that runs by default when a task is created by referencing this template.

  • :constraints (Types::TaskTemplateConstraints)

    Constraints that are applicable to the fields listed.

  • :defaults (Types::TaskTemplateDefaults)

    The default values for fields when a task is created by referencing this template.

  • :status (String)

    Marks a template as ACTIVE or INACTIVE for a task to refer to it. Tasks can only be created from ACTIVE templates. If a template is marked as INACTIVE, then a task that refers to this template cannot be created.

  • :fields (required, Array<Types::TaskTemplateField>)

    Fields that are part of the template.

  • :client_token (String)

    A unique, case-sensitive identifier that you provide to ensure the idempotency of the request. If not provided, the Amazon Web Services SDK populates this field. For more information about idempotency, see Making retries safe with idempotent APIs.

    A suitable default value is auto-generated. You should normally not need to pass this option.**

Returns:

See Also:



2887
2888
2889
2890
# File 'gems/aws-sdk-connect/lib/aws-sdk-connect/client.rb', line 2887

def create_task_template(params = {}, options = {})
  req = build_request(:create_task_template, params)
  req.send_request(options)
end

#create_traffic_distribution_group(params = {}) ⇒ Types::CreateTrafficDistributionGroupResponse

Creates a traffic distribution group given an Amazon Connect instance that has been replicated.

The SignInConfig distribution is available only on a default TrafficDistributionGroup (see the IsDefault parameter in the TrafficDistributionGroup data type). If you call UpdateTrafficDistribution with a modified SignInConfig and a non-default TrafficDistributionGroup, an InvalidRequestException is returned.

For more information about creating traffic distribution groups, see Set up traffic distribution groups in the Amazon Connect Administrator Guide.

Examples:

Request syntax with placeholder values


resp = client.create_traffic_distribution_group({
  name: "Name128", # required
  description: "Description250",
  instance_id: "InstanceIdOrArn", # required
  client_token: "ClientToken",
  tags: {
    "TagKey" => "TagValue",
  },
})

Response structure


resp.id #=> String
resp.arn #=> String

Parameters:

  • params (Hash) (defaults to: {})

    ({})

Options Hash (params):

  • :name (required, String)

    The name for the traffic distribution group.

  • :description (String)

    A description for the traffic distribution group.

  • :instance_id (required, String)

    The identifier of the Amazon Connect instance that has been replicated. You can find the instanceId in the ARN of the instance.

  • :client_token (String)

    A unique, case-sensitive identifier that you provide to ensure the idempotency of the request. If not provided, the Amazon Web Services SDK populates this field. For more information about idempotency, see Making retries safe with idempotent APIs.

    A suitable default value is auto-generated. You should normally not need to pass this option.**

  • :tags (Hash<String,String>)

    The tags used to organize, track, or control access for this resource. For example, \{ "Tags": {"key1":"value1", "key2":"value2"\} \}.

Returns:

See Also:



2967
2968
2969
2970
# File 'gems/aws-sdk-connect/lib/aws-sdk-connect/client.rb', line 2967

def create_traffic_distribution_group(params = {}, options = {})
  req = build_request(:create_traffic_distribution_group, params)
  req.send_request(options)
end

#create_use_case(params = {}) ⇒ Types::CreateUseCaseResponse

Creates a use case for an integration association.

Examples:

Request syntax with placeholder values


resp = client.create_use_case({
  instance_id: "InstanceId", # required
  integration_association_id: "IntegrationAssociationId", # required
  use_case_type: "RULES_EVALUATION", # required, accepts RULES_EVALUATION, CONNECT_CAMPAIGNS
  tags: {
    "TagKey" => "TagValue",
  },
})

Response structure


resp.use_case_id #=> String
resp.use_case_arn #=> String

Parameters:

  • params (Hash) (defaults to: {})

    ({})

Options Hash (params):

  • :instance_id (required, String)

    The identifier of the Amazon Connect instance. You can find the instance ID in the Amazon Resource Name (ARN) of the instance.

  • :integration_association_id (required, String)

    The identifier for the integration association.

  • :use_case_type (required, String)

    The type of use case to associate to the integration association. Each integration association can have only one of each use case type.

  • :tags (Hash<String,String>)

    The tags used to organize, track, or control access for this resource. For example, \{ "Tags": {"key1":"value1", "key2":"value2"\} \}.

Returns:

See Also:



3019
3020
3021
3022
# File 'gems/aws-sdk-connect/lib/aws-sdk-connect/client.rb', line 3019

def create_use_case(params = {}, options = {})
  req = build_request(:create_use_case, params)
  req.send_request(options)
end

#create_user(params = {}) ⇒ Types::CreateUserResponse

Creates a user account for the specified Amazon Connect instance.

Certain UserIdentityInfo parameters are required in some situations. For example, Email is required if you are using SAML for identity management. FirstName and LastName are required if you are using Amazon Connect or SAML for identity management.

For information about how to create users using the Amazon Connect admin website, see Add Users in the Amazon Connect Administrator Guide.

Examples:

Request syntax with placeholder values


resp = client.create_user({
  username: "AgentUsername", # required
  password: "Password",
  identity_info: {
    first_name: "AgentFirstName",
    last_name: "AgentLastName",
    email: "Email",
    secondary_email: "Email",
    mobile: "PhoneNumber",
  },
  phone_config: { # required
    phone_type: "SOFT_PHONE", # required, accepts SOFT_PHONE, DESK_PHONE
    auto_accept: false,
    after_contact_work_time_limit: 1,
    desk_phone_number: "PhoneNumber",
  },
  directory_user_id: "DirectoryUserId",
  security_profile_ids: ["SecurityProfileId"], # required
  routing_profile_id: "RoutingProfileId", # required
  hierarchy_group_id: "HierarchyGroupId",
  instance_id: "InstanceId", # required
  tags: {
    "TagKey" => "TagValue",
  },
})

Response structure


resp.user_id #=> String
resp.user_arn #=> String

Parameters:

  • params (Hash) (defaults to: {})

    ({})

Options Hash (params):

  • :username (required, String)

    The user name for the account. For instances not using SAML for identity management, the user name can include up to 20 characters. If you are using SAML for identity management, the user name can include up to 64 characters from [a-zA-Z0-9_-.\@]+.

  • :password (String)

    The password for the user account. A password is required if you are using Amazon Connect for identity management. Otherwise, it is an error to include a password.

  • :identity_info (Types::UserIdentityInfo)

    The information about the identity of the user.

  • :phone_config (required, Types::UserPhoneConfig)

    The phone settings for the user.

  • :directory_user_id (String)

    The identifier of the user account in the directory used for identity management. If Amazon Connect cannot access the directory, you can specify this identifier to authenticate users. If you include the identifier, we assume that Amazon Connect cannot access the directory. Otherwise, the identity information is used to authenticate users from your directory.

    This parameter is required if you are using an existing directory for identity management in Amazon Connect when Amazon Connect cannot access your directory to authenticate users. If you are using SAML for identity management and include this parameter, an error is returned.

  • :security_profile_ids (required, Array<String>)

    The identifier of the security profile for the user.

  • :routing_profile_id (required, String)

    The identifier of the routing profile for the user.

  • :hierarchy_group_id (String)

    The identifier of the hierarchy group for the user.

  • :instance_id (required, String)

    The identifier of the Amazon Connect instance. You can find the instance ID in the Amazon Resource Name (ARN) of the instance.

  • :tags (Hash<String,String>)

    The tags used to organize, track, or control access for this resource. For example, \{ "Tags": {"key1":"value1", "key2":"value2"\} \}.

Returns:

See Also:



3134
3135
3136
3137
# File 'gems/aws-sdk-connect/lib/aws-sdk-connect/client.rb', line 3134

def create_user(params = {}, options = {})
  req = build_request(:create_user, params)
  req.send_request(options)
end

#create_user_hierarchy_group(params = {}) ⇒ Types::CreateUserHierarchyGroupResponse

Creates a new user hierarchy group.

Examples:

Request syntax with placeholder values


resp = client.create_user_hierarchy_group({
  name: "HierarchyGroupName", # required
  parent_group_id: "HierarchyGroupId",
  instance_id: "InstanceId", # required
  tags: {
    "TagKey" => "TagValue",
  },
})

Response structure


resp.hierarchy_group_id #=> String
resp.hierarchy_group_arn #=> String

Parameters:

  • params (Hash) (defaults to: {})

    ({})

Options Hash (params):

  • :name (required, String)

    The name of the user hierarchy group. Must not be more than 100 characters.

  • :parent_group_id (String)

    The identifier for the parent hierarchy group. The user hierarchy is created at level one if the parent group ID is null.

  • :instance_id (required, String)

    The identifier of the Amazon Connect instance. You can find the instance ID in the Amazon Resource Name (ARN) of the instance.

  • :tags (Hash<String,String>)

    The tags used to organize, track, or control access for this resource. For example, \{ "Tags": {"key1":"value1", "key2":"value2"\} \}.

Returns:

See Also:



3187
3188
3189
3190
# File 'gems/aws-sdk-connect/lib/aws-sdk-connect/client.rb', line 3187

def create_user_hierarchy_group(params = {}, options = {})
  req = build_request(:create_user_hierarchy_group, params)
  req.send_request(options)
end

#create_view(params = {}) ⇒ Types::CreateViewResponse

Creates a new view with the possible status of SAVED or PUBLISHED.

The views will have a unique name for each connect instance.

It performs basic content validation if the status is SAVED or full content validation if the status is set to PUBLISHED. An error is returned if validation fails. It associates either the $SAVED qualifier or both of the $SAVED and $LATEST qualifiers with the provided view content based on the status. The view is idempotent if ClientToken is provided.

Examples:

Request syntax with placeholder values


resp = client.create_view({
  instance_id: "ViewsInstanceId", # required
  client_token: "ViewsClientToken",
  status: "PUBLISHED", # required, accepts PUBLISHED, SAVED
  content: { # required
    template: "ViewTemplate",
    actions: ["ViewAction"],
  },
  description: "ViewDescription",
  name: "ViewName", # required
  tags: {
    "TagKey" => "TagValue",
  },
})

Response structure


resp.view.id #=> String
resp.view.arn #=> String
resp.view.name #=> String
resp.view.status #=> String, one of "PUBLISHED", "SAVED"
resp.view.type #=> String, one of "CUSTOMER_MANAGED", "AWS_MANAGED"
resp.view.description #=> String
resp.view.version #=> Integer
resp.view.version_description #=> String
resp.view.content.input_schema #=> String
resp.view.content.template #=> String
resp.view.content.actions #=> Array
resp.view.content.actions[0] #=> String
resp.view.tags #=> Hash
resp.view.tags["TagKey"] #=> String
resp.view.created_time #=> Time
resp.view.last_modified_time #=> Time
resp.view.view_content_sha_256 #=> String

Parameters:

  • params (Hash) (defaults to: {})

    ({})

Options Hash (params):

  • :instance_id (required, String)

    The identifier of the Amazon Connect instance. You can find the instanceId in the ARN of the instance.

  • :client_token (String)

    A unique Id for each create view request to avoid duplicate view creation. For example, the view is idempotent ClientToken is provided.

  • :status (required, String)

    Indicates the view status as either SAVED or PUBLISHED. The PUBLISHED status will initiate validation on the content.

  • :content (required, Types::ViewInputContent)

    View content containing all content necessary to render a view except for runtime input data.

    The total uncompressed content has a maximum file size of 400kB.

  • :description (String)

    The description of the view.

  • :name (required, String)

    The name of the view.

  • :tags (Hash<String,String>)

    The tags associated with the view resource (not specific to view version).These tags can be used to organize, track, or control access for this resource. For example, \{ "tags": {"key1":"value1", "key2":"value2"\} \}.

Returns:

See Also:



3278
3279
3280
3281
# File 'gems/aws-sdk-connect/lib/aws-sdk-connect/client.rb', line 3278

def create_view(params = {}, options = {})
  req = build_request(:create_view, params)
  req.send_request(options)
end

#create_view_version(params = {}) ⇒ Types::CreateViewVersionResponse

Publishes a new version of the view identifier.

Versions are immutable and monotonically increasing.

It returns the highest version if there is no change in content compared to that version. An error is displayed if the supplied ViewContentSha256 is different from the ViewContentSha256 of the $LATEST alias.

Examples:

Request syntax with placeholder values


resp = client.create_view_version({
  instance_id: "ViewsInstanceId", # required
  view_id: "ViewId", # required
  version_description: "ViewDescription",
  view_content_sha_256: "ViewContentSha256",
})

Response structure


resp.view.id #=> String
resp.view.arn #=> String
resp.view.name #=> String
resp.view.status #=> String, one of "PUBLISHED", "SAVED"
resp.view.type #=> String, one of "CUSTOMER_MANAGED", "AWS_MANAGED"
resp.view.description #=> String
resp.view.version #=> Integer
resp.view.version_description #=> String
resp.view.content.input_schema #=> String
resp.view.content.template #=> String
resp.view.content.actions #=> Array
resp.view.content.actions[0] #=> String
resp.view.tags #=> Hash
resp.view.tags["TagKey"] #=> String
resp.view.created_time #=> Time
resp.view.last_modified_time #=> Time
resp.view.view_content_sha_256 #=> String

Parameters:

  • params (Hash) (defaults to: {})

    ({})

Options Hash (params):

  • :instance_id (required, String)

    The identifier of the Amazon Connect instance. You can find the instanceId in the ARN of the instance.

  • :view_id (required, String)

    The identifier of the view. Both ViewArn and ViewId can be used.

  • :version_description (String)

    The description for the version being published.

  • :view_content_sha_256 (String)

    Indicates the checksum value of the latest published view content.

Returns:

See Also:



3342
3343
3344
3345
# File 'gems/aws-sdk-connect/lib/aws-sdk-connect/client.rb', line 3342

def create_view_version(params = {}, options = {})
  req = build_request(:create_view_version, params)
  req.send_request(options)
end

#create_vocabulary(params = {}) ⇒ Types::CreateVocabularyResponse

Creates a custom vocabulary associated with your Amazon Connect instance. You can set a custom vocabulary to be your default vocabulary for a given language. Contact Lens for Amazon Connect uses the default vocabulary in post-call and real-time contact analysis sessions for that language.

Examples:

Request syntax with placeholder values


resp = client.create_vocabulary({
  client_token: "ClientToken",
  instance_id: "InstanceId", # required
  vocabulary_name: "VocabularyName", # required
  language_code: "ar-AE", # required, accepts ar-AE, de-CH, de-DE, en-AB, en-AU, en-GB, en-IE, en-IN, en-US, en-WL, es-ES, es-US, fr-CA, fr-FR, hi-IN, it-IT, ja-JP, ko-KR, pt-BR, pt-PT, zh-CN, en-NZ, en-ZA
  content: "VocabularyContent", # required
  tags: {
    "TagKey" => "TagValue",
  },
})

Response structure


resp.vocabulary_arn #=> String
resp.vocabulary_id #=> String
resp.state #=> String, one of "CREATION_IN_PROGRESS", "ACTIVE", "CREATION_FAILED", "DELETE_IN_PROGRESS"

Parameters:

  • params (Hash) (defaults to: {})

    ({})

Options Hash (params):

  • :client_token (String)

    A unique, case-sensitive identifier that you provide to ensure the idempotency of the request. If not provided, the Amazon Web Services SDK populates this field. For more information about idempotency, see Making retries safe with idempotent APIs. If a create request is received more than once with same client token, subsequent requests return the previous response without creating a vocabulary again.

    A suitable default value is auto-generated. You should normally not need to pass this option.**

  • :instance_id (required, String)

    The identifier of the Amazon Connect instance. You can find the instance ID in the Amazon Resource Name (ARN) of the instance.

  • :vocabulary_name (required, String)

    A unique name of the custom vocabulary.

  • :language_code (required, String)

    The language code of the vocabulary entries. For a list of languages and their corresponding language codes, see What is Amazon Transcribe?

  • :content (required, String)

    The content of the custom vocabulary in plain-text format with a table of values. Each row in the table represents a word or a phrase, described with Phrase, IPA, SoundsLike, and DisplayAs fields. Separate the fields with TAB characters. The size limit is 50KB. For more information, see Create a custom vocabulary using a table.

  • :tags (Hash<String,String>)

    The tags used to organize, track, or control access for this resource. For example, \{ "Tags": {"key1":"value1", "key2":"value2"\} \}.

Returns:

See Also:



3433
3434
3435
3436
# File 'gems/aws-sdk-connect/lib/aws-sdk-connect/client.rb', line 3433

def create_vocabulary(params = {}, options = {})
  req = build_request(:create_vocabulary, params)
  req.send_request(options)
end

#deactivate_evaluation_form(params = {}) ⇒ Types::DeactivateEvaluationFormResponse

Deactivates an evaluation form in the specified Amazon Connect instance. After a form is deactivated, it is no longer available for users to start new evaluations based on the form.

Examples:

Request syntax with placeholder values


resp = client.deactivate_evaluation_form({
  instance_id: "InstanceId", # required
  evaluation_form_id: "ResourceId", # required
  evaluation_form_version: 1, # required
})

Response structure


resp.evaluation_form_id #=> String
resp.evaluation_form_arn #=> String
resp.evaluation_form_version #=> Integer

Parameters:

  • params (Hash) (defaults to: {})

    ({})

Options Hash (params):

  • :instance_id (required, String)

    The identifier of the Amazon Connect instance. You can find the instance ID in the Amazon Resource Name (ARN) of the instance.

  • :evaluation_form_id (required, String)

    The unique identifier for the evaluation form.

  • :evaluation_form_version (required, Integer)

    A version of the evaluation form. If the version property is not provided, the latest version of the evaluation form is deactivated.

Returns:

See Also:



3481
3482
3483
3484
# File 'gems/aws-sdk-connect/lib/aws-sdk-connect/client.rb', line 3481

def deactivate_evaluation_form(params = {}, options = {})
  req = build_request(:deactivate_evaluation_form, params)
  req.send_request(options)
end

#delete_contact_evaluation(params = {}) ⇒ Struct

Deletes a contact evaluation in the specified Amazon Connect instance.

Examples:

Request syntax with placeholder values


resp = client.delete_contact_evaluation({
  instance_id: "InstanceId", # required
  evaluation_id: "ResourceId", # required
})

Parameters:

  • params (Hash) (defaults to: {})

    ({})

Options Hash (params):

  • :instance_id (required, String)

    The identifier of the Amazon Connect instance. You can find the instance ID in the Amazon Resource Name (ARN) of the instance.

  • :evaluation_id (required, String)

    A unique identifier for the contact evaluation.

Returns:

  • (Struct)

    Returns an empty response.

See Also:



3512
3513
3514
3515
# File 'gems/aws-sdk-connect/lib/aws-sdk-connect/client.rb', line 3512

def delete_contact_evaluation(params = {}, options = {})
  req = build_request(:delete_contact_evaluation, params)
  req.send_request(options)
end

#delete_contact_flow(params = {}) ⇒ Struct

Deletes a flow for the specified Amazon Connect instance.

Examples:

Request syntax with placeholder values


resp = client.delete_contact_flow({
  instance_id: "InstanceId", # required
  contact_flow_id: "ContactFlowId", # required
})

Parameters:

  • params (Hash) (defaults to: {})

    ({})

Options Hash (params):

  • :instance_id (required, String)

    The identifier of the Amazon Connect instance. You can find the instance ID in the Amazon Resource Name (ARN) of the instance.

  • :contact_flow_id (required, String)

    The identifier of the flow.

Returns:

  • (Struct)

    Returns an empty response.

See Also:



3543
3544
3545
3546
# File 'gems/aws-sdk-connect/lib/aws-sdk-connect/client.rb', line 3543

def delete_contact_flow(params = {}, options = {})
  req = build_request(:delete_contact_flow, params)
  req.send_request(options)
end

#delete_contact_flow_module(params = {}) ⇒ Struct

Deletes the specified flow module.

Examples:

Request syntax with placeholder values


resp = client.delete_contact_flow_module({
  instance_id: "InstanceId", # required
  contact_flow_module_id: "ContactFlowModuleId", # required
})

Parameters:

  • params (Hash) (defaults to: {})

    ({})

Options Hash (params):

  • :instance_id (required, String)

    The identifier of the Amazon Connect instance. You can find the instance ID in the Amazon Resource Name (ARN) of the instance.

  • :contact_flow_module_id (required, String)

    The identifier of the flow module.

Returns:

  • (Struct)

    Returns an empty response.

See Also:



3574
3575
3576
3577
# File 'gems/aws-sdk-connect/lib/aws-sdk-connect/client.rb', line 3574

def delete_contact_flow_module(params = {}, options = {})
  req = build_request(:delete_contact_flow_module, params)
  req.send_request(options)
end

#delete_evaluation_form(params = {}) ⇒ Struct

Deletes an evaluation form in the specified Amazon Connect instance.

  • If the version property is provided, only the specified version of the evaluation form is deleted.

  • If no version is provided, then the full form (all versions) is deleted.

Examples:

Request syntax with placeholder values


resp = client.delete_evaluation_form({
  instance_id: "InstanceId", # required
  evaluation_form_id: "ResourceId", # required
  evaluation_form_version: 1,
})

Parameters:

  • params (Hash) (defaults to: {})

    ({})

Options Hash (params):

  • :instance_id (required, String)

    The identifier of the Amazon Connect instance. You can find the instance ID in the Amazon Resource Name (ARN) of the instance.

  • :evaluation_form_id (required, String)

    The unique identifier for the evaluation form.

  • :evaluation_form_version (Integer)

    The unique identifier for the evaluation form.

Returns:

  • (Struct)

    Returns an empty response.

See Also:



3615
3616
3617
3618
# File 'gems/aws-sdk-connect/lib/aws-sdk-connect/client.rb', line 3615

def delete_evaluation_form(params = {}, options = {})
  req = build_request(:delete_evaluation_form, params)
  req.send_request(options)
end

#delete_hours_of_operation(params = {}) ⇒ Struct

This API is in preview release for Amazon Connect and is subject to change.

Deletes an hours of operation.

Examples:

Request syntax with placeholder values


resp = client.delete_hours_of_operation({
  instance_id: "InstanceId", # required
  hours_of_operation_id: "HoursOfOperationId", # required
})

Parameters:

  • params (Hash) (defaults to: {})

    ({})

Options Hash (params):

  • :instance_id (required, String)

    The identifier of the Amazon Connect instance. You can find the instance ID in the Amazon Resource Name (ARN) of the instance.

  • :hours_of_operation_id (required, String)

    The identifier for the hours of operation.

Returns:

  • (Struct)

    Returns an empty response.

See Also:



3649
3650
3651
3652
# File 'gems/aws-sdk-connect/lib/aws-sdk-connect/client.rb', line 3649

def delete_hours_of_operation(params = {}, options = {})
  req = build_request(:delete_hours_of_operation, params)
  req.send_request(options)
end

#delete_instance(params = {}) ⇒ Struct

This API is in preview release for Amazon Connect and is subject to change.

Deletes the Amazon Connect instance.

Amazon Connect enforces a limit on the total number of instances that you can create or delete in 30 days. If you exceed this limit, you will get an error message indicating there has been an excessive number of attempts at creating or deleting instances. You must wait 30 days before you can restart creating and deleting instances in your account.

Examples:

Request syntax with placeholder values


resp = client.delete_instance({
  instance_id: "InstanceId", # required
})

Parameters:

  • params (Hash) (defaults to: {})

    ({})

Options Hash (params):

  • :instance_id (required, String)

    The identifier of the Amazon Connect instance. You can find the instance ID in the Amazon Resource Name (ARN) of the instance.

Returns:

  • (Struct)

    Returns an empty response.

See Also:



3686
3687
3688
3689
# File 'gems/aws-sdk-connect/lib/aws-sdk-connect/client.rb', line 3686

def delete_instance(params = {}, options = {})
  req = build_request(:delete_instance, params)
  req.send_request(options)
end

#delete_integration_association(params = {}) ⇒ Struct

Deletes an Amazon Web Services resource association from an Amazon Connect instance. The association must not have any use cases associated with it.

Examples:

Request syntax with placeholder values


resp = client.delete_integration_association({
  instance_id: "InstanceId", # required
  integration_association_id: "IntegrationAssociationId", # required
})

Parameters:

  • params (Hash) (defaults to: {})

    ({})

Options Hash (params):

  • :instance_id (required, String)

    The identifier of the Amazon Connect instance. You can find the instance ID in the Amazon Resource Name (ARN) of the instance.

  • :integration_association_id (required, String)

    The identifier for the integration association.

Returns:

  • (Struct)

    Returns an empty response.

See Also:



3719
3720
3721
3722
# File 'gems/aws-sdk-connect/lib/aws-sdk-connect/client.rb', line 3719

def delete_integration_association(params = {}, options = {})
  req = build_request(:delete_integration_association, params)
  req.send_request(options)
end

#delete_predefined_attribute(params = {}) ⇒ Struct

Deletes a predefined attribute from the specified Amazon Connect instance.

Examples:

Request syntax with placeholder values


resp = client.delete_predefined_attribute({
  instance_id: "InstanceId", # required
  name: "PredefinedAttributeName", # required
})

Parameters:

  • params (Hash) (defaults to: {})

    ({})

Options Hash (params):

  • :instance_id (required, String)

    The identifier of the Amazon Connect instance. You can find the instance ID in the Amazon Resource Name (ARN) of the instance.

  • :name (required, String)

    The name of the predefined attribute.

Returns:

  • (Struct)

    Returns an empty response.

See Also:



3747
3748
3749
3750
# File 'gems/aws-sdk-connect/lib/aws-sdk-connect/client.rb', line 3747

def delete_predefined_attribute(params = {}, options = {})
  req = build_request(:delete_predefined_attribute, params)
  req.send_request(options)
end

#delete_prompt(params = {}) ⇒ Struct

Deletes a prompt.

Examples:

Request syntax with placeholder values


resp = client.delete_prompt({
  instance_id: "InstanceId", # required
  prompt_id: "PromptId", # required
})

Parameters:

  • params (Hash) (defaults to: {})

    ({})

Options Hash (params):

  • :instance_id (required, String)

    The identifier of the Amazon Connect instance. You can find the instance ID in the Amazon Resource Name (ARN) of the instance.

  • :prompt_id (required, String)

    A unique identifier for the prompt.

Returns:

  • (Struct)

    Returns an empty response.

See Also:



3778
3779
3780
3781
# File 'gems/aws-sdk-connect/lib/aws-sdk-connect/client.rb', line 3778

def delete_prompt(params = {}, options = {})
  req = build_request(:delete_prompt, params)
  req.send_request(options)
end

#delete_queue(params = {}) ⇒ Struct

Deletes a queue.

Examples:

Request syntax with placeholder values


resp = client.delete_queue({
  instance_id: "InstanceId", # required
  queue_id: "QueueId", # required
})

Parameters:

  • params (Hash) (defaults to: {})

    ({})

Options Hash (params):

  • :instance_id (required, String)

    The identifier of the Amazon Connect instance. You can find the instance ID in the Amazon Resource Name (ARN) of the instance.

  • :queue_id (required, String)

    The identifier for the queue.

Returns:

  • (Struct)

    Returns an empty response.

See Also:



3809
3810
3811
3812
# File 'gems/aws-sdk-connect/lib/aws-sdk-connect/client.rb', line 3809

def delete_queue(params = {}, options = {})
  req = build_request(:delete_queue, params)
  req.send_request(options)
end

#delete_quick_connect(params = {}) ⇒ Struct

Deletes a quick connect.

Examples:

Request syntax with placeholder values


resp = client.delete_quick_connect({
  instance_id: "InstanceId", # required
  quick_connect_id: "QuickConnectId", # required
})

Parameters:

  • params (Hash) (defaults to: {})

    ({})

Options Hash (params):

  • :instance_id (required, String)

    The identifier of the Amazon Connect instance. You can find the instance ID in the Amazon Resource Name (ARN) of the instance.

  • :quick_connect_id (required, String)

    The identifier for the quick connect.

Returns:

  • (Struct)

    Returns an empty response.

See Also:



3840
3841
3842
3843
# File 'gems/aws-sdk-connect/lib/aws-sdk-connect/client.rb', line 3840

def delete_quick_connect(params = {}, options = {})
  req = build_request(:delete_quick_connect, params)
  req.send_request(options)
end

#delete_routing_profile(params = {}) ⇒ Struct

Deletes a routing profile.

Examples:

Request syntax with placeholder values


resp = client.delete_routing_profile({
  instance_id: "InstanceId", # required
  routing_profile_id: "RoutingProfileId", # required
})

Parameters:

  • params (Hash) (defaults to: {})

    ({})

Options Hash (params):

  • :instance_id (required, String)

    The identifier of the Amazon Connect instance. You can find the instance ID in the Amazon Resource Name (ARN) of the instance.

  • :routing_profile_id (required, String)

    The identifier of the routing profile.

Returns:

  • (Struct)

    Returns an empty response.

See Also:



3871
3872
3873
3874
# File 'gems/aws-sdk-connect/lib/aws-sdk-connect/client.rb', line 3871

def delete_routing_profile(params = {}, options = {})
  req = build_request(:delete_routing_profile, params)
  req.send_request(options)
end

#delete_rule(params = {}) ⇒ Struct

Deletes a rule for the specified Amazon Connect instance.

Examples:

Request syntax with placeholder values


resp = client.delete_rule({
  instance_id: "InstanceId", # required
  rule_id: "RuleId", # required
})

Parameters:

  • params (Hash) (defaults to: {})

    ({})

Options Hash (params):

  • :instance_id (required, String)

    The identifier of the Amazon Connect instance. You can find the instance ID in the Amazon Resource Name (ARN) of the instance.

  • :rule_id (required, String)

    A unique identifier for the rule.

Returns:

  • (Struct)

    Returns an empty response.

See Also:



3902
3903
3904
3905
# File 'gems/aws-sdk-connect/lib/aws-sdk-connect/client.rb', line 3902

def delete_rule(params = {}, options = {})
  req = build_request(:delete_rule, params)
  req.send_request(options)
end

#delete_security_profile(params = {}) ⇒ Struct

Deletes a security profile.

Examples:

Request syntax with placeholder values


resp = client.delete_security_profile({
  instance_id: "InstanceId", # required
  security_profile_id: "SecurityProfileId", # required
})

Parameters:

  • params (Hash) (defaults to: {})

    ({})

Options Hash (params):

  • :instance_id (required, String)

    The identifier of the Amazon Connect instance. You can find the instance ID in the Amazon Resource Name (ARN) of the instance.

  • :security_profile_id (required, String)

    The identifier for the security profle.

Returns:

  • (Struct)

    Returns an empty response.

See Also:



3933
3934
3935
3936
# File 'gems/aws-sdk-connect/lib/aws-sdk-connect/client.rb', line 3933

def delete_security_profile(params = {}, options = {})
  req = build_request(:delete_security_profile, params)
  req.send_request(options)
end

#delete_task_template(params = {}) ⇒ Struct

Deletes the task template.

Examples:

Request syntax with placeholder values


resp = client.delete_task_template({
  instance_id: "InstanceId", # required
  task_template_id: "TaskTemplateId", # required
})

Parameters:

  • params (Hash) (defaults to: {})

    ({})

Options Hash (params):

  • :instance_id (required, String)

    The identifier of the Amazon Connect instance. You can find the instance ID in the Amazon Resource Name (ARN) of the instance.

  • :task_template_id (required, String)

    A unique identifier for the task template.

Returns:

  • (Struct)

    Returns an empty response.

See Also:



3964
3965
3966
3967
# File 'gems/aws-sdk-connect/lib/aws-sdk-connect/client.rb', line 3964

def delete_task_template(params = {}, options = {})
  req = build_request(:delete_task_template, params)
  req.send_request(options)
end

#delete_traffic_distribution_group(params = {}) ⇒ Struct

Deletes a traffic distribution group. This API can be called only in the Region where the traffic distribution group is created.

For more information about deleting traffic distribution groups, see Delete traffic distribution groups in the Amazon Connect Administrator Guide.

Examples:

Request syntax with placeholder values


resp = client.delete_traffic_distribution_group({
  traffic_distribution_group_id: "TrafficDistributionGroupIdOrArn", # required
})

Parameters:

  • params (Hash) (defaults to: {})

    ({})

Options Hash (params):

  • :traffic_distribution_group_id (required, String)

    The identifier of the traffic distribution group. This can be the ID or the ARN if the API is being called in the Region where the traffic distribution group was created. The ARN must be provided if the call is from the replicated Region.

Returns:

  • (Struct)

    Returns an empty response.

See Also:



3998
3999
4000
4001
# File 'gems/aws-sdk-connect/lib/aws-sdk-connect/client.rb', line 3998

def delete_traffic_distribution_group(params = {}, options = {})
  req = build_request(:delete_traffic_distribution_group, params)
  req.send_request(options)
end

#delete_use_case(params = {}) ⇒ Struct

Deletes a use case from an integration association.

Examples:

Request syntax with placeholder values


resp = client.delete_use_case({
  instance_id: "InstanceId", # required
  integration_association_id: "IntegrationAssociationId", # required
  use_case_id: "UseCaseId", # required
})

Parameters:

  • params (Hash) (defaults to: {})

    ({})

Options Hash (params):

  • :instance_id (required, String)

    The identifier of the Amazon Connect instance. You can find the instance ID in the Amazon Resource Name (ARN) of the instance.

  • :integration_association_id (required, String)

    The identifier for the integration association.

  • :use_case_id (required, String)

    The identifier for the use case.

Returns:

  • (Struct)

    Returns an empty response.

See Also:



4033
4034
4035
4036
# File 'gems/aws-sdk-connect/lib/aws-sdk-connect/client.rb', line 4033

def delete_use_case(params = {}, options = {})
  req = build_request(:delete_use_case, params)
  req.send_request(options)
end

#delete_user(params = {}) ⇒ Struct

Deletes a user account from the specified Amazon Connect instance.

For information about what happens to a user's data when their account is deleted, see Delete Users from Your Amazon Connect Instance in the Amazon Connect Administrator Guide.

Examples:

Request syntax with placeholder values


resp = client.delete_user({
  instance_id: "InstanceId", # required
  user_id: "UserId", # required
})

Parameters:

  • params (Hash) (defaults to: {})

    ({})

Options Hash (params):

  • :instance_id (required, String)

    The identifier of the Amazon Connect instance. You can find the instance ID in the Amazon Resource Name (ARN) of the instance.

  • :user_id (required, String)

    The identifier of the user.

Returns:

  • (Struct)

    Returns an empty response.

See Also:



4072
4073
4074
4075
# File 'gems/aws-sdk-connect/lib/aws-sdk-connect/client.rb', line 4072

def delete_user(params = {}, options = {})
  req = build_request(:delete_user, params)
  req.send_request(options)
end

#delete_user_hierarchy_group(params = {}) ⇒ Struct

Deletes an existing user hierarchy group. It must not be associated with any agents or have any active child groups.

Examples:

Request syntax with placeholder values


resp = client.delete_user_hierarchy_group({
  hierarchy_group_id: "HierarchyGroupId", # required
  instance_id: "InstanceId", # required
})

Parameters:

  • params (Hash) (defaults to: {})

    ({})

Options Hash (params):

  • :hierarchy_group_id (required, String)

    The identifier of the hierarchy group.

  • :instance_id (required, String)

    The identifier of the Amazon Connect instance. You can find the instance ID in the Amazon Resource Name (ARN) of the instance.

Returns:

  • (Struct)

    Returns an empty response.

See Also:



4104
4105
4106
4107
# File 'gems/aws-sdk-connect/lib/aws-sdk-connect/client.rb', line 4104

def delete_user_hierarchy_group(params = {}, options = {})
  req = build_request(:delete_user_hierarchy_group, params)
  req.send_request(options)
end

#delete_view(params = {}) ⇒ Struct

Deletes the view entirely. It deletes the view and all associated qualifiers (versions and aliases).

Examples:

Request syntax with placeholder values


resp = client.delete_view({
  instance_id: "ViewsInstanceId", # required
  view_id: "ViewId", # required
})

Parameters:

  • params (Hash) (defaults to: {})

    ({})

Options Hash (params):

  • :instance_id (required, String)

    The identifier of the Amazon Connect instance. You can find the instanceId in the ARN of the instance.

  • :view_id (required, String)

    The identifier of the view. Both ViewArn and ViewId can be used.

Returns:

  • (Struct)

    Returns an empty response.

See Also:



4132
4133
4134
4135
# File 'gems/aws-sdk-connect/lib/aws-sdk-connect/client.rb', line 4132

def delete_view(params = {}, options = {})
  req = build_request(:delete_view, params)
  req.send_request(options)
end

#delete_view_version(params = {}) ⇒ Struct

Deletes the particular version specified in ViewVersion identifier.

Examples:

Request syntax with placeholder values


resp = client.delete_view_version({
  instance_id: "ViewsInstanceId", # required
  view_id: "ViewId", # required
  view_version: 1, # required
})

Parameters:

  • params (Hash) (defaults to: {})

    ({})

Options Hash (params):

  • :instance_id (required, String)

    The identifier of the Amazon Connect instance. You can find the instanceId in the ARN of the instance.

  • :view_id (required, String)

    The identifier of the view. Both ViewArn and ViewId can be used.

  • :view_version (required, Integer)

    The version number of the view.

Returns:

  • (Struct)

    Returns an empty response.

See Also:



4163
4164
4165
4166
# File 'gems/aws-sdk-connect/lib/aws-sdk-connect/client.rb', line 4163

def delete_view_version(params = {}, options = {})
  req = build_request(:delete_view_version, params)
  req.send_request(options)
end

#delete_vocabulary(params = {}) ⇒ Types::DeleteVocabularyResponse

Deletes the vocabulary that has the given identifier.

Examples:

Request syntax with placeholder values


resp = client.delete_vocabulary({
  instance_id: "InstanceId", # required
  vocabulary_id: "VocabularyId", # required
})

Response structure


resp.vocabulary_arn #=> String
resp.vocabulary_id #=> String
resp.state #=> String, one of "CREATION_IN_PROGRESS", "ACTIVE", "CREATION_FAILED", "DELETE_IN_PROGRESS"

Parameters:

  • params (Hash) (defaults to: {})

    ({})

Options Hash (params):

  • :instance_id (required, String)

    The identifier of the Amazon Connect instance. You can find the instance ID in the Amazon Resource Name (ARN) of the instance.

  • :vocabulary_id (required, String)

    The identifier of the custom vocabulary.

Returns:

See Also:



4204
4205
4206
4207
# File 'gems/aws-sdk-connect/lib/aws-sdk-connect/client.rb', line 4204

def delete_vocabulary(params = {}, options = {})
  req = build_request(:delete_vocabulary, params)
  req.send_request(options)
end

#describe_agent_status(params = {}) ⇒ Types::DescribeAgentStatusResponse

This API is in preview release for Amazon Connect and is subject to change.

Describes an agent status.

Examples:

Request syntax with placeholder values


resp = client.describe_agent_status({
  instance_id: "InstanceId", # required
  agent_status_id: "AgentStatusId", # required
})

Response structure


resp.agent_status.agent_status_arn #=> String
resp.agent_status.agent_status_id #=> String
resp.agent_status.name #=> String
resp.agent_status.description #=> String
resp.agent_status.type #=> String, one of "ROUTABLE", "CUSTOM", "OFFLINE"
resp.agent_status.display_order #=> Integer
resp.agent_status.state #=> String, one of "ENABLED", "DISABLED"
resp.agent_status.tags #=> Hash
resp.agent_status.tags["TagKey"] #=> String
resp.agent_status.last_modified_time #=> Time
resp.agent_status.last_modified_region #=> String

Parameters:

  • params (Hash) (defaults to: {})

    ({})

Options Hash (params):

  • :instance_id (required, String)

    The identifier of the Amazon Connect instance. You can find the instance ID in the Amazon Resource Name (ARN) of the instance.

  • :agent_status_id (required, String)

    The identifier for the agent status.

Returns:

See Also:



4254
4255
4256
4257
# File 'gems/aws-sdk-connect/lib/aws-sdk-connect/client.rb', line 4254

def describe_agent_status(params = {}, options = {})
  req = build_request(:describe_agent_status, params)
  req.send_request(options)
end

#describe_contact(params = {}) ⇒ Types::DescribeContactResponse

This API is in preview release for Amazon Connect and is subject to change.

Describes the specified contact.

Contact information remains available in Amazon Connect for 24 months, and then it is deleted.

Only data from November 12, 2021, and later is returned by this API.

Examples:

Request syntax with placeholder values


resp = client.describe_contact({
  instance_id: "InstanceId", # required
  contact_id: "ContactId", # required
})

Response structure


resp.contact.arn #=> String
resp.contact.id #=> String
resp.contact.initial_contact_id #=> String
resp.contact.previous_contact_id #=> String
resp.contact.initiation_method #=> String, one of "INBOUND", "OUTBOUND", "TRANSFER", "QUEUE_TRANSFER", "CALLBACK", "API", "DISCONNECT", "MONITOR", "EXTERNAL_OUTBOUND"
resp.contact.name #=> String
resp.contact.description #=> String
resp.contact.channel #=> String, one of "VOICE", "CHAT", "TASK"
resp.contact.queue_info.id #=> String
resp.contact.queue_info.enqueue_timestamp #=> Time
resp.contact.agent_info.id #=> String
resp.contact.agent_info.connected_to_agent_timestamp #=> Time
resp.contact.agent_info.agent_pause_duration_in_seconds #=> Integer
resp.contact.initiation_timestamp #=> Time
resp.contact.disconnect_timestamp #=> Time
resp.contact.last_update_timestamp #=> Time
resp.contact.last_paused_timestamp #=> Time
resp.contact.last_resumed_timestamp #=> Time
resp.contact.total_pause_count #=> Integer
resp.contact.total_pause_duration_in_seconds #=> Integer
resp.contact.scheduled_timestamp #=> Time
resp.contact.related_contact_id #=> String
resp.contact.wisdom_info.session_arn #=> String
resp.contact.queue_time_adjustment_seconds #=> Integer
resp.contact.queue_priority #=> Integer
resp.contact.tags #=> Hash
resp.contact.tags["ContactTagKey"] #=> String

Parameters:

  • params (Hash) (defaults to: {})

    ({})

Options Hash (params):

  • :instance_id (required, String)

    The identifier of the Amazon Connect instance. You can find the instance ID in the Amazon Resource Name (ARN) of the instance.

  • :contact_id (required, String)

    The identifier of the contact.

Returns:

See Also:



4325
4326
4327
4328
# File 'gems/aws-sdk-connect/lib/aws-sdk-connect/client.rb', line 4325

def describe_contact(params = {}, options = {})
  req = build_request(:describe_contact, params)
  req.send_request(options)
end

#describe_contact_evaluation(params = {}) ⇒ Types::DescribeContactEvaluationResponse

Describes a contact evaluation in the specified Amazon Connect instance.

Examples:

Request syntax with placeholder values


resp = client.describe_contact_evaluation({
  instance_id: "InstanceId", # required
  evaluation_id: "ResourceId", # required
})

Response structure


resp.evaluation.evaluation_id #=> String
resp.evaluation.evaluation_arn #=> String
resp.evaluation..contact_id #=> String
resp.evaluation..evaluator_arn #=> String
resp.evaluation..contact_agent_id #=> String
resp.evaluation..score.percentage #=> Float
resp.evaluation..score.not_applicable #=> Boolean
resp.evaluation..score.automatic_fail #=> Boolean
resp.evaluation.answers #=> Hash
resp.evaluation.answers["ResourceId"].value.string_value #=> String
resp.evaluation.answers["ResourceId"].value.numeric_value #=> Float
resp.evaluation.answers["ResourceId"].value.not_applicable #=> Boolean
resp.evaluation.answers["ResourceId"].system_suggested_value.string_value #=> String
resp.evaluation.answers["ResourceId"].system_suggested_value.numeric_value #=> Float
resp.evaluation.answers["ResourceId"].system_suggested_value.not_applicable #=> Boolean
resp.evaluation.notes #=> Hash
resp.evaluation.notes["ResourceId"].value #=> String
resp.evaluation.status #=> String, one of "DRAFT", "SUBMITTED"
resp.evaluation.scores #=> Hash
resp.evaluation.scores["ResourceId"].percentage #=> Float
resp.evaluation.scores["ResourceId"].not_applicable #=> Boolean
resp.evaluation.scores["ResourceId"].automatic_fail #=> Boolean
resp.evaluation.created_time #=> Time
resp.evaluation.last_modified_time #=> Time
resp.evaluation.tags #=> Hash
resp.evaluation.tags["TagKey"] #=> String
resp.evaluation_form.evaluation_form_version #=> Integer
resp.evaluation_form.evaluation_form_id #=> String
resp.evaluation_form.evaluation_form_arn #=> String
resp.evaluation_form.title #=> String
resp.evaluation_form.description #=> String
resp.evaluation_form.items #=> Array
resp.evaluation_form.items[0].section.title #=> String
resp.evaluation_form.items[0].section.ref_id #=> String
resp.evaluation_form.items[0].section.instructions #=> String
resp.evaluation_form.items[0].section.items #=> Types::EvaluationFormItemsList
resp.evaluation_form.items[0].section.weight #=> Float
resp.evaluation_form.items[0].question.title #=> String
resp.evaluation_form.items[0].question.instructions #=> String
resp.evaluation_form.items[0].question.ref_id #=> String
resp.evaluation_form.items[0].question.not_applicable_enabled #=> Boolean
resp.evaluation_form.items[0].question.question_type #=> String, one of "TEXT", "SINGLESELECT", "NUMERIC"
resp.evaluation_form.items[0].question.question_type_properties.numeric.min_value #=> Integer
resp.evaluation_form.items[0].question.question_type_properties.numeric.max_value #=> Integer
resp.evaluation_form.items[0].question.question_type_properties.numeric.options #=> Array
resp.evaluation_form.items[0].question.question_type_properties.numeric.options[0].min_value #=> Integer
resp.evaluation_form.items[0].question.question_type_properties.numeric.options[0].max_value #=> Integer
resp.evaluation_form.items[0].question.question_type_properties.numeric.options[0].score #=> Integer
resp.evaluation_form.items[0].question.question_type_properties.numeric.options[0].automatic_fail #=> Boolean
resp.evaluation_form.items[0].question.question_type_properties.numeric.automation.property_value.label #=> String, one of "OVERALL_CUSTOMER_SENTIMENT_SCORE", "OVERALL_AGENT_SENTIMENT_SCORE", "NON_TALK_TIME", "NON_TALK_TIME_PERCENTAGE", "NUMBER_OF_INTERRUPTIONS", "CONTACT_DURATION", "AGENT_INTERACTION_DURATION", "CUSTOMER_HOLD_TIME"
resp.evaluation_form.items[0].question.question_type_properties.single_select.options #=> Array
resp.evaluation_form.items[0].question.question_type_properties.single_select.options[0].ref_id #=> String
resp.evaluation_form.items[0].question.question_type_properties.single_select.options[0].text #=> String
resp.evaluation_form.items[0].question.question_type_properties.single_select.options[0].score #=> Integer
resp.evaluation_form.items[0].question.question_type_properties.single_select.options[0].automatic_fail #=> Boolean
resp.evaluation_form.items[0].question.question_type_properties.single_select.display_as #=> String, one of "DROPDOWN", "RADIO"
resp.evaluation_form.items[0].question.question_type_properties.single_select.automation.options #=> Array
resp.evaluation_form.items[0].question.question_type_properties.single_select.automation.options[0].rule_category.category #=> String
resp.evaluation_form.items[0].question.question_type_properties.single_select.automation.options[0].rule_category.condition #=> String, one of "PRESENT", "NOT_PRESENT"
resp.evaluation_form.items[0].question.question_type_properties.single_select.automation.options[0].rule_category.option_ref_id #=> String
resp.evaluation_form.items[0].question.question_type_properties.single_select.automation.default_option_ref_id #=> String
resp.evaluation_form.items[0].question.weight #=> Float
resp.evaluation_form.scoring_strategy.mode #=> String, one of "QUESTION_ONLY", "SECTION_ONLY"
resp.evaluation_form.scoring_strategy.status #=> String, one of "ENABLED", "DISABLED"

Parameters:

  • params (Hash) (defaults to: {})

    ({})

Options Hash (params):

  • :instance_id (required, String)

    The identifier of the Amazon Connect instance. You can find the instance ID in the Amazon Resource Name (ARN) of the instance.

  • :evaluation_id (required, String)

    A unique identifier for the contact evaluation.

Returns:

See Also:



4427
4428
4429
4430
# File 'gems/aws-sdk-connect/lib/aws-sdk-connect/client.rb', line 4427

def describe_contact_evaluation(params = {}, options = {})
  req = build_request(:describe_contact_evaluation, params)
  req.send_request(options)
end

#describe_contact_flow(params = {}) ⇒ Types::DescribeContactFlowResponse

Describes the specified flow.

You can also create and update flows using the Amazon Connect Flow language.

Examples:

Request syntax with placeholder values


resp = client.describe_contact_flow({
  instance_id: "InstanceId", # required
  contact_flow_id: "ContactFlowId", # required
})

Response structure


resp.contact_flow.arn #=> String
resp.contact_flow.id #=> String
resp.contact_flow.name #=> String
resp.contact_flow.type #=> String, one of "CONTACT_FLOW", "CUSTOMER_QUEUE", "CUSTOMER_HOLD", "CUSTOMER_WHISPER", "AGENT_HOLD", "AGENT_WHISPER", "OUTBOUND_WHISPER", "AGENT_TRANSFER", "QUEUE_TRANSFER"
resp.contact_flow.state #=> String, one of "ACTIVE", "ARCHIVED"
resp.contact_flow.description #=> String
resp.contact_flow.content #=> String
resp.contact_flow.tags #=> Hash
resp.contact_flow.tags["TagKey"] #=> String

Parameters:

  • params (Hash) (defaults to: {})

    ({})

Options Hash (params):

  • :instance_id (required, String)

    The identifier of the Amazon Connect instance.

  • :contact_flow_id (required, String)

    The identifier of the flow.

Returns:

See Also:



4474
4475
4476
4477
# File 'gems/aws-sdk-connect/lib/aws-sdk-connect/client.rb', line 4474

def describe_contact_flow(params = {}, options = {})
  req = build_request(:describe_contact_flow, params)
  req.send_request(options)
end

#describe_contact_flow_module(params = {}) ⇒ Types::DescribeContactFlowModuleResponse

Describes the specified flow module.

Examples:

Request syntax with placeholder values


resp = client.describe_contact_flow_module({
  instance_id: "InstanceId", # required
  contact_flow_module_id: "ContactFlowModuleId", # required
})

Response structure


resp.contact_flow_module.arn #=> String
resp.contact_flow_module.id #=> String
resp.contact_flow_module.name #=> String
resp.contact_flow_module.content #=> String
resp.contact_flow_module.description #=> String
resp.contact_flow_module.state #=> String, one of "ACTIVE", "ARCHIVED"
resp.contact_flow_module.status #=> String, one of "PUBLISHED", "SAVED"
resp.contact_flow_module.tags #=> Hash
resp.contact_flow_module.tags["TagKey"] #=> String

Parameters:

  • params (Hash) (defaults to: {})

    ({})

Options Hash (params):

  • :instance_id (required, String)

    The identifier of the Amazon Connect instance. You can find the instance ID in the Amazon Resource Name (ARN) of the instance.

  • :contact_flow_module_id (required, String)

    The identifier of the flow module.

Returns:

See Also:



4519
4520
4521
4522
# File 'gems/aws-sdk-connect/lib/aws-sdk-connect/client.rb', line 4519

def describe_contact_flow_module(params = {}, options = {})
  req = build_request(:describe_contact_flow_module, params)
  req.send_request(options)
end

#describe_evaluation_form(params = {}) ⇒ Types::DescribeEvaluationFormResponse

Describes an evaluation form in the specified Amazon Connect instance. If the version property is not provided, the latest version of the evaluation form is described.

Examples:

Request syntax with placeholder values


resp = client.describe_evaluation_form({
  instance_id: "InstanceId", # required
  evaluation_form_id: "ResourceId", # required
  evaluation_form_version: 1,
})

Response structure


resp.evaluation_form.evaluation_form_id #=> String
resp.evaluation_form.evaluation_form_version #=> Integer
resp.evaluation_form.locked #=> Boolean
resp.evaluation_form.evaluation_form_arn #=> String
resp.evaluation_form.title #=> String
resp.evaluation_form.description #=> String
resp.evaluation_form.status #=> String, one of "DRAFT", "ACTIVE"
resp.evaluation_form.items #=> Array
resp.evaluation_form.items[0].section.title #=> String
resp.evaluation_form.items[0].section.ref_id #=> String
resp.evaluation_form.items[0].section.instructions #=> String
resp.evaluation_form.items[0].section.items #=> Types::EvaluationFormItemsList
resp.evaluation_form.items[0].section.weight #=> Float
resp.evaluation_form.items[0].question.title #=> String
resp.evaluation_form.items[0].question.instructions #=> String
resp.evaluation_form.items[0].question.ref_id #=> String
resp.evaluation_form.items[0].question.not_applicable_enabled #=> Boolean
resp.evaluation_form.items[0].question.question_type #=> String, one of "TEXT", "SINGLESELECT", "NUMERIC"
resp.evaluation_form.items[0].question.question_type_properties.numeric.min_value #=> Integer
resp.evaluation_form.items[0].question.question_type_properties.numeric.max_value #=> Integer
resp.evaluation_form.items[0].question.question_type_properties.numeric.options #=> Array
resp.evaluation_form.items[0].question.question_type_properties.numeric.options[0].min_value #=> Integer
resp.evaluation_form.items[0].question.question_type_properties.numeric.options[0].max_value #=> Integer
resp.evaluation_form.items[0].question.question_type_properties.numeric.options[0].score #=> Integer
resp.evaluation_form.items[0].question.question_type_properties.numeric.options[0].automatic_fail #=> Boolean
resp.evaluation_form.items[0].question.question_type_properties.numeric.automation.property_value.label #=> String, one of "OVERALL_CUSTOMER_SENTIMENT_SCORE", "OVERALL_AGENT_SENTIMENT_SCORE", "NON_TALK_TIME", "NON_TALK_TIME_PERCENTAGE", "NUMBER_OF_INTERRUPTIONS", "CONTACT_DURATION", "AGENT_INTERACTION_DURATION", "CUSTOMER_HOLD_TIME"
resp.evaluation_form.items[0].question.question_type_properties.single_select.options #=> Array
resp.evaluation_form.items[0].question.question_type_properties.single_select.options[0].ref_id #=> String
resp.evaluation_form.items[0].question.question_type_properties.single_select.options[0].text #=> String
resp.evaluation_form.items[0].question.question_type_properties.single_select.options[0].score #=> Integer
resp.evaluation_form.items[0].question.question_type_properties.single_select.options[0].automatic_fail #=> Boolean
resp.evaluation_form.items[0].question.question_type_properties.single_select.display_as #=> String, one of "DROPDOWN", "RADIO"
resp.evaluation_form.items[0].question.question_type_properties.single_select.automation.options #=> Array
resp.evaluation_form.items[0].question.question_type_properties.single_select.automation.options[0].rule_category.category #=> String
resp.evaluation_form.items[0].question.question_type_properties.single_select.automation.options[0].rule_category.condition #=> String, one of "PRESENT", "NOT_PRESENT"
resp.evaluation_form.items[0].question.question_type_properties.single_select.automation.options[0].rule_category.option_ref_id #=> String
resp.evaluation_form.items[0].question.question_type_properties.single_select.automation.default_option_ref_id #=> String
resp.evaluation_form.items[0].question.weight #=> Float
resp.evaluation_form.scoring_strategy.mode #=> String, one of "QUESTION_ONLY", "SECTION_ONLY"
resp.evaluation_form.scoring_strategy.status #=> String, one of "ENABLED", "DISABLED"
resp.evaluation_form.created_time #=> Time
resp.evaluation_form.created_by #=> String
resp.evaluation_form.last_modified_time #=> Time
resp.evaluation_form.last_modified_by #=> String
resp.evaluation_form.tags #=> Hash
resp.evaluation_form.tags["TagKey"] #=> String

Parameters:

  • params (Hash) (defaults to: {})

    ({})

Options Hash (params):

  • :instance_id (required, String)

    The identifier of the Amazon Connect instance. You can find the instance ID in the Amazon Resource Name (ARN) of the instance.

  • :evaluation_form_id (required, String)

    A unique identifier for the contact evaluation.

  • :evaluation_form_version (Integer)

    A version of the evaluation form.

Returns:

See Also:



4607
4608
4609
4610
# File 'gems/aws-sdk-connect/lib/aws-sdk-connect/client.rb', line 4607

def describe_evaluation_form(params = {}, options = {})
  req = build_request(:describe_evaluation_form, params)
  req.send_request(options)
end

#describe_hours_of_operation(params = {}) ⇒ Types::DescribeHoursOfOperationResponse

This API is in preview release for Amazon Connect and is subject to change.

Describes the hours of operation.

Examples:

Request syntax with placeholder values


resp = client.describe_hours_of_operation({
  instance_id: "InstanceId", # required
  hours_of_operation_id: "HoursOfOperationId", # required
})

Response structure


resp.hours_of_operation.hours_of_operation_id #=> String
resp.hours_of_operation.hours_of_operation_arn #=> String
resp.hours_of_operation.name #=> String
resp.hours_of_operation.description #=> String
resp.hours_of_operation.time_zone #=> String
resp.hours_of_operation.config #=> Array
resp.hours_of_operation.config[0].day #=> String, one of "SUNDAY", "MONDAY", "TUESDAY", "WEDNESDAY", "THURSDAY", "FRIDAY", "SATURDAY"
resp.hours_of_operation.config[0].start_time.hours #=> Integer
resp.hours_of_operation.config[0].start_time.minutes #=> Integer
resp.hours_of_operation.config[0].end_time.hours #=> Integer
resp.hours_of_operation.config[0].end_time.minutes #=> Integer
resp.hours_of_operation.tags #=> Hash
resp.hours_of_operation.tags["TagKey"] #=> String
resp.hours_of_operation.last_modified_time #=> Time
resp.hours_of_operation.last_modified_region #=> String

Parameters:

  • params (Hash) (defaults to: {})

    ({})

Options Hash (params):

  • :instance_id (required, String)

    The identifier of the Amazon Connect instance. You can find the instance ID in the Amazon Resource Name (ARN) of the instance.

  • :hours_of_operation_id (required, String)

    The identifier for the hours of operation.

Returns:

See Also:



4661
4662
4663
4664
# File 'gems/aws-sdk-connect/lib/aws-sdk-connect/client.rb', line 4661

def describe_hours_of_operation(params = {}, options = {})
  req = build_request(:describe_hours_of_operation, params)
  req.send_request(options)
end

#describe_instance(params = {}) ⇒ Types::DescribeInstanceResponse

This API is in preview release for Amazon Connect and is subject to change.

Returns the current state of the specified instance identifier. It tracks the instance while it is being created and returns an error status, if applicable.

If an instance is not created successfully, the instance status reason field returns details relevant to the reason. The instance in a failed state is returned only for 24 hours after the CreateInstance API was invoked.

Examples:

Request syntax with placeholder values


resp = client.describe_instance({
  instance_id: "InstanceId", # required
})

Response structure


resp.instance.id #=> String
resp.instance.arn #=> String
resp.instance.identity_management_type #=> String, one of "SAML", "CONNECT_MANAGED", "EXISTING_DIRECTORY"
resp.instance.instance_alias #=> String
resp.instance.created_time #=> Time
resp.instance.service_role #=> String
resp.instance.instance_status #=> String, one of "CREATION_IN_PROGRESS", "ACTIVE", "CREATION_FAILED"
resp.instance.status_reason.message #=> String
resp.instance.inbound_calls_enabled #=> Boolean
resp.instance.outbound_calls_enabled #=> Boolean
resp.instance.instance_access_url #=> String
resp.instance.tags #=> Hash
resp.instance.tags["TagKey"] #=> String

Parameters:

  • params (Hash) (defaults to: {})

    ({})

Options Hash (params):

  • :instance_id (required, String)

    The identifier of the Amazon Connect instance. You can find the instance ID in the Amazon Resource Name (ARN) of the instance.

Returns:

See Also:



4716
4717
4718
4719
# File 'gems/aws-sdk-connect/lib/aws-sdk-connect/client.rb', line 4716

def describe_instance(params = {}, options = {})
  req = build_request(:describe_instance, params)
  req.send_request(options)
end

#describe_instance_attribute(params = {}) ⇒ Types::DescribeInstanceAttributeResponse

This API is in preview release for Amazon Connect and is subject to change.

Describes the specified instance attribute.

Examples:

Request syntax with placeholder values


resp = client.describe_instance_attribute({
  instance_id: "InstanceId", # required
  attribute_type: "INBOUND_CALLS", # required, accepts INBOUND_CALLS, OUTBOUND_CALLS, CONTACTFLOW_LOGS, CONTACT_LENS, AUTO_RESOLVE_BEST_VOICES, USE_CUSTOM_TTS_VOICES, EARLY_MEDIA, MULTI_PARTY_CONFERENCE, HIGH_VOLUME_OUTBOUND, ENHANCED_CONTACT_MONITORING, ENHANCED_CHAT_MONITORING
})

Response structure


resp.attribute.attribute_type #=> String, one of "INBOUND_CALLS", "OUTBOUND_CALLS", "CONTACTFLOW_LOGS", "CONTACT_LENS", "AUTO_RESOLVE_BEST_VOICES", "USE_CUSTOM_TTS_VOICES", "EARLY_MEDIA", "MULTI_PARTY_CONFERENCE", "HIGH_VOLUME_OUTBOUND", "ENHANCED_CONTACT_MONITORING", "ENHANCED_CHAT_MONITORING"
resp.attribute.value #=> String

Parameters:

  • params (Hash) (defaults to: {})

    ({})

Options Hash (params):

  • :instance_id (required, String)

    The identifier of the Amazon Connect instance. You can find the instance ID in the Amazon Resource Name (ARN) of the instance.

  • :attribute_type (required, String)

    The type of attribute.

Returns:

See Also:



4757
4758
4759
4760
# File 'gems/aws-sdk-connect/lib/aws-sdk-connect/client.rb', line 4757

def describe_instance_attribute(params = {}, options = {})
  req = build_request(:describe_instance_attribute, params)
  req.send_request(options)
end

#describe_instance_storage_config(params = {}) ⇒ Types::DescribeInstanceStorageConfigResponse

This API is in preview release for Amazon Connect and is subject to change.

Retrieves the current storage configurations for the specified resource type, association ID, and instance ID.

Examples:

Request syntax with placeholder values


resp = client.describe_instance_storage_config({
  instance_id: "InstanceId", # required
  association_id: "AssociationId", # required
  resource_type: "CHAT_TRANSCRIPTS", # required, accepts CHAT_TRANSCRIPTS, CALL_RECORDINGS, SCHEDULED_REPORTS, MEDIA_STREAMS, CONTACT_TRACE_RECORDS, AGENT_EVENTS, REAL_TIME_CONTACT_ANALYSIS_SEGMENTS, ATTACHMENTS, CONTACT_EVALUATIONS, SCREEN_RECORDINGS
})

Response structure


resp.storage_config.association_id #=> String
resp.storage_config.storage_type #=> String, one of "S3", "KINESIS_VIDEO_STREAM", "KINESIS_STREAM", "KINESIS_FIREHOSE"
resp.storage_config.s3_config.bucket_name #=> String
resp.storage_config.s3_config.bucket_prefix #=> String
resp.storage_config.s3_config.encryption_config.encryption_type #=> String, one of "KMS"
resp.storage_config.s3_config.encryption_config.key_id #=> String
resp.storage_config.kinesis_video_stream_config.prefix #=> String
resp.storage_config.kinesis_video_stream_config.retention_period_hours #=> Integer
resp.storage_config.kinesis_video_stream_config.encryption_config.encryption_type #=> String, one of "KMS"
resp.storage_config.kinesis_video_stream_config.encryption_config.key_id #=> String
resp.storage_config.kinesis_stream_config.stream_arn #=> String
resp.storage_config.kinesis_firehose_config.firehose_arn #=> String

Parameters:

  • params (Hash) (defaults to: {})

    ({})

Options Hash (params):

  • :instance_id (required, String)

    The identifier of the Amazon Connect instance. You can find the instance ID in the Amazon Resource Name (ARN) of the instance.

  • :association_id (required, String)

    The existing association identifier that uniquely identifies the resource type and storage config for the given instance ID.

  • :resource_type (required, String)

    A valid resource type.

Returns:

See Also:



4814
4815
4816
4817
# File 'gems/aws-sdk-connect/lib/aws-sdk-connect/client.rb', line 4814

def describe_instance_storage_config(params = {}, options = {})
  req = build_request(:describe_instance_storage_config, params)
  req.send_request(options)
end

#describe_phone_number(params = {}) ⇒ Types::DescribePhoneNumberResponse

Gets details and status of a phone number that’s claimed to your Amazon Connect instance or traffic distribution group.

If the number is claimed to a traffic distribution group, and you are calling in the Amazon Web Services Region where the traffic distribution group was created, you can use either a phone number ARN or UUID value for the PhoneNumberId URI request parameter. However, if the number is claimed to a traffic distribution group and you are calling this API in the alternate Amazon Web Services Region associated with the traffic distribution group, you must provide a full phone number ARN. If a UUID is provided in this scenario, you will receive a ResourceNotFoundException.

Examples:

Request syntax with placeholder values


resp = client.describe_phone_number({
  phone_number_id: "PhoneNumberId", # required
})

Response structure


resp.claimed_phone_number_summary.phone_number_id #=> String
resp.claimed_phone_number_summary.phone_number_arn #=> String
resp.claimed_phone_number_summary.phone_number #=> String
resp.claimed_phone_number_summary.phone_number_country_code #=> String, one of "AF", "AL", "DZ", "AS", "AD", "AO", "AI", "AQ", "AG", "AR", "AM", "AW", "AU", "AT", "AZ", "BS", "BH", "BD", "BB", "BY", "BE", "BZ", "BJ", "BM", "BT", "BO", "BA", "BW", "BR", "IO", "VG", "BN", "BG", "BF", "BI", "KH", "CM", "CA", "CV", "KY", "CF", "TD", "CL", "CN", "CX", "CC", "CO", "KM", "CK", "CR", "HR", "CU", "CW", "CY", "CZ", "CD", "DK", "DJ", "DM", "DO", "TL", "EC", "EG", "SV", "GQ", "ER", "EE", "ET", "FK", "FO", "FJ", "FI", "FR", "PF", "GA", "GM", "GE", "DE", "GH", "GI", "GR", "GL", "GD", "GU", "GT", "GG", "GN", "GW", "GY", "HT", "HN", "HK", "HU", "IS", "IN", "ID", "IR", "IQ", "IE", "IM", "IL", "IT", "CI", "JM", "JP", "JE", "JO", "KZ", "KE", "KI", "KW", "KG", "LA", "LV", "LB", "LS", "LR", "LY", "LI", "LT", "LU", "MO", "MK", "MG", "MW", "MY", "MV", "ML", "MT", "MH", "MR", "MU", "YT", "MX", "FM", "MD", "MC", "MN", "ME", "MS", "MA", "MZ", "MM", "NA", "NR", "NP", "NL", "AN", "NC", "NZ", "NI", "NE", "NG", "NU", "KP", "MP", "NO", "OM", "PK", "PW", "PA", "PG", "PY", "PE", "PH", "PN", "PL", "PT", "PR", "QA", "CG", "RE", "RO", "RU", "RW", "BL", "SH", "KN", "LC", "MF", "PM", "VC", "WS", "SM", "ST", "SA", "SN", "RS", "SC", "SL", "SG", "SX", "SK", "SI", "SB", "SO", "ZA", "KR", "ES", "LK", "SD", "SR", "SJ", "SZ", "SE", "CH", "SY", "TW", "TJ", "TZ", "TH", "TG", "TK", "TO", "TT", "TN", "TR", "TM", "TC", "TV", "VI", "UG", "UA", "AE", "GB", "US", "UY", "UZ", "VU", "VA", "VE", "VN", "WF", "EH", "YE", "ZM", "ZW"
resp.claimed_phone_number_summary.phone_number_type #=> String, one of "TOLL_FREE", "DID", "UIFN", "SHARED", "THIRD_PARTY_TF", "THIRD_PARTY_DID", "SHORT_CODE"
resp.claimed_phone_number_summary.phone_number_description #=> String
resp.claimed_phone_number_summary.target_arn #=> String
resp.claimed_phone_number_summary.instance_id #=> String
resp.claimed_phone_number_summary.tags #=> Hash
resp.claimed_phone_number_summary.tags["TagKey"] #=> String
resp.claimed_phone_number_summary.phone_number_status.status #=> String, one of "CLAIMED", "IN_PROGRESS", "FAILED"
resp.claimed_phone_number_summary.phone_number_status.message #=> String
resp.claimed_phone_number_summary.source_phone_number_arn #=> String

Parameters:

  • params (Hash) (defaults to: {})

    ({})

Options Hash (params):

  • :phone_number_id (required, String)

    A unique identifier for the phone number.

Returns:

See Also:



4865
4866
4867
4868
# File 'gems/aws-sdk-connect/lib/aws-sdk-connect/client.rb', line 4865

def describe_phone_number(params = {}, options = {})
  req = build_request(:describe_phone_number, params)
  req.send_request(options)
end

#describe_predefined_attribute(params = {}) ⇒ Types::DescribePredefinedAttributeResponse

Describes a predefined attribute for the specified Amazon Connect instance.

Examples:

Request syntax with placeholder values


resp = client.describe_predefined_attribute({
  instance_id: "InstanceId", # required
  name: "PredefinedAttributeName", # required
})

Response structure


resp.predefined_attribute.name #=> String
resp.predefined_attribute.values.string_list #=> Array
resp.predefined_attribute.values.string_list[0] #=> String
resp.predefined_attribute.last_modified_time #=> Time
resp.predefined_attribute.last_modified_region #=> String

Parameters:

  • params (Hash) (defaults to: {})

    ({})

Options Hash (params):

  • :instance_id (required, String)

    The identifier of the Amazon Connect instance. You can find the instance ID in the Amazon Resource Name (ARN) of the instance.

  • :name (required, String)

    The name of the predefined attribute.

Returns:

See Also:



4903
4904
4905
4906
# File 'gems/aws-sdk-connect/lib/aws-sdk-connect/client.rb', line 4903

def describe_predefined_attribute(params = {}, options = {})
  req = build_request(:describe_predefined_attribute, params)
  req.send_request(options)
end

#describe_prompt(params = {}) ⇒ Types::DescribePromptResponse

Describes the prompt.

Examples:

Request syntax with placeholder values


resp = client.describe_prompt({
  instance_id: "InstanceId", # required
  prompt_id: "PromptId", # required
})

Response structure


resp.prompt.prompt_arn #=> String
resp.prompt.prompt_id #=> String
resp.prompt.name #=> String
resp.prompt.description #=> String
resp.prompt.tags #=> Hash
resp.prompt.tags["TagKey"] #=> String
resp.prompt.last_modified_time #=> Time
resp.prompt.last_modified_region #=> String

Parameters:

  • params (Hash) (defaults to: {})

    ({})

Options Hash (params):

  • :instance_id (required, String)

    The identifier of the Amazon Connect instance. You can find the instance ID in the Amazon Resource Name (ARN) of the instance.

  • :prompt_id (required, String)

    A unique identifier for the prompt.

Returns:

See Also:



4947
4948
4949
4950
# File 'gems/aws-sdk-connect/lib/aws-sdk-connect/client.rb', line 4947

def describe_prompt(params = {}, options = {})
  req = build_request(:describe_prompt, params)
  req.send_request(options)
end

#describe_queue(params = {}) ⇒ Types::DescribeQueueResponse

This API is in preview release for Amazon Connect and is subject to change.

Describes the specified queue.

Examples:

Request syntax with placeholder values


resp = client.describe_queue({
  instance_id: "InstanceId", # required
  queue_id: "QueueId", # required
})

Response structure


resp.queue.name #=> String
resp.queue.queue_arn #=> String
resp.queue.queue_id #=> String
resp.queue.description #=> String
resp.queue.outbound_caller_config.outbound_caller_id_name #=> String
resp.queue.outbound_caller_config.outbound_caller_id_number_id #=> String
resp.queue.outbound_caller_config.outbound_flow_id #=> String
resp.queue.hours_of_operation_id #=> String
resp.queue.max_contacts #=> Integer
resp.queue.status #=> String, one of "ENABLED", "DISABLED"
resp.queue.tags #=> Hash
resp.queue.tags["TagKey"] #=> String
resp.queue.last_modified_time #=> Time
resp.queue.last_modified_region #=> String

Parameters:

  • params (Hash) (defaults to: {})

    ({})

Options Hash (params):

  • :instance_id (required, String)

    The identifier of the Amazon Connect instance. You can find the instance ID in the Amazon Resource Name (ARN) of the instance.

  • :queue_id (required, String)

    The identifier for the queue.

Returns:

See Also:



5000
5001
5002
5003
# File 'gems/aws-sdk-connect/lib/aws-sdk-connect/client.rb', line 5000

def describe_queue(params = {}, options = {})
  req = build_request(:describe_queue, params)
  req.send_request(options)
end

#describe_quick_connect(params = {}) ⇒ Types::DescribeQuickConnectResponse

Describes the quick connect.

Examples:

Request syntax with placeholder values


resp = client.describe_quick_connect({
  instance_id: "InstanceId", # required
  quick_connect_id: "QuickConnectId", # required
})

Response structure


resp.quick_connect.quick_connect_arn #=> String
resp.quick_connect.quick_connect_id #=> String
resp.quick_connect.name #=> String
resp.quick_connect.description #=> String
resp.quick_connect.quick_connect_config.quick_connect_type #=> String, one of "USER", "QUEUE", "PHONE_NUMBER"
resp.quick_connect.quick_connect_config.user_config.user_id #=> String
resp.quick_connect.quick_connect_config.user_config.contact_flow_id #=> String
resp.quick_connect.quick_connect_config.queue_config.queue_id #=> String
resp.quick_connect.quick_connect_config.queue_config.contact_flow_id #=> String
resp.quick_connect.quick_connect_config.phone_config.phone_number #=> String
resp.quick_connect.tags #=> Hash
resp.quick_connect.tags["TagKey"] #=> String
resp.quick_connect.last_modified_time #=> Time
resp.quick_connect.last_modified_region #=> String

Parameters:

  • params (Hash) (defaults to: {})

    ({})

Options Hash (params):

  • :instance_id (required, String)

    The identifier of the Amazon Connect instance. You can find the instance ID in the Amazon Resource Name (ARN) of the instance.

  • :quick_connect_id (required, String)

    The identifier for the quick connect.

Returns:

See Also:



5050
5051
5052
5053
# File 'gems/aws-sdk-connect/lib/aws-sdk-connect/client.rb', line 5050

def describe_quick_connect(params = {}, options = {})
  req = build_request(:describe_quick_connect, params)
  req.send_request(options)
end

#describe_routing_profile(params = {}) ⇒ Types::DescribeRoutingProfileResponse

Describes the specified routing profile.

Examples:

Request syntax with placeholder values


resp = client.describe_routing_profile({
  instance_id: "InstanceId", # required
  routing_profile_id: "RoutingProfileId", # required
})

Response structure


resp.routing_profile.instance_id #=> String
resp.routing_profile.name #=> String
resp.routing_profile.routing_profile_arn #=> String
resp.routing_profile.routing_profile_id #=> String
resp.routing_profile.description #=> String
resp.routing_profile.media_concurrencies #=> Array
resp.routing_profile.media_concurrencies[0].channel #=> String, one of "VOICE", "CHAT", "TASK"
resp.routing_profile.media_concurrencies[0].concurrency #=> Integer
resp.routing_profile.media_concurrencies[0].cross_channel_behavior.behavior_type #=> String, one of "ROUTE_CURRENT_CHANNEL_ONLY", "ROUTE_ANY_CHANNEL"
resp.routing_profile.default_outbound_queue_id #=> String
resp.routing_profile.tags #=> Hash
resp.routing_profile.tags["TagKey"] #=> String
resp.routing_profile.number_of_associated_queues #=> Integer
resp.routing_profile.number_of_associated_users #=> Integer
resp.routing_profile.agent_availability_timer #=> String, one of "TIME_SINCE_LAST_ACTIVITY", "TIME_SINCE_LAST_INBOUND"
resp.routing_profile.last_modified_time #=> Time
resp.routing_profile.last_modified_region #=> String
resp.routing_profile.is_default #=> Boolean

Parameters:

  • params (Hash) (defaults to: {})

    ({})

Options Hash (params):

  • :instance_id (required, String)

    The identifier of the Amazon Connect instance. You can find the instance ID in the Amazon Resource Name (ARN) of the instance.

  • :routing_profile_id (required, String)

    The identifier of the routing profile.

Returns:

See Also:



5104
5105
5106
5107
# File 'gems/aws-sdk-connect/lib/aws-sdk-connect/client.rb', line 5104

def describe_routing_profile(params = {}, options = {})
  req = build_request(:describe_routing_profile, params)
  req.send_request(options)
end

#describe_rule(params = {}) ⇒ Types::DescribeRuleResponse

Describes a rule for the specified Amazon Connect instance.

Examples:

Request syntax with placeholder values


resp = client.describe_rule({
  instance_id: "InstanceId", # required
  rule_id: "RuleId", # required
})

Response structure


resp.rule.name #=> String
resp.rule.rule_id #=> String
resp.rule.rule_arn #=> String
resp.rule.trigger_event_source.event_source_name #=> String, one of "OnPostCallAnalysisAvailable", "OnRealTimeCallAnalysisAvailable", "OnRealTimeChatAnalysisAvailable", "OnPostChatAnalysisAvailable", "OnZendeskTicketCreate", "OnZendeskTicketStatusUpdate", "OnSalesforceCaseCreate", "OnContactEvaluationSubmit", "OnMetricDataUpdate", "OnCaseCreate", "OnCaseUpdate"
resp.rule.trigger_event_source.integration_association_id #=> String
resp.rule.function #=> String
resp.rule.actions #=> Array
resp.rule.actions[0].action_type #=> String, one of "CREATE_TASK", "ASSIGN_CONTACT_CATEGORY", "GENERATE_EVENTBRIDGE_EVENT", "SEND_NOTIFICATION", "CREATE_CASE", "UPDATE_CASE", "END_ASSOCIATED_TASKS"
resp.rule.actions[0].task_action.name #=> String
resp.rule.actions[0].task_action.description #=> String
resp.rule.actions[0].task_action.contact_flow_id #=> String
resp.rule.actions[0].task_action.references #=> Hash
resp.rule.actions[0].task_action.references["ReferenceKey"].value #=> String
resp.rule.actions[0].task_action.references["ReferenceKey"].type #=> String, one of "URL", "ATTACHMENT", "NUMBER", "STRING", "DATE", "EMAIL"
resp.rule.actions[0].event_bridge_action.name #=> String
resp.rule.actions[0].send_notification_action.delivery_method #=> String, one of "EMAIL"
resp.rule.actions[0].send_notification_action.subject #=> String
resp.rule.actions[0].send_notification_action.content #=> String
resp.rule.actions[0].send_notification_action.content_type #=> String, one of "PLAIN_TEXT"
resp.rule.actions[0].send_notification_action.recipient.user_tags #=> Hash
resp.rule.actions[0].send_notification_action.recipient.user_tags["String"] #=> String
resp.rule.actions[0].send_notification_action.recipient.user_ids #=> Array
resp.rule.actions[0].send_notification_action.recipient.user_ids[0] #=> String
resp.rule.actions[0].create_case_action.fields #=> Array
resp.rule.actions[0].create_case_action.fields[0].id #=> String
resp.rule.actions[0].create_case_action.fields[0].value.boolean_value #=> Boolean
resp.rule.actions[0].create_case_action.fields[0].value.double_value #=> Float
resp.rule.actions[0].create_case_action.fields[0].value.string_value #=> String
resp.rule.actions[0].create_case_action.template_id #=> String
resp.rule.actions[0].update_case_action.fields #=> Array
resp.rule.actions[0].update_case_action.fields[0].id #=> String
resp.rule.actions[0].update_case_action.fields[0].value.boolean_value #=> Boolean
resp.rule.actions[0].update_case_action.fields[0].value.double_value #=> Float
resp.rule.actions[0].update_case_action.fields[0].value.string_value #=> String
resp.rule.publish_status #=> String, one of "DRAFT", "PUBLISHED"
resp.rule.created_time #=> Time
resp.rule.last_updated_time #=> Time
resp.rule.last_updated_by #=> String
resp.rule.tags #=> Hash
resp.rule.tags["TagKey"] #=> String

Parameters:

  • params (Hash) (defaults to: {})

    ({})

Options Hash (params):

  • :instance_id (required, String)

    The identifier of the Amazon Connect instance. You can find the instance ID in the Amazon Resource Name (ARN) of the instance.

  • :rule_id (required, String)

    A unique identifier for the rule.

Returns:

See Also:



5180
5181
5182
5183
# File 'gems/aws-sdk-connect/lib/aws-sdk-connect/client.rb', line 5180

def describe_rule(params = {}, options = {})
  req = build_request(:describe_rule, params)
  req.send_request(options)
end

#describe_security_profile(params = {}) ⇒ Types::DescribeSecurityProfileResponse

Gets basic information about the security profle.

Examples:

Request syntax with placeholder values


resp = client.describe_security_profile({
  security_profile_id: "SecurityProfileId", # required
  instance_id: "InstanceId", # required
})

Response structure


resp.security_profile.id #=> String
resp.security_profile.organization_resource_id #=> String
resp.security_profile.arn #=> String
resp.security_profile.security_profile_name #=> String
resp.security_profile.description #=> String
resp.security_profile.tags #=> Hash
resp.security_profile.tags["TagKey"] #=> String
resp.security_profile.allowed_access_control_tags #=> Hash
resp.security_profile.allowed_access_control_tags["SecurityProfilePolicyKey"] #=> String
resp.security_profile.tag_restricted_resources #=> Array
resp.security_profile.tag_restricted_resources[0] #=> String
resp.security_profile.last_modified_time #=> Time
resp.security_profile.last_modified_region #=> String

Parameters:

  • params (Hash) (defaults to: {})

    ({})

Options Hash (params):

  • :security_profile_id (required, String)

    The identifier for the security profle.

  • :instance_id (required, String)

    The identifier of the Amazon Connect instance. You can find the instance ID in the Amazon Resource Name (ARN) of the instance.

Returns:

See Also:



5229
5230
5231
5232
# File 'gems/aws-sdk-connect/lib/aws-sdk-connect/client.rb', line 5229

def describe_security_profile(params = {}, options = {})
  req = build_request(:describe_security_profile, params)
  req.send_request(options)
end

#describe_traffic_distribution_group(params = {}) ⇒ Types::DescribeTrafficDistributionGroupResponse

Gets details and status of a traffic distribution group.

Examples:

Request syntax with placeholder values


resp = client.describe_traffic_distribution_group({
  traffic_distribution_group_id: "TrafficDistributionGroupIdOrArn", # required
})

Response structure


resp.traffic_distribution_group.id #=> String
resp.traffic_distribution_group.arn #=> String
resp.traffic_distribution_group.name #=> String
resp.traffic_distribution_group.description #=> String
resp.traffic_distribution_group.instance_arn #=> String
resp.traffic_distribution_group.status #=> String, one of "CREATION_IN_PROGRESS", "ACTIVE", "CREATION_FAILED", "PENDING_DELETION", "DELETION_FAILED", "UPDATE_IN_PROGRESS"
resp.traffic_distribution_group.tags #=> Hash
resp.traffic_distribution_group.tags["TagKey"] #=> String
resp.traffic_distribution_group.is_default #=> Boolean

Parameters:

  • params (Hash) (defaults to: {})

    ({})

Options Hash (params):

  • :traffic_distribution_group_id (required, String)

    The identifier of the traffic distribution group. This can be the ID or the ARN if the API is being called in the Region where the traffic distribution group was created. The ARN must be provided if the call is from the replicated Region.

Returns:

See Also:



5268
5269
5270
5271
# File 'gems/aws-sdk-connect/lib/aws-sdk-connect/client.rb', line 5268

def describe_traffic_distribution_group(params = {}, options = {})
  req = build_request(:describe_traffic_distribution_group, params)
  req.send_request(options)
end

#describe_user(params = {}) ⇒ Types::DescribeUserResponse

Describes the specified user. You can find the instance ID in the Amazon Connect console (it’s the final part of the ARN). The console does not display the user IDs. Instead, list the users and note the IDs provided in the output.

Examples:

Request syntax with placeholder values


resp = client.describe_user({
  user_id: "UserId", # required
  instance_id: "InstanceId", # required
})

Response structure


resp.user.id #=> String
resp.user.arn #=> String
resp.user.username #=> String
resp.user.identity_info.first_name #=> String
resp.user.identity_info.last_name #=> String
resp.user.identity_info.email #=> String
resp.user.identity_info.secondary_email #=> String
resp.user.identity_info.mobile #=> String
resp.user.phone_config.phone_type #=> String, one of "SOFT_PHONE", "DESK_PHONE"
resp.user.phone_config.auto_accept #=> Boolean
resp.user.phone_config.after_contact_work_time_limit #=> Integer
resp.user.phone_config.desk_phone_number #=> String
resp.user.directory_user_id #=> String
resp.user.security_profile_ids #=> Array
resp.user.security_profile_ids[0] #=> String
resp.user.routing_profile_id #=> String
resp.user.hierarchy_group_id #=> String
resp.user.tags #=> Hash
resp.user.tags["TagKey"] #=> String
resp.user.last_modified_time #=> Time
resp.user.last_modified_region #=> String

Parameters:

  • params (Hash) (defaults to: {})

    ({})

Options Hash (params):

  • :user_id (required, String)

    The identifier of the user account.

  • :instance_id (required, String)

    The identifier of the Amazon Connect instance. You can find the instance ID in the Amazon Resource Name (ARN) of the instance.

Returns:

See Also:



5332
5333
5334
5335
# File 'gems/aws-sdk-connect/lib/aws-sdk-connect/client.rb', line 5332

def describe_user(params = {}, options = {})
  req = build_request(:describe_user, params)
  req.send_request(options)
end

#describe_user_hierarchy_group(params = {}) ⇒ Types::DescribeUserHierarchyGroupResponse

Describes the specified hierarchy group.

Examples:

Request syntax with placeholder values


resp = client.describe_user_hierarchy_group({
  hierarchy_group_id: "HierarchyGroupId", # required
  instance_id: "InstanceId", # required
})

Response structure


resp.hierarchy_group.id #=> String
resp.hierarchy_group.arn #=> String
resp.hierarchy_group.name #=> String
resp.hierarchy_group.level_id #=> String
resp.hierarchy_group.hierarchy_path.level_one.id #=> String
resp.hierarchy_group.hierarchy_path.level_one.arn #=> String
resp.hierarchy_group.hierarchy_path.level_one.name #=> String
resp.hierarchy_group.hierarchy_path.level_one.last_modified_time #=> Time
resp.hierarchy_group.hierarchy_path.level_one.last_modified_region #=> String
resp.hierarchy_group.hierarchy_path.level_two.id #=> String
resp.hierarchy_group.hierarchy_path.level_two.arn #=> String
resp.hierarchy_group.hierarchy_path.level_two.name #=> String
resp.hierarchy_group.hierarchy_path.level_two.last_modified_time #=> Time
resp.hierarchy_group.hierarchy_path.level_two.last_modified_region #=> String
resp.hierarchy_group.hierarchy_path.level_three.id #=> String
resp.hierarchy_group.hierarchy_path.level_three.arn #=> String
resp.hierarchy_group.hierarchy_path.level_three.name #=> String
resp.hierarchy_group.hierarchy_path.level_three.last_modified_time #=> Time
resp.hierarchy_group.hierarchy_path.level_three.last_modified_region #=> String
resp.hierarchy_group.hierarchy_path.level_four.id #=> String
resp.hierarchy_group.hierarchy_path.level_four.arn #=> String
resp.hierarchy_group.hierarchy_path.level_four.name #=> String
resp.hierarchy_group.hierarchy_path.level_four.last_modified_time #=> Time
resp.hierarchy_group.hierarchy_path.level_four.last_modified_region #=> String
resp.hierarchy_group.hierarchy_path.level_five.id #=> String
resp.hierarchy_group.hierarchy_path.level_five.arn #=> String
resp.hierarchy_group.hierarchy_path.level_five.name #=> String
resp.hierarchy_group.hierarchy_path.level_five.last_modified_time #=> Time
resp.hierarchy_group.hierarchy_path.level_five.last_modified_region #=> String
resp.hierarchy_group.tags #=> Hash
resp.hierarchy_group.tags["TagKey"] #=> String
resp.hierarchy_group.last_modified_time #=> Time
resp.hierarchy_group.last_modified_region #=> String

Parameters:

  • params (Hash) (defaults to: {})

    ({})

Options Hash (params):

  • :hierarchy_group_id (required, String)

    The identifier of the hierarchy group.

  • :instance_id (required, String)

    The identifier of the Amazon Connect instance. You can find the instance ID in the Amazon Resource Name (ARN) of the instance.

Returns:

See Also:



5401
5402
5403
5404
# File 'gems/aws-sdk-connect/lib/aws-sdk-connect/client.rb', line 5401

def describe_user_hierarchy_group(params = {}, options = {})
  req = build_request(:describe_user_hierarchy_group, params)
  req.send_request(options)
end

#describe_user_hierarchy_structure(params = {}) ⇒ Types::DescribeUserHierarchyStructureResponse

Describes the hierarchy structure of the specified Amazon Connect instance.

Examples:

Request syntax with placeholder values


resp = client.describe_user_hierarchy_structure({
  instance_id: "InstanceId", # required
})

Response structure


resp.hierarchy_structure.level_one.id #=> String
resp.hierarchy_structure.level_one.arn #=> String
resp.hierarchy_structure.level_one.name #=> String
resp.hierarchy_structure.level_one.last_modified_time #=> Time
resp.hierarchy_structure.level_one.last_modified_region #=> String
resp.hierarchy_structure.level_two.id #=> String
resp.hierarchy_structure.level_two.arn #=> String
resp.hierarchy_structure.level_two.name #=> String
resp.hierarchy_structure.level_two.last_modified_time #=> Time
resp.hierarchy_structure.level_two.last_modified_region #=> String
resp.hierarchy_structure.level_three.id #=> String
resp.hierarchy_structure.level_three.arn #=> String
resp.hierarchy_structure.level_three.name #=> String
resp.hierarchy_structure.level_three.last_modified_time #=> Time
resp.hierarchy_structure.level_three.last_modified_region #=> String
resp.hierarchy_structure.level_four.id #=> String
resp.hierarchy_structure.level_four.arn #=> String
resp.hierarchy_structure.level_four.name #=> String
resp.hierarchy_structure.level_four.last_modified_time #=> Time
resp.hierarchy_structure.level_four.last_modified_region #=> String
resp.hierarchy_structure.level_five.id #=> String
resp.hierarchy_structure.level_five.arn #=> String
resp.hierarchy_structure.level_five.name #=> String
resp.hierarchy_structure.level_five.last_modified_time #=> Time
resp.hierarchy_structure.level_five.last_modified_region #=> String

Parameters:

  • params (Hash) (defaults to: {})

    ({})

Options Hash (params):

  • :instance_id (required, String)

    The identifier of the Amazon Connect instance. You can find the instance ID in the Amazon Resource Name (ARN) of the instance.

Returns:

See Also:



5459
5460
5461
5462
# File 'gems/aws-sdk-connect/lib/aws-sdk-connect/client.rb', line 5459

def describe_user_hierarchy_structure(params = {}, options = {})
  req = build_request(:describe_user_hierarchy_structure, params)
  req.send_request(options)
end

#describe_view(params = {}) ⇒ Types::DescribeViewResponse

Retrieves the view for the specified Amazon Connect instance and view identifier.

The view identifier can be supplied as a ViewId or ARN.

$SAVED needs to be supplied if a view is unpublished.

The view identifier can contain an optional qualifier, for example, <view-id>:$SAVED, which is either an actual version number or an Amazon Connect managed qualifier $SAVED | $LATEST. If it is not supplied, then $LATEST is assumed for customer managed views and an error is returned if there is no published content available. Version 1 is assumed for Amazon Web Services managed views.

Examples:

Request syntax with placeholder values


resp = client.describe_view({
  instance_id: "ViewsInstanceId", # required
  view_id: "ViewId", # required
})

Response structure


resp.view.id #=> String
resp.view.arn #=> String
resp.view.name #=> String
resp.view.status #=> String, one of "PUBLISHED", "SAVED"
resp.view.type #=> String, one of "CUSTOMER_MANAGED", "AWS_MANAGED"
resp.view.description #=> String
resp.view.version #=> Integer
resp.view.version_description #=> String
resp.view.content.input_schema #=> String
resp.view.content.template #=> String
resp.view.content.actions #=> Array
resp.view.content.actions[0] #=> String
resp.view.tags #=> Hash
resp.view.tags["TagKey"] #=> String
resp.view.created_time #=> Time
resp.view.last_modified_time #=> Time
resp.view.view_content_sha_256 #=> String

Parameters:

  • params (Hash) (defaults to: {})

    ({})

Options Hash (params):

  • :instance_id (required, String)

    The identifier of the Amazon Connect instance. You can find the instanceId in the ARN of the instance.

  • :view_id (required, String)

    The ViewId of the view. This must be an ARN for Amazon Web Services managed views.

Returns:

See Also:



5521
5522
5523
5524
# File 'gems/aws-sdk-connect/lib/aws-sdk-connect/client.rb', line 5521

def describe_view(params = {}, options = {})
  req = build_request(:describe_view, params)
  req.send_request(options)
end

#describe_vocabulary(params = {}) ⇒ Types::DescribeVocabularyResponse

Describes the specified vocabulary.

Examples:

Request syntax with placeholder values


resp = client.describe_vocabulary({
  instance_id: "InstanceId", # required
  vocabulary_id: "VocabularyId", # required
})

Response structure


resp.vocabulary.name #=> String
resp.vocabulary.id #=> String
resp.vocabulary.arn #=> String
resp.vocabulary.language_code #=> String, one of "ar-AE", "de-CH", "de-DE", "en-AB", "en-AU", "en-GB", "en-IE", "en-IN", "en-US", "en-WL", "es-ES", "es-US", "fr-CA", "fr-FR", "hi-IN", "it-IT", "ja-JP", "ko-KR", "pt-BR", "pt-PT", "zh-CN", "en-NZ", "en-ZA"
resp.vocabulary.state #=> String, one of "CREATION_IN_PROGRESS", "ACTIVE", "CREATION_FAILED", "DELETE_IN_PROGRESS"
resp.vocabulary.last_modified_time #=> Time
resp.vocabulary.failure_reason #=> String
resp.vocabulary.content #=> String
resp.vocabulary.tags #=> Hash
resp.vocabulary.tags["TagKey"] #=> String

Parameters:

  • params (Hash) (defaults to: {})

    ({})

Options Hash (params):

  • :instance_id (required, String)

    The identifier of the Amazon Connect instance. You can find the instance ID in the Amazon Resource Name (ARN) of the instance.

  • :vocabulary_id (required, String)

    The identifier of the custom vocabulary.

Returns:

See Also:



5567
5568
5569
5570
# File 'gems/aws-sdk-connect/lib/aws-sdk-connect/client.rb', line 5567

def describe_vocabulary(params = {}, options = {})
  req = build_request(:describe_vocabulary, params)
  req.send_request(options)
end

#disassociate_analytics_data_set(params = {}) ⇒ Struct

This API is in preview release for Amazon Connect and is subject to change.

Removes the dataset ID associated with a given Amazon Connect instance.

Examples:

Request syntax with placeholder values


resp = client.disassociate_analytics_data_set({
  instance_id: "InstanceId", # required
  data_set_id: "DataSetId", # required
  target_account_id: "AWSAccountId",
})

Parameters:

  • params (Hash) (defaults to: {})

    ({})

Options Hash (params):

  • :instance_id (required, String)

    The identifier of the Amazon Connect instance. You can find the instance ID in the Amazon Resource Name (ARN) of the instance.

  • :data_set_id (required, String)

    The identifier of the dataset to remove.

  • :target_account_id (String)

    The identifier of the target account. Use to associate a dataset to a different account than the one containing the Amazon Connect instance. If not specified, by default this value is the Amazon Web Services account that has the Amazon Connect instance.

Returns:

  • (Struct)

    Returns an empty response.

See Also:



5609
5610
5611
5612
# File 'gems/aws-sdk-connect/lib/aws-sdk-connect/client.rb', line 5609

def disassociate_analytics_data_set(params = {}, options = {})
  req = build_request(:disassociate_analytics_data_set, params)
  req.send_request(options)
end

#disassociate_approved_origin(params = {}) ⇒ Struct

This API is in preview release for Amazon Connect and is subject to change.

Revokes access to integrated applications from Amazon Connect.

Examples:

Request syntax with placeholder values


resp = client.disassociate_approved_origin({
  instance_id: "InstanceId", # required
  origin: "Origin", # required
})

Parameters:

  • params (Hash) (defaults to: {})

    ({})

Options Hash (params):

  • :instance_id (required, String)