Connect / Client / describe_rule

describe_rule#

Connect.Client.describe_rule(**kwargs)#

Describes a rule for the specified Amazon Connect instance.

See also: AWS API Documentation

Request Syntax

response = client.describe_rule(
    InstanceId='string',
    RuleId='string'
)
Parameters:
  • InstanceId (string) –

    [REQUIRED]

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

  • RuleId (string) –

    [REQUIRED]

    A unique identifier for the rule.

Return type:

dict

Returns:

Response Syntax

{
    'Rule': {
        'Name': 'string',
        'RuleId': 'string',
        'RuleArn': 'string',
        'TriggerEventSource': {
            'EventSourceName': 'OnPostCallAnalysisAvailable'|'OnRealTimeCallAnalysisAvailable'|'OnRealTimeChatAnalysisAvailable'|'OnPostChatAnalysisAvailable'|'OnZendeskTicketCreate'|'OnZendeskTicketStatusUpdate'|'OnSalesforceCaseCreate'|'OnContactEvaluationSubmit'|'OnMetricDataUpdate'|'OnCaseCreate'|'OnCaseUpdate',
            'IntegrationAssociationId': 'string'
        },
        'Function': 'string',
        'Actions': [
            {
                'ActionType': 'CREATE_TASK'|'ASSIGN_CONTACT_CATEGORY'|'GENERATE_EVENTBRIDGE_EVENT'|'SEND_NOTIFICATION'|'CREATE_CASE'|'UPDATE_CASE'|'END_ASSOCIATED_TASKS'|'SUBMIT_AUTO_EVALUATION',
                'TaskAction': {
                    'Name': 'string',
                    'Description': 'string',
                    'ContactFlowId': 'string',
                    'References': {
                        'string': {
                            'Value': 'string',
                            'Type': 'URL'|'ATTACHMENT'|'NUMBER'|'STRING'|'DATE'|'EMAIL'
                        }
                    }
                },
                'EventBridgeAction': {
                    'Name': 'string'
                },
                'AssignContactCategoryAction': {},
                'SendNotificationAction': {
                    'DeliveryMethod': 'EMAIL',
                    'Subject': 'string',
                    'Content': 'string',
                    'ContentType': 'PLAIN_TEXT',
                    'Recipient': {
                        'UserTags': {
                            'string': 'string'
                        },
                        'UserIds': [
                            'string',
                        ]
                    }
                },
                'CreateCaseAction': {
                    'Fields': [
                        {
                            'Id': 'string',
                            'Value': {
                                'BooleanValue': True|False,
                                'DoubleValue': 123.0,
                                'EmptyValue': {},
                                'StringValue': 'string'
                            }
                        },
                    ],
                    'TemplateId': 'string'
                },
                'UpdateCaseAction': {
                    'Fields': [
                        {
                            'Id': 'string',
                            'Value': {
                                'BooleanValue': True|False,
                                'DoubleValue': 123.0,
                                'EmptyValue': {},
                                'StringValue': 'string'
                            }
                        },
                    ]
                },
                'EndAssociatedTasksAction': {},
                'SubmitAutoEvaluationAction': {
                    'EvaluationFormId': 'string'
                }
            },
        ],
        'PublishStatus': 'DRAFT'|'PUBLISHED',
        'CreatedTime': datetime(2015, 1, 1),
        'LastUpdatedTime': datetime(2015, 1, 1),
        'LastUpdatedBy': 'string',
        'Tags': {
            'string': 'string'
        }
    }
}

Response Structure

  • (dict) –

    • Rule (dict) –

      Information about the rule.

      • Name (string) –

        The name of the rule.

      • RuleId (string) –

        A unique identifier for the rule.

      • RuleArn (string) –

        The Amazon Resource Name (ARN) of the rule.

      • TriggerEventSource (dict) –

        The event source to trigger the rule.

        • EventSourceName (string) –

          The name of the event source.

        • IntegrationAssociationId (string) –

          The identifier for the integration association.

      • Function (string) –

        The conditions of the rule.

      • Actions (list) –

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

        • (dict) –

          Information about the action to be performed when a rule is triggered.

          • ActionType (string) –

            The type of action that creates a rule.

          • TaskAction (dict) –

            Information about the task action. This field is required if TriggerEventSource is one of the following values: OnZendeskTicketCreate | OnZendeskTicketStatusUpdate | OnSalesforceCaseCreate

            • Name (string) –

              The name. Supports variable injection. For more information, see JSONPath reference in the Amazon Connect Administrators Guide.

            • Description (string) –

              The description. Supports variable injection. For more information, see JSONPath reference in the Amazon Connect Administrators Guide.

            • ContactFlowId (string) –

              The identifier of the flow.

            • References (dict) –

              Information about the reference when the referenceType is URL. Otherwise, null. (Supports variable injection in the Value field.)

              • (string) –

                • (dict) –

                  Well-formed data on a contact, used by agents to complete a contact request. You can have up to 4,096 UTF-8 bytes across all references for a contact.

                  • Value (string) –

                    A valid value for the reference. For example, for a URL reference, a formatted URL that is displayed to an agent in the Contact Control Panel (CCP).

                  • Type (string) –

                    The type of the reference. DATE must be of type Epoch timestamp.

          • EventBridgeAction (dict) –

            Information about the EventBridge action.

            Supported only for TriggerEventSource values: OnPostCallAnalysisAvailable | OnRealTimeCallAnalysisAvailable | OnRealTimeChatAnalysisAvailable | OnPostChatAnalysisAvailable | OnContactEvaluationSubmit | OnMetricDataUpdate

            • Name (string) –

              The name.

          • AssignContactCategoryAction (dict) –

            Information about the contact category action.

            Supported only for TriggerEventSource values: OnPostCallAnalysisAvailable | OnRealTimeCallAnalysisAvailable | OnRealTimeChatAnalysisAvailable | OnPostChatAnalysisAvailable | OnZendeskTicketCreate | OnZendeskTicketStatusUpdate | OnSalesforceCaseCreate

          • SendNotificationAction (dict) –

            Information about the send notification action.

            Supported only for TriggerEventSource values: OnPostCallAnalysisAvailable | OnRealTimeCallAnalysisAvailable | OnRealTimeChatAnalysisAvailable | OnPostChatAnalysisAvailable | OnContactEvaluationSubmit | OnMetricDataUpdate

            • DeliveryMethod (string) –

              Notification delivery method.

            • Subject (string) –

              The subject of the email if the delivery method is EMAIL. Supports variable injection. For more information, see JSONPath reference in the Amazon Connect Administrators Guide.

            • Content (string) –

              Notification content. Supports variable injection. For more information, see JSONPath reference in the Amazon Connect Administrators Guide.

            • ContentType (string) –

              Content type format.

            • Recipient (dict) –

              Notification recipient.

              • UserTags (dict) –

                The tags used to organize, track, or control access for this resource. For example, { “Tags”: {“key1”:”value1”, “key2”:”value2”} }. Amazon Connect users with the specified tags will be notified.

                • (string) –

                  • (string) –

              • UserIds (list) –

                A list of user IDs.

                • (string) –

          • CreateCaseAction (dict) –

            Information about the create case action.

            Supported only for TriggerEventSource values: OnPostCallAnalysisAvailable | OnPostChatAnalysisAvailable.

            • Fields (list) –

              An array of objects with Field ID and Value data.

              • (dict) –

                Object for case field values.

                • Id (string) –

                  Unique identifier of a field.

                • Value (dict) –

                  Union of potential field value types.

                  • BooleanValue (boolean) –

                    A Boolean number value type.

                  • DoubleValue (float) –

                    A Double number value type.

                  • EmptyValue (dict) –

                    An empty value.

                  • StringValue (string) –

                    String value type.

            • TemplateId (string) –

              A unique identifier of a template.

          • UpdateCaseAction (dict) –

            Information about the update case action.

            Supported only for TriggerEventSource values: OnCaseCreate | OnCaseUpdate.

            • Fields (list) –

              An array of objects with Field ID and Value data.

              • (dict) –

                Object for case field values.

                • Id (string) –

                  Unique identifier of a field.

                • Value (dict) –

                  Union of potential field value types.

                  • BooleanValue (boolean) –

                    A Boolean number value type.

                  • DoubleValue (float) –

                    A Double number value type.

                  • EmptyValue (dict) –

                    An empty value.

                  • StringValue (string) –

                    String value type.

          • EndAssociatedTasksAction (dict) –

            Information about the end associated tasks action.

            Supported only for TriggerEventSource values: OnCaseUpdate.

          • SubmitAutoEvaluationAction (dict) –

            Information about the submit automated evaluation action.

            • EvaluationFormId (string) –

              The identifier of the auto-evaluation enabled form.

      • PublishStatus (string) –

        The publish status of the rule.

      • CreatedTime (datetime) –

        The timestamp for when the rule was created.

      • LastUpdatedTime (datetime) –

        The timestamp for the when the rule was last updated.

      • LastUpdatedBy (string) –

        The Amazon Resource Name (ARN) of the user who last updated the rule.

      • Tags (dict) –

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

        • (string) –

          • (string) –

Exceptions

  • Connect.Client.exceptions.InvalidRequestException

  • Connect.Client.exceptions.ResourceNotFoundException

  • Connect.Client.exceptions.InternalServiceException

  • Connect.Client.exceptions.ThrottlingException

  • Connect.Client.exceptions.AccessDeniedException