# Etiquetas SSML

> Pausas, velocidad y pronunciación en la voz de un voicebot

## Qué son las etiquetas SSML

Las **etiquetas SSML (Speech Synthesis Markup Language)** son marcas especiales que se agregan dentro de un texto para indicarle a un sistema de voz sintética **cómo debe pronunciarlo**.

No modifican lo que se dice, sino **la manera en que se dice**.
Permiten controlar aspectos como:

Pausas entre frases

Énfasis en palabras importantes

Velocidad y tono de la voz

Forma correcta de leer números, fechas, montos o teléfonos

En resumen, SSML sirve para que una voz artificial suene más natural, clara y profesional, especialmente en asistentes virtuales, IVR y voicebots.

## Cómo usar las etiquetas SSML en Audara

En cualquier tipo de nodo que contenta mensaje en el Voicebot en Audara es posible utilizar **etiquetas SSML (Speech Synthesis Markup Language)** para controlar la forma en que el motor de voz interpreta y reproduce el texto.

Las etiquetas SSML se muestran en **color morado** dentro del editor para diferenciarlas claramente del contenido normal del mensaje.
Las variables dinámicas del sistema (como `{{CALLERID}}`) se muestran en **color azul**como se puede ver en la imagen.

![](https://docs.audara.io/etiquetas-ssml/imagenes/Captura-de-pantalla-2025-06-27-a-las-8.06.08-p.m.png)

### Ejemplo de la imagen

En la captura se observa el siguiente mensaje:

```
`Tu teléfono 
<say-as interpret-as="digits">
{{CALLERID}}
</say-as>
no está registrado en nuestro sistema.`
```

**Qué hace esto?**

`{{CALLERID}}` → Variable dinámica que contiene el número del cliente.

`<say-as interpret-as="digits">` → Indica al motor de voz que debe leer cada número individualmente.

Sin SSML el sistema podría decir:

> tres mil uno millones…

Con SSML dirá:

> tres – cero – cero – uno – dos – tres – cuatro…

Lo cual es correcto para lectura de teléfonos.

## Etiqueta para pausas naturales

Sirve para que no suene robótico y atropellado.

### ➡️ Ejemplo de uso

```
`<speak>
Tu cita está confirmada.
<break time="500ms"/>
Te esperamos mañana.
</speak>`
```

**Se mide en ms y puede ser útil en:**

Dar ritmo natural

Separar frases importantes

Evitar que todo suene corrido

## Etiqueta para control de velocidad

Muy útil cuando lees términos legales o números largos.

### ➡️ Ejemplo de uso

```
`<prosody rate="slow">
Por favor, escuche con atención.
</prosody>`
```

**Puedes hacer que la voz hable:**

Más lento (para adultos mayores)

Más rápido (para mensajes informativos cortos)

## Etiqueta para pronunciación correcta

Funciona para decirle como debe leer algo en particular.

### ➡️ Ejemplo de uso

```
`<say-as interpret-as="date">
2026-03-05
</say-as>`
```

Evita que diga:

> “dos mil veintiséis guion cero tres guion cero cinco”

Y en su lugar diga:

> “cinco de marzo de dos mil veintiséis”

## Etiqueta para manejo de numeros y deletrear

Es la etiqueta mas usada de todas, perfecta para deletrear y decir números dígito por digito.

### ➡️ Ejemplo de uso deletrear

```
`<say-as interpret-as="characters">
CRM
</say-as>`
```

Para que diga:
**C – R – M**y no “crem”

### ➡️ Ejemplo de uso dígitos

```
`<say-as interpret-as="telephone">
3001234567
</say-as>`
```

Para que lo lea como teléfono dígito por dígito y no como número entero.
