send_voice_message

send_voice_message(**kwargs)

Allows you to send a request that sends a text message through Amazon Pinpoint. This operation uses Amazon Polly to convert a text script into a voice message.

See also: AWS API Documentation

Request Syntax

response = client.send_voice_message(
    DestinationPhoneNumber='string',
    OriginationIdentity='string',
    MessageBody='string',
    MessageBodyTextType='TEXT'|'SSML',
    VoiceId='AMY'|'ASTRID'|'BIANCA'|'BRIAN'|'CAMILA'|'CARLA'|'CARMEN'|'CELINE'|'CHANTAL'|'CONCHITA'|'CRISTIANO'|'DORA'|'EMMA'|'ENRIQUE'|'EWA'|'FILIZ'|'GERAINT'|'GIORGIO'|'GWYNETH'|'HANS'|'INES'|'IVY'|'JACEK'|'JAN'|'JOANNA'|'JOEY'|'JUSTIN'|'KARL'|'KENDRA'|'KIMBERLY'|'LEA'|'LIV'|'LOTTE'|'LUCIA'|'LUPE'|'MADS'|'MAJA'|'MARLENE'|'MATHIEU'|'MATTHEW'|'MAXIM'|'MIA'|'MIGUEL'|'MIZUKI'|'NAJA'|'NICOLE'|'PENELOPE'|'RAVEENA'|'RICARDO'|'RUBEN'|'RUSSELL'|'SALLI'|'SEOYEON'|'TAKUMI'|'TATYANA'|'VICKI'|'VITORIA'|'ZEINA'|'ZHIYU',
    ConfigurationSetName='string',
    MaxPricePerMinute='string',
    TimeToLive=123,
    Context={
        'string': 'string'
    },
    DryRun=True|False
)

Parameters

• DestinationPhoneNumber (string) --

  [REQUIRED]

  The destination phone number in E.164 format.

• OriginationIdentity (string) --

  [REQUIRED]

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

• MessageBody (string) -- The text to convert to a voice message.
• MessageBodyTextType (string) --

  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.
• VoiceId (string) -- The voice for the Amazon Polly service to use. By default this is set to "MATTHEW".
• ConfigurationSetName (string) -- The name of the configuration set to use. This can be either the ConfigurationSetName or ConfigurationSetArn.
• MaxPricePerMinute (string) -- The maximum amount to spend per voice message, in US dollars.
• TimeToLive (integer) -- How long the voice message is valid for. By default this is 72 hours.
• Context (dict) --

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

  • (string) --
    • (string) --
• DryRun (boolean) -- When set to true, the message is checked and validated, but isn't sent to the end recipient.

Return type

dict

Returns

Response Syntax

{
    'MessageId': 'string'
}

Response Structure

• (dict) --

  • MessageId (string) --

    The unique identifier for the message.

Exceptions

• PinpointSMSVoiceV2.Client.exceptions.ServiceQuotaExceededException
• PinpointSMSVoiceV2.Client.exceptions.ThrottlingException
• PinpointSMSVoiceV2.Client.exceptions.AccessDeniedException
• PinpointSMSVoiceV2.Client.exceptions.ResourceNotFoundException
• PinpointSMSVoiceV2.Client.exceptions.ValidationException
• PinpointSMSVoiceV2.Client.exceptions.ConflictException
• PinpointSMSVoiceV2.Client.exceptions.InternalServerException