Skip to content

SendMediaMessageRequest

Source code in docs_src/capo_pinpoint_sms_voice_v2/types/send_media_message_request.py
class SendMediaMessageRequest(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.media_message_origination_identity.MediaMessageOriginationIdentity"
    """<p>The origination identity of the message. This can be either the PhoneNumber, PhoneNumberId, PhoneNumberArn, SenderId, SenderIdArn, 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.text_message_body.TextMessageBody"
    ]
    """<p>The text body of the message.</p>"""
    media_urls: NotRequired[
        "capo_pinpoint_sms_voice_v2.types.media_url_list.MediaUrlList"
    ]
    """<p>An array of URLs to each media file to send. </p> <p>The media files have to be stored in an S3 bucket. Supported media file formats are listed in <a href="https://docs.aws.amazon.com/sms-voice/latest/userguide/mms-limitations-character.html">MMS file types, size and character limits</a>. For more information on creating an S3 bucket and managing objects, see <a href="https://docs.aws.amazon.com/AmazonS3/latest/userguide/create-bucket-overview.html">Creating a bucket</a>, <a href="https://docs.aws.amazon.com/AmazonS3/latest/userguide/upload-objects.html">Uploading objects</a> in the <i>Amazon S3 User Guide</i>, and <a href="https://docs.aws.amazon.com/sms-voice/latest/userguide/send-mms-message.html#send-mms-message-bucket">Setting up an Amazon S3 bucket for MMS files</a> in the <i>Amazon Web Services End User Messaging SMS User Guide</i>.</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: NotRequired["capo_pinpoint_sms_voice_v2.types.max_price.MaxPrice"]
    """<p>The maximum amount that you want to spend, in US dollars, per each MMS message.</p>"""
    time_to_live: NotRequired[
        "capo_pinpoint_sms_voice_v2.types.time_to_live.TimeToLive"
    ]
    """<p>How long the media 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 of the protect configuration to use.</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 instance-attribute

max_price: NotRequired[MaxPrice]

The maximum amount that you want to spend, in US dollars, per each MMS message.

media_urls instance-attribute

media_urls: NotRequired[MediaUrlList]

An array of URLs to each media file to send.

The media files have to be stored in an S3 bucket. Supported media file formats are listed in MMS file types, size and character limits. For more information on creating an S3 bucket and managing objects, see Creating a bucket, Uploading objects in the Amazon S3 User Guide, and Setting up an Amazon S3 bucket for MMS files in the Amazon Web Services End User Messaging SMS User Guide.

message_body instance-attribute

message_body: NotRequired[TextMessageBody]

The text body of the message.

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: MediaMessageOriginationIdentity

The origination identity of the message. This can be either the PhoneNumber, PhoneNumberId, PhoneNumberArn, SenderId, SenderIdArn, 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 of the protect configuration to use.

time_to_live instance-attribute

time_to_live: NotRequired[TimeToLive]

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