SSML y detección de idiomas

ID del remitente para mensajes de voz

Para mensajes de voz (text2speech y text2speech_ssml), el campo sender_id controla el identificador de llamada mostrado a los destinatarios. Si especifica un valor sender_id que no cumple con el formato de número telefónico E.164 (por ejemplo, sin el prefijo +, con caracteres no numéricos), el mensaje se enviará desde el número predeterminado del sistema +493075435114.

⚠️ Algunos proveedores de telefonía posteriores pueden anular o no respetar el número de remitente definido por el usuario, independientemente de si pasa la verificación E.164. El identificador de llamada real presentado al destinatario depende de las capacidades del proveedor.

Detección del idioma de la voz

Cuando voice_lang es nulo, el sistema detecta automáticamente el idioma de la voz a partir del contenido del mensaje mediante la biblioteca patrickschur/language-detection.

Idiomas compatibles: inglés (EN), alemán (DE), francés (FR), italiano (IT), español (ES), polaco (PL), neerlandés (NL), rumano (RO), portugués (PT), checo (CS), húngaro (HU), sueco (SV), danés (DA), finlandés (FI), eslovaco (SK), croata (HR), turco (TR), ruso (RU), búlgaro (BG), ucraniano (UK).

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”)
• Precios: <0,5ms = 1 carácter, <1s = 2 caracteres, <1,5s = 3 caracteres, 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>