Module aws_lambda_powertools.utilities.data_classes.connect_contact_flow_event

Classes

class ConnectContactFlowChannel (*args, **kwds)

Create a collection of name/value pairs.

Example enumeration:

>>> class Color(Enum):
...     RED = 1
...     BLUE = 2
...     GREEN = 3

Access them by:

• attribute access:

Color.RED

• value lookup:

Color(1)

• name lookup:

Color['RED']

Enumerations can be iterated over, and know how many members they have:

>>> len(Color)
3

>>> list(Color)
[<Color.RED: 1>, <Color.BLUE: 2>, <Color.GREEN: 3>]

Methods can be added to enumerations, and members can have their own attributes – see the documentation for details.

Expand source code

class ConnectContactFlowChannel(Enum):
    VOICE = auto()
    CHAT = auto()

Ancestors

• enum.Enum

Class variables

var CHAT

var VOICE

class ConnectContactFlowData (data: dict[str, Any], json_deserializer: Callable | None = None)

Provides a single read only access to a wrapper dict

Parameters

data : dict[str, Any]

Lambda Event Source Event payload

json_deserializer : Callable, optional

function to deserialize str, bytes, bytearray containing a JSON document to a Python obj, by default json.loads

Expand source code

class ConnectContactFlowData(DictWrapper):
    @property
    def attributes(self) -> dict[str, str]:
        """These are attributes that have been previously associated with a contact,
        such as when using a Set contact attributes block in a contact flow.
        This map may be empty if there aren't any saved attributes.
        """
        return self["Attributes"]

    @property
    def channel(self) -> ConnectContactFlowChannel:
        """The method used to contact your contact center."""
        return ConnectContactFlowChannel[self["Channel"]]

    @property
    def contact_id(self) -> str:
        """The unique identifier of the contact."""
        return self["ContactId"]

    @property
    def customer_endpoint(self) -> ConnectContactFlowEndpoint | None:
        """Contains the customer’s address (number) and type of address."""
        if self["CustomerEndpoint"] is not None:
            return ConnectContactFlowEndpoint(self["CustomerEndpoint"])
        return None

    @property
    def initial_contact_id(self) -> str:
        """The unique identifier for the contact associated with the first interaction between the customer and your
        contact center. Use the initial contact ID to track contacts between contact flows.
        """
        return self["InitialContactId"]

    @property
    def initiation_method(self) -> ConnectContactFlowInitiationMethod:
        """How the contact was initiated."""
        return ConnectContactFlowInitiationMethod[self["InitiationMethod"]]

    @property
    def instance_arn(self) -> str:
        """The ARN for your Amazon Connect instance."""
        return self["InstanceARN"]

    @property
    def previous_contact_id(self) -> str:
        """The unique identifier for the contact before it was transferred.
        Use the previous contact ID to trace contacts between contact flows.
        """
        return self["PreviousContactId"]

    @property
    def queue(self) -> ConnectContactFlowQueue | None:
        """The current queue."""
        if self["Queue"] is not None:
            return ConnectContactFlowQueue(self["Queue"])
        return None

    @property
    def system_endpoint(self) -> ConnectContactFlowEndpoint | None:
        """Contains the address (number) the customer dialed to call your contact center and type of address."""
        if self["SystemEndpoint"] is not None:
            return ConnectContactFlowEndpoint(self["SystemEndpoint"])
        return None

    @property
    def media_streams(self) -> ConnectContactFlowMediaStreams:
        return ConnectContactFlowMediaStreams(self["MediaStreams"])

Ancestors

• DictWrapper
• collections.abc.Mapping
• collections.abc.Collection
• collections.abc.Sized
• collections.abc.Iterable
• collections.abc.Container
• typing.Generic

Instance variables

prop attributes : dict[str, str]

These are attributes that have been previously associated with a contact, such as when using a Set contact attributes block in a contact flow. This map may be empty if there aren't any saved attributes.

Expand source code

@property
def attributes(self) -> dict[str, str]:
    """These are attributes that have been previously associated with a contact,
    such as when using a Set contact attributes block in a contact flow.
    This map may be empty if there aren't any saved attributes.
    """
    return self["Attributes"]

prop channel : ConnectContactFlowChannel

The method used to contact your contact center.

Expand source code

@property
def channel(self) -> ConnectContactFlowChannel:
    """The method used to contact your contact center."""
    return ConnectContactFlowChannel[self["Channel"]]

prop contact_id : str

The unique identifier of the contact.

Expand source code

@property
def contact_id(self) -> str:
    """The unique identifier of the contact."""
    return self["ContactId"]

prop customer_endpoint : ConnectContactFlowEndpoint | None

Contains the customer’s address (number) and type of address.

Expand source code

@property
def customer_endpoint(self) -> ConnectContactFlowEndpoint | None:
    """Contains the customer’s address (number) and type of address."""
    if self["CustomerEndpoint"] is not None:
        return ConnectContactFlowEndpoint(self["CustomerEndpoint"])
    return None

prop initial_contact_id : str

The unique identifier for the contact associated with the first interaction between the customer and your contact center. Use the initial contact ID to track contacts between contact flows.

Expand source code

@property
def initial_contact_id(self) -> str:
    """The unique identifier for the contact associated with the first interaction between the customer and your
    contact center. Use the initial contact ID to track contacts between contact flows.
    """
    return self["InitialContactId"]

prop initiation_method : ConnectContactFlowInitiationMethod

How the contact was initiated.

Expand source code

@property
def initiation_method(self) -> ConnectContactFlowInitiationMethod:
    """How the contact was initiated."""
    return ConnectContactFlowInitiationMethod[self["InitiationMethod"]]

prop instance_arn : str

The ARN for your Amazon Connect instance.

Expand source code

@property
def instance_arn(self) -> str:
    """The ARN for your Amazon Connect instance."""
    return self["InstanceARN"]

prop media_streams : ConnectContactFlowMediaStreams

Expand source code

@property
def media_streams(self) -> ConnectContactFlowMediaStreams:
    return ConnectContactFlowMediaStreams(self["MediaStreams"])

prop previous_contact_id : str

The unique identifier for the contact before it was transferred. Use the previous contact ID to trace contacts between contact flows.

Expand source code

@property
def previous_contact_id(self) -> str:
    """The unique identifier for the contact before it was transferred.
    Use the previous contact ID to trace contacts between contact flows.
    """
    return self["PreviousContactId"]

prop queue : ConnectContactFlowQueue | None

The current queue.

Expand source code

@property
def queue(self) -> ConnectContactFlowQueue | None:
    """The current queue."""
    if self["Queue"] is not None:
        return ConnectContactFlowQueue(self["Queue"])
    return None

prop system_endpoint : ConnectContactFlowEndpoint | None

Contains the address (number) the customer dialed to call your contact center and type of address.

Expand source code

@property
def system_endpoint(self) -> ConnectContactFlowEndpoint | None:
    """Contains the address (number) the customer dialed to call your contact center and type of address."""
    if self["SystemEndpoint"] is not None:
        return ConnectContactFlowEndpoint(self["SystemEndpoint"])
    return None

Inherited members

• DictWrapper:
  • get
  • raw_event

class ConnectContactFlowEndpoint (data: dict[str, Any], json_deserializer: Callable | None = None)

Provides a single read only access to a wrapper dict

Parameters

data : dict[str, Any]

Lambda Event Source Event payload

json_deserializer : Callable, optional

function to deserialize str, bytes, bytearray containing a JSON document to a Python obj, by default json.loads

Expand source code

class ConnectContactFlowEndpoint(DictWrapper):
    @property
    def address(self) -> str:
        """The phone number."""
        return self["Address"]

    @property
    def endpoint_type(self) -> ConnectContactFlowEndpointType:
        """The endpoint type."""
        return ConnectContactFlowEndpointType[self["Type"]]

Ancestors

• DictWrapper
• collections.abc.Mapping
• collections.abc.Collection
• collections.abc.Sized
• collections.abc.Iterable
• collections.abc.Container
• typing.Generic

Instance variables

prop address : str

The phone number.

Expand source code

@property
def address(self) -> str:
    """The phone number."""
    return self["Address"]

prop endpoint_type : ConnectContactFlowEndpointType

The endpoint type.

Expand source code

@property
def endpoint_type(self) -> ConnectContactFlowEndpointType:
    """The endpoint type."""
    return ConnectContactFlowEndpointType[self["Type"]]

Inherited members

• DictWrapper:
  • get
  • raw_event

class ConnectContactFlowEndpointType (*args, **kwds)

Create a collection of name/value pairs.

Example enumeration:

>>> class Color(Enum):
...     RED = 1
...     BLUE = 2
...     GREEN = 3

Access them by:

• attribute access:

Color.RED

• value lookup:

Color(1)

• name lookup:

Color['RED']

Enumerations can be iterated over, and know how many members they have:

>>> len(Color)
3

>>> list(Color)
[<Color.RED: 1>, <Color.BLUE: 2>, <Color.GREEN: 3>]

Methods can be added to enumerations, and members can have their own attributes – see the documentation for details.

Expand source code

class ConnectContactFlowEndpointType(Enum):
    TELEPHONE_NUMBER = auto()

Ancestors

• enum.Enum

Class variables

var TELEPHONE_NUMBER

class ConnectContactFlowEvent (data: dict[str, Any], json_deserializer: Callable | None = None)

Amazon Connect contact flow event

Documentation:

• https://docs.aws.amazon.com/connect/latest/adminguide/connect-lambda-functions.html

Parameters

data : dict[str, Any]

Lambda Event Source Event payload

json_deserializer : Callable, optional

function to deserialize str, bytes, bytearray containing a JSON document to a Python obj, by default json.loads

Expand source code

class ConnectContactFlowEvent(DictWrapper):
    """Amazon Connect contact flow event

    Documentation:
    -------------
    - https://docs.aws.amazon.com/connect/latest/adminguide/connect-lambda-functions.html
    """

    @property
    def contact_data(self) -> ConnectContactFlowData:
        """This is always passed by Amazon Connect for every contact. Some parameters are optional."""
        return ConnectContactFlowData(self["Details"]["ContactData"])

    @property
    def parameters(self) -> dict[str, str]:
        """These are parameters specific to this call that were defined when you created the Lambda function."""
        return self["Details"]["Parameters"]

Ancestors

• DictWrapper
• collections.abc.Mapping
• collections.abc.Collection
• collections.abc.Sized
• collections.abc.Iterable
• collections.abc.Container
• typing.Generic

Instance variables

prop contact_data : ConnectContactFlowData

This is always passed by Amazon Connect for every contact. Some parameters are optional.

Expand source code

@property
def contact_data(self) -> ConnectContactFlowData:
    """This is always passed by Amazon Connect for every contact. Some parameters are optional."""
    return ConnectContactFlowData(self["Details"]["ContactData"])

prop parameters : dict[str, str]

These are parameters specific to this call that were defined when you created the Lambda function.

Expand source code

@property
def parameters(self) -> dict[str, str]:
    """These are parameters specific to this call that were defined when you created the Lambda function."""
    return self["Details"]["Parameters"]

Inherited members

• DictWrapper:
  • get
  • raw_event

class ConnectContactFlowInitiationMethod (*args, **kwds)

Create a collection of name/value pairs.

Example enumeration:

>>> class Color(Enum):
...     RED = 1
...     BLUE = 2
...     GREEN = 3

Access them by:

• attribute access:

Color.RED

• value lookup:

Color(1)

• name lookup:

Color['RED']

Enumerations can be iterated over, and know how many members they have:

>>> len(Color)
3

>>> list(Color)
[<Color.RED: 1>, <Color.BLUE: 2>, <Color.GREEN: 3>]

Methods can be added to enumerations, and members can have their own attributes – see the documentation for details.

Expand source code

class ConnectContactFlowInitiationMethod(Enum):
    INBOUND = auto()
    OUTBOUND = auto()
    TRANSFER = auto()
    CALLBACK = auto()
    API = auto()

Ancestors

• enum.Enum

Class variables

var API

var CALLBACK

var INBOUND

var OUTBOUND

var TRANSFER

class ConnectContactFlowMediaStreamAudio (data: dict[str, Any], json_deserializer: Callable | None = None)

Provides a single read only access to a wrapper dict

Parameters

data : dict[str, Any]

Lambda Event Source Event payload

json_deserializer : Callable, optional

function to deserialize str, bytes, bytearray containing a JSON document to a Python obj, by default json.loads

Expand source code

class ConnectContactFlowMediaStreamAudio(DictWrapper):
    @property
    def start_fragment_number(self) -> str | None:
        """The number that identifies the Kinesis Video Streams fragment, in the stream used for Live media streaming,
        in which the customer audio stream started.
        """
        return self["StartFragmentNumber"]

    @property
    def start_timestamp(self) -> str | None:
        """When the customer audio stream started."""
        return self["StartTimestamp"]

    @property
    def stream_arn(self) -> str | None:
        """The ARN of the Kinesis Video stream used for Live media streaming that includes the customer data to
        reference.
        """
        return self["StreamARN"]

Ancestors

• DictWrapper
• collections.abc.Mapping
• collections.abc.Collection
• collections.abc.Sized
• collections.abc.Iterable
• collections.abc.Container
• typing.Generic

Instance variables

prop start_fragment_number : str | None

The number that identifies the Kinesis Video Streams fragment, in the stream used for Live media streaming, in which the customer audio stream started.

Expand source code

@property
def start_fragment_number(self) -> str | None:
    """The number that identifies the Kinesis Video Streams fragment, in the stream used for Live media streaming,
    in which the customer audio stream started.
    """
    return self["StartFragmentNumber"]

prop start_timestamp : str | None

When the customer audio stream started.

Expand source code

@property
def start_timestamp(self) -> str | None:
    """When the customer audio stream started."""
    return self["StartTimestamp"]

prop stream_arn : str | None

The ARN of the Kinesis Video stream used for Live media streaming that includes the customer data to reference.

Expand source code

@property
def stream_arn(self) -> str | None:
    """The ARN of the Kinesis Video stream used for Live media streaming that includes the customer data to
    reference.
    """
    return self["StreamARN"]

Inherited members

• DictWrapper:
  • get
  • raw_event

class ConnectContactFlowMediaStreamCustomer (data: dict[str, Any], json_deserializer: Callable | None = None)

Provides a single read only access to a wrapper dict

Parameters

data : dict[str, Any]

Lambda Event Source Event payload

json_deserializer : Callable, optional

function to deserialize str, bytes, bytearray containing a JSON document to a Python obj, by default json.loads

Expand source code

class ConnectContactFlowMediaStreamCustomer(DictWrapper):
    @property
    def audio(self) -> ConnectContactFlowMediaStreamAudio:
        return ConnectContactFlowMediaStreamAudio(self["Audio"])

Ancestors

• DictWrapper
• collections.abc.Mapping
• collections.abc.Collection
• collections.abc.Sized
• collections.abc.Iterable
• collections.abc.Container
• typing.Generic

Instance variables

prop audio : ConnectContactFlowMediaStreamAudio

Expand source code

@property
def audio(self) -> ConnectContactFlowMediaStreamAudio:
    return ConnectContactFlowMediaStreamAudio(self["Audio"])

Inherited members

• DictWrapper:
  • get
  • raw_event

class ConnectContactFlowMediaStreams (data: dict[str, Any], json_deserializer: Callable | None = None)

Provides a single read only access to a wrapper dict

Parameters

data : dict[str, Any]

Lambda Event Source Event payload

json_deserializer : Callable, optional

function to deserialize str, bytes, bytearray containing a JSON document to a Python obj, by default json.loads

Expand source code

class ConnectContactFlowMediaStreams(DictWrapper):
    @property
    def customer(self) -> ConnectContactFlowMediaStreamCustomer:
        return ConnectContactFlowMediaStreamCustomer(self["Customer"])

Ancestors

• DictWrapper
• collections.abc.Mapping
• collections.abc.Collection
• collections.abc.Sized
• collections.abc.Iterable
• collections.abc.Container
• typing.Generic

Instance variables

prop customer : ConnectContactFlowMediaStreamCustomer

Expand source code

@property
def customer(self) -> ConnectContactFlowMediaStreamCustomer:
    return ConnectContactFlowMediaStreamCustomer(self["Customer"])

Inherited members

• DictWrapper:
  • get
  • raw_event

class ConnectContactFlowQueue (data: dict[str, Any], json_deserializer: Callable | None = None)

Provides a single read only access to a wrapper dict

Parameters

data : dict[str, Any]

Lambda Event Source Event payload

json_deserializer : Callable, optional

function to deserialize str, bytes, bytearray containing a JSON document to a Python obj, by default json.loads

Expand source code

class ConnectContactFlowQueue(DictWrapper):
    @property
    def arn(self) -> str:
        """The unique queue ARN."""
        return self["ARN"]

    @property
    def name(self) -> str:
        """The queue name."""
        return self["Name"]

Ancestors

• DictWrapper
• collections.abc.Mapping
• collections.abc.Collection
• collections.abc.Sized
• collections.abc.Iterable
• collections.abc.Container
• typing.Generic

Instance variables

prop arn : str

The unique queue ARN.

Expand source code

@property
def arn(self) -> str:
    """The unique queue ARN."""
    return self["ARN"]

prop name : str

The queue name.

Expand source code

@property
def name(self) -> str:
    """The queue name."""
    return self["Name"]

Inherited members

• DictWrapper:
  • get
  • raw_event