> ## Documentation Index
> Fetch the complete documentation index at: https://revolai.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# Personalización del Widget

> Personalice la apariencia, el comportamiento y la configuración de voz de su widget de chat

La pestaña Widget en el panel del agente le permite personalizar completamente cómo se ve y se comporta el widget de chat en su sitio web. Todos los cambios se previsualizan en tiempo real.

<Frame>
  <img className="block dark:hidden" src="https://mintcdn.com/revolai/hPYT2e9rGA-thsqQ/images/widget-s-light.png?fit=max&auto=format&n=hPYT2e9rGA-thsqQ&q=85&s=03a624a2bbece40db3323f0eeaf0b45f" alt="Configuración del widget" width="2867" height="1552" data-path="images/widget-s-light.png" />

  <img className="hidden dark:block" src="https://mintcdn.com/revolai/hPYT2e9rGA-thsqQ/images/widget-s-dark.png?fit=max&auto=format&n=hPYT2e9rGA-thsqQ&q=85&s=8be8fd4eff6880de31cf9727252cbe8e" alt="Configuración del widget" width="2872" height="1552" data-path="images/widget-s-dark.png" />
</Frame>

## Botón Renderizar

El botón **Renderizar** en el área de vista previa del widget recarga la vista previa en vivo de su widget con la configuración actual. Úselo para ver cómo lucen sus cambios antes de guardar.

## Apariencia

La pestaña Apariencia controla el diseño visual del widget.

### Colores

| Configuración       | Descripción                                                               |
| ------------------- | ------------------------------------------------------------------------- |
| **Primario**        | Color principal del botón y color de acento del widget                    |
| **Chat**            | Color del botón de acción del chat                                        |
| **Mensaje**         | Color de fondo de las burbujas de mensaje del agente                      |
| **Animación**       | Color de los efectos de pulso y resplandor alrededor del botón del widget |
| **Valoración**      | Color de los iconos de estrellas de valoración después de la conversación |
| **Texto de Estado** | Color del texto de estado en el botón del widget                          |

Haga clic en cualquier muestra de color para abrir el selector de color con un selector de saturación/tono y entrada hexadecimal.

### Etiquetas de Texto

| Configuración                       | Valor por Defecto  | Descripción                                          |
| ----------------------------------- | ------------------ | ---------------------------------------------------- |
| **Título Principal**                | "¿Necesita ayuda?" | Título mostrado en el botón del widget               |
| **Botón de Llamada**                | "Llamada web"      | Etiqueta en el botón de llamada de voz               |
| **Botón de Chat**                   | "Chat"             | Etiqueta en el botón de chat                         |
| **Marcador de Posición de Entrada** | "Ingrese el texto" | Texto de marcador en el campo de entrada de mensajes |

### Posición

| Opción                 | Descripción                                                       |
| ---------------------- | ----------------------------------------------------------------- |
| **Inferior Derecha**   | Predeterminado — el widget aparece en la esquina inferior derecha |
| **Inferior Centro**    | Centrado en la parte inferior de la página                        |
| **Inferior Izquierda** | Esquina inferior izquierda                                        |
| **Superior Derecha**   | Esquina superior derecha                                          |
| **Superior Centro**    | Centrado en la parte superior                                     |
| **Superior Izquierda** | Esquina superior izquierda                                        |

### Tamaño y Estilo

| Configuración          | Opciones                   | Descripción                                              |
| ---------------------- | -------------------------- | -------------------------------------------------------- |
| **Tema del Widget**    | Claro / Oscuro             | Tema de color de la ventana de chat                      |
| **Tamaño del Widget**  | Pequeño / Mediano / Grande | Tamaño general del widget                                |
| **Radio de Borde**     | 0–50px (deslizador)        | Redondez de las esquinas del widget                      |
| **Opacidad del Fondo** | 0–100% (deslizador)        | Transparencia del fondo del widget                       |
| **URL del Avatar**     | URL                        | Imagen de avatar personalizada para el agente en el chat |

## Comportamiento

La pestaña Comportamiento controla cómo funciona el widget.

### Idioma

| Configuración         | Opciones                                      | Descripción                                                                      |
| --------------------- | --------------------------------------------- | -------------------------------------------------------------------------------- |
| **Idioma del Widget** | English, Українська, Polski, Deutsch, Español | Idioma de la interfaz para todas las etiquetas y mensajes del sistema del widget |

### Funcionalidades

| Configuración                   | Valor por Defecto | Descripción                                                                               |
| ------------------------------- | ----------------- | ----------------------------------------------------------------------------------------- |
| **Recopilación de Comentarios** | Activado          | Mostrar una solicitud de valoración con estrellas después de que finalice la conversación |
| **Texto Durante Llamada**       | Activado          | Permitir al usuario escribir mensajes de texto mientras una llamada de voz está activa    |
| **Modo Solo Chat**              | Desactivado       | Desactivar las llamadas de voz por completo — solo está disponible el chat de texto       |
| **Términos y Condiciones**      | Desactivado       | Requerir que el usuario acepte los términos antes de iniciar un chat                      |
| **Efectos de Sonido**           | Activado          | Reproducir sonidos de notificación para nuevos mensajes                                   |

### Automatización

| Configuración                      | Valor por Defecto      | Descripción                                                                                              |
| ---------------------------------- | ---------------------- | -------------------------------------------------------------------------------------------------------- |
| **Apertura Automática**            | Desactivado            | Abrir automáticamente el widget después de un retraso                                                    |
| **Retraso de Apertura Automática** | 5s (deslizador, 0–60s) | Cuánto tiempo esperar antes de la apertura automática (solo cuando la Apertura Automática está activada) |
| **Saludo Automático**              | Desactivado            | Enviar automáticamente un mensaje de saludo cuando se abre el widget                                     |

### Visibilidad

| Configuración             | Valor por Defecto | Descripción                                                         |
| ------------------------- | ----------------- | ------------------------------------------------------------------- |
| **Widget Habilitado**     | Activado          | Interruptor principal — mostrar u ocultar el widget en su sitio web |
| **Mostrar en Móvil**      | Activado          | Mostrar el widget en dispositivos móviles                           |
| **Mostrar en Escritorio** | Activado          | Mostrar el widget en dispositivos de escritorio                     |

### Marca

| Configuración             | Valor por Defecto | Descripción                                                                               |
| ------------------------- | ----------------- | ----------------------------------------------------------------------------------------- |
| **Insignia Powered By**   | Activado          | Mostrar la marca "Powered by Revol" en la parte inferior del widget                       |
| **Mensaje de Bienvenida** | —                 | Un mensaje de saludo mostrado cuando se abre el chat (antes de que el usuario envíe algo) |

### Detalles de Términos

Cuando **Términos y Condiciones** está activado, aparecen estos campos adicionales:

| Configuración             | Descripción                                                                                            |
| ------------------------- | ------------------------------------------------------------------------------------------------------ |
| **Texto de los Términos** | El texto mostrado al usuario (por ejemplo, "Al continuar, usted acepta nuestros Términos de Servicio") |
| **URL de los Términos**   | Enlace a su página completa de términos                                                                |

## Voz

La pestaña Voz configura el reconocimiento de voz y la síntesis de voz para las llamadas.

### Reconocimiento de Voz (STT)

| Configuración | Opciones            | Descripción                                 |
| ------------- | ------------------- | ------------------------------------------- |
| **Idioma**    | Українська, English | Idioma para la transcripción de voz a texto |

### Mensaje de Saludo

El texto que el agente pronuncia al contestar una llamada de voz. Puede **Previsualizar** el audio antes de guardar y **Guardar** para aplicarlo.

### Mensaje de Despedida

El texto pronunciado cuando finaliza la llamada. También tiene botones de **Previsualizar** y **Guardar**.

### Salida de Voz (TTS)

| Configuración | Opciones                                | Descripción                                                               |
| ------------- | --------------------------------------- | ------------------------------------------------------------------------- |
| **Proveedor** | OpenAI TTS                              | Proveedor de síntesis de voz (ElevenLabs y Google Cloud TTS próximamente) |
| **Voz**       | Alloy, Echo, Fable, Onyx, Nova, Shimmer | Carácter de voz para el agente                                            |
| **Modelo**    | tts-1, tts-1-hd                         | Calidad de audio — estándar o HD                                          |
| **Velocidad** | 0.5x – 2.0x (deslizador)                | Velocidad del habla                                                       |

**Descripciones de las voces:**

| Voz         | Carácter                    |
| ----------- | --------------------------- |
| **Alloy**   | Neutral, equilibrada        |
| **Echo**    | Cálida, conversacional      |
| **Fable**   | Expresiva, acento británico |
| **Onyx**    | Profunda, autoritaria       |
| **Nova**    | Amigable, optimista         |
| **Shimmer** | Clara, suave                |

### Probar Voz

Ingrese cualquier texto y haga clic en **Reproducir Prueba** para escuchar cómo suena la voz seleccionada con la configuración actual.

## Guardar y Restablecer

* **Guardar** — aplicar todos los cambios al widget
* **Restablecer** — revertir todas las configuraciones a su último estado guardado
