Skip to content

SendVoiceMessageRequest

Source code in docs_src/capo_pinpoint_sms_voice_v2/types/send_voice_message_request.py
class SendVoiceMessageRequest(TypedDict, closed=True):
    destination_phone_number: (
        "capo_pinpoint_sms_voice_v2.types.phone_number.PhoneNumber"
    )
    """<p>The destination phone number in E.164 format.</p>"""
    origination_identity: "capo_pinpoint_sms_voice_v2.types.voice_message_origination_identity.VoiceMessageOriginationIdentity"
    """<p>The origination identity to use for the voice call. This can be the PhoneNumber, PhoneNumberId, PhoneNumberArn, PoolId, or PoolArn.</p> <important> <p>If you are using a shared End User Messaging SMS resource then you must use the full Amazon Resource Name(ARN).</p> </important>"""
    message_body: NotRequired[
        "capo_pinpoint_sms_voice_v2.types.voice_message_body.VoiceMessageBody"
    ]
    """<p>The text to convert to a voice message.</p>"""
    message_body_text_type: NotRequired[
        "capo_pinpoint_sms_voice_v2.types.voice_message_body_text_type.VoiceMessageBodyTextType"
    ]
    """<p>Specifies if the MessageBody field contains text or <a href="https://docs.aws.amazon.com/polly/latest/dg/what-is.html">speech synthesis markup language (SSML)</a>.</p> <ul> <li> <p>TEXT: This is the default value. When used the maximum character limit is 3000.</p> </li> <li> <p>SSML: When used the maximum character limit is 6000 including SSML tagging.</p> </li> </ul>"""
    voice_id: NotRequired["capo_pinpoint_sms_voice_v2.types.voice_id.VoiceId"]
    """<p>The voice for the <a href="https://docs.aws.amazon.com/polly/latest/dg/what-is.html">Amazon Polly</a> service to use. By default this is set to "MATTHEW".</p>"""
    configuration_set_name: NotRequired[
        "capo_pinpoint_sms_voice_v2.types.configuration_set_name_or_arn.ConfigurationSetNameOrArn"
    ]
    """<p>The name of the configuration set to use. This can be either the ConfigurationSetName or ConfigurationSetArn.</p>"""
    max_price_per_minute: NotRequired[
        "capo_pinpoint_sms_voice_v2.types.max_price.MaxPrice"
    ]
    """<p>The maximum amount to spend per voice message, in US dollars.</p>"""
    time_to_live: NotRequired[
        "capo_pinpoint_sms_voice_v2.types.time_to_live.TimeToLive"
    ]
    """<p>How long the voice message is valid for. By default this is 72 hours.</p>"""
    context: NotRequired["capo_pinpoint_sms_voice_v2.types.context_map.ContextMap"]
    """<p>You can specify custom data in this field. If you do, that data is logged to the event destination.</p>"""
    dry_run: "bool"
    """<p>When set to true, the message is checked and validated, but isn't sent to the end recipient.</p>"""
    protect_configuration_id: NotRequired[
        "capo_pinpoint_sms_voice_v2.types.protect_configuration_id_or_arn.ProtectConfigurationIdOrArn"
    ]
    """<p>The unique identifier for the protect configuration.</p>"""
    message_feedback_enabled: NotRequired["bool"]
    """<p>Set to true to enable message feedback for the message. When a user receives the message you need to update the message status using <a>PutMessageFeedback</a>.</p>"""

configuration_set_name instance-attribute

configuration_set_name: NotRequired[ConfigurationSetNameOrArn]

The name of the configuration set to use. This can be either the ConfigurationSetName or ConfigurationSetArn.

context instance-attribute

context: NotRequired[ContextMap]

You can specify custom data in this field. If you do, that data is logged to the event destination.

destination_phone_number instance-attribute

destination_phone_number: PhoneNumber

The destination phone number in E.164 format.

dry_run instance-attribute

dry_run: bool

When set to true, the message is checked and validated, but isn't sent to the end recipient.

max_price_per_minute instance-attribute

max_price_per_minute: NotRequired[MaxPrice]

The maximum amount to spend per voice message, in US dollars.

message_body instance-attribute

message_body: NotRequired[VoiceMessageBody]

The text to convert to a voice message.

message_body_text_type instance-attribute

message_body_text_type: NotRequired[VoiceMessageBodyTextType]

Specifies if the MessageBody field contains text or speech synthesis markup language (SSML).

  • TEXT: This is the default value. When used the maximum character limit is 3000.

  • SSML: When used the maximum character limit is 6000 including SSML tagging.

message_feedback_enabled instance-attribute

message_feedback_enabled: NotRequired[bool]

Set to true to enable message feedback for the message. When a user receives the message you need to update the message status using PutMessageFeedback.

origination_identity instance-attribute

origination_identity: VoiceMessageOriginationIdentity

The origination identity to use for the voice call. This can be the PhoneNumber, PhoneNumberId, PhoneNumberArn, PoolId, or PoolArn.

If you are using a shared End User Messaging SMS resource then you must use the full Amazon Resource Name(ARN).

protect_configuration_id instance-attribute

protect_configuration_id: NotRequired[ProtectConfigurationIdOrArn]

The unique identifier for the protect configuration.

time_to_live instance-attribute

time_to_live: NotRequired[TimeToLive]

How long the voice message is valid for. By default this is 72 hours.

voice_id instance-attribute

voice_id: NotRequired[VoiceId]

The voice for the Amazon Polly service to use. By default this is set to "MATTHEW".