SSML e deteção de linguagem

ID do remetente para mensagens de voz

Para mensagens de voz (text2speech e text2speech_ssml), o campo sender_id controla o identificador de chamada exibido aos destinatários. Se especificar um valor sender_id que não está em conformidade com o formato de número de telefone E.164 (por exemplo, sem o prefixo +, contendo caracteres não numéricos), a mensagem será enviada a partir do número padrão do sistema +493075435114.

⚠️ Alguns provedores de telefonia downstream podem substituir ou não respeitar o número de remetente definido pelo usuário, independentemente de passar na verificação E.164. O identificador de chamada real apresentado ao destinatário depende das capacidades do provedor.

Voice language detection

Quando voice_lang é nulo, o sistema detecta automaticamente o idioma da voz a partir do conteúdo da mensagem utilizando a biblioteca patrickschur/language-detection.

Línguas suportadas: inglês (EN), alemão (DE), francês (FR), italiano (IT), espanhol (ES), polaco (PL), holandês (NL), romeno (RO), português (PT), checo (CS), húngaro (HU), sueco (SV), dinamarquês (DA), finlandês (FI), eslovaco (SK), croata (HR), turco (TR), russo (RU), búlgaro (BG), ucraniano (Reino Unido).

SSML Support

The API now supports a subset of SSML (Speech Synthesis Markup Language) for advanced voice message formatting.

Supported Features

Available Tags

• <break> - Insert pauses in speech
• <say-as> - Control pronunciation of text

Tag Specifications

<break> Tag

• Purpose: Add pauses between words or sentences
• Attributes: time (e.g., “1s”, “500ms”)
• Preços: <0,5ms = 1 char, <1s = 2 chars, <1,5s = 3 chars, etc.

<say-as> Tag

• Purpose: Control how text is interpreted and spoken
• Supported Attributes:
  • interpret-as="characters" - Spell out text character by character
• Note: Currently only “characters” value is supported

Usage

Wrap your message content with the <speak> root element:

<speak>
  Your verification code is <say-as interpret-as="characters">A1B2C3</say-as>.
  <break time="1s"/>
  Please enter it now.
</speak>