> ## Documentation Index
> Fetch the complete documentation index at: https://help.chateea.com/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# Notas de voz y archivos adjuntos en el chat en vivo

> Permite que los visitantes envíen archivos, imágenes, PDF y notas de voz desde el widget de chat en vivo.

En el widget de chat en vivo, los visitantes pueden enviarte archivos, imágenes, PDF, audios y notas de voz, incluso sin escribir texto. Así te explican su caso con una captura de pantalla o un audio en lugar de un mensaje largo. Todo llega a **Conversaciones**, donde tu equipo puede verlo, escucharlo, descargarlo y responder, y la IA conversacional puede contestar imágenes y notas de voz si lo activas.

## Para qué te sirve

* **Comunicación más rápida:** el visitante sube un archivo o graba un audio en lugar de escribir.
* **Más contexto para tu equipo:** capturas, PDF, imágenes y audios ayudan a entender el problema antes de responder.
* **Mensajes solo con adjuntos:** no hace falta escribir texto para enviar un archivo o un audio.
* **Vista previa del audio:** el visitante escucha su nota de voz antes de enviarla.
* **Reproductor integrado:** los audios se muestran como tarjetas reproducibles, no como enlaces.
* **IA más útil:** la IA conversacional puede procesar imágenes y notas de voz compatibles.
* **Control de la interfaz:** decides si se muestran los íconos de adjuntar y de micrófono.

## Formatos y límites

### Qué puede hacer el visitante

* Grabar y enviar notas de voz desde el widget.
* Subir archivos de audio.
* Subir imágenes y documentos compatibles.
* Enviar archivos, audios o notas de voz sin texto.
* Escuchar el audio antes de enviarlo.
* Ver el progreso de la subida.

### Imágenes y documentos compatibles

| Formato | Cómo se muestra |
| - | - |
| `.jpg` y `.jpeg` | Vista previa en línea |
| `.png` | Vista previa en línea |
| `.heic` | Puede mostrarse como archivo descargable |
| `.pdf` | Puede mostrarse como archivo descargable |

### Audio

Las notas de voz y los audios se muestran como tarjetas reproducibles en el widget y en Conversaciones, con:

* Reproducir y pausar
* Forma de onda
* Controles para avanzar o retroceder
* Silenciar y reactivar
* Velocidad de 1×, 1,5× y 2×
* Reiniciar el audio

Para las respuestas de la IA conversacional a audios se admiten formatos como OGG, MP3, MP4 (solo audio), AAC, M4A y MPEG.

### Límites de archivos

* Hasta **5 archivos** por mensaje.
* Hasta **25 MB** por archivo.
* Los formatos no compatibles, los archivos demasiado grandes y los duplicados pueden bloquearse automáticamente.

## Cómo activarlo

**1. Abre el widget**

Ve a **Sitios → Widget de chat** y crea o abre un widget de **Chat en vivo**.

**2. Revisa las opciones adicionales**

En **Ventana de chat → Opciones adicionales**:

* Activa **Permitir enviar notas de voz** si quieres que los visitantes graben audios.
* Activa **Permitir enviar archivos adjuntos** si quieres que suban archivos.

Las dos opciones son independientes: puedes activar una, la otra o ambas.

**3. Guarda**

Haz clic en **Guardar**.

**4. Instala el widget**

Si tu sitio o embudo está hecho en Chateea, selecciona el widget en su configuración. Si es externo, pega el código de **Obtener código** en tu sitio.

**5. Prueba como visitante**

Abre tu sitio y envía un archivo, un mensaje solo con adjunto y una nota de voz. Confirma que cada uno llega bien a **Conversaciones**.

## Cómo lo usa el visitante

### Subir archivos

1. Abre el widget de chat en vivo en tu sitio.
2. Hace clic en el ícono de adjuntar o arrastra los archivos al cuadro de mensaje (en computadora).
3. Selecciona uno o varios archivos.
4. Espera a que termine la barra de progreso.
5. Envía el mensaje, con o sin texto.

### Grabar una nota de voz

1. Abre el widget y hace clic o toca el ícono de micrófono.
2. Permite el acceso al micrófono cuando el navegador lo pida.
3. Graba la nota de voz.
4. La escucha antes de enviarla.
5. La envía.

Si el visitante niega el permiso del micrófono, el widget le muestra un aviso con indicaciones para solucionarlo.

## Revisar adjuntos y notas de voz en Conversaciones

Tu equipo ve todo en el hilo de la conversación:

* Los JPG y PNG pueden mostrar vista previa.
* Los HEIC y PDF pueden aparecer como archivos descargables.
* Los audios se muestran como tarjetas reproducibles.
* Se pueden ver, reproducir, descargar o responder según el tipo de archivo.
* Desde las opciones del mensaje, cuando está disponible, puedes guardar el archivo en la biblioteca de **Medios** o en la pestaña **Documentos** del contacto.

## Respuestas de la IA conversacional a imágenes y notas de voz

La IA conversacional puede usar el contenido visual o de audio del mensaje, y no solo el texto.

**1. Abre la lista de agentes**

Ve a **IA → IA conversacional → Lista de agentes**.

**2. Edita el bot**

Haz clic en los tres puntos junto al bot que quieres configurar y elige **Editar**.

**3. Activa las opciones**

En **Configuración del bot → Permitir también que este bot responda a**, activa **Imágenes**, **Notas de voz** o ambas.

**4. Guarda**

Guarda los cambios.

* **Imágenes:** la IA analiza las imágenes compatibles (JPG, JPEG y PNG) y responde con contexto. Los HEIC se pueden subir como adjuntos, pero la IA puede no interpretarlos.
* **Notas de voz:** la IA transcribe el audio, usa la transcripción para entender el mensaje y responde. Si la opción está desactivada, se muestra el mensaje alternativo que hayas configurado.

> [!NOTE]
>
> La IA conversacional no lee archivos PDF. Solo analiza imágenes compatibles y responde normalmente con texto, no con audio.

## Solución de problemas

* **El archivo es demasiado grande:** comprímelo o usa una versión más pequeña (máximo 25 MB).
* **Formato no compatible:** conviértelo a un formato admitido antes de subirlo.
* **Aviso de archivo duplicado:** quita el duplicado y adjunta otro archivo.
* **La subida es lenta:** espera a que termine la barra de progreso o prueba con una conexión más estable.
* **No funciona arrastrar y soltar:** arrastra el archivo desde el explorador de archivos o usa el ícono de adjuntar.
* **Permiso de micrófono denegado:** permite el acceso al micrófono en la configuración del navegador y vuelve a grabar.
* **La IA no responde a una imagen o nota de voz:** confirma que el bot tenga activadas las opciones Imágenes o Notas de voz.

## Preguntas frecuentes

> **¿El visitante puede enviar adjuntos sin escribir texto?**
>
> Sí. El widget de chat en vivo permite mensajes solo con adjuntos.

> **¿Puede grabar notas de voz dentro del widget?**
>
> Sí, si activaste **Permitir enviar notas de voz**. Puede grabar, escuchar y enviar el audio desde el widget.

> **¿Puedo desactivar los adjuntos y dejar solo las notas de voz?**
>
> Sí. Cada opción se controla por separado.

> **¿Se pueden enviar PDF?**
>
> Sí. Se admiten como adjuntos, aunque pueden mostrarse como archivos descargables en lugar de vista previa.

> **¿La IA conversacional puede leer los PDF?**
>
> No. Solo analiza imágenes compatibles.

> **¿La IA puede responder a notas de voz?**
>
> Sí, si activas la respuesta a notas de voz en el bot. Chateea transcribe el audio y el bot responde según la transcripción.

> **¿El bot responde con un audio?**
>
> No. Responde con mensajes normales del canal, por lo general texto.

> **¿Por qué los archivos HEIC no muestran vista previa?**
>
> Depende del navegador. Descarga el archivo y ábrelo en tu equipo si no se ve la vista previa.

## Artículos relacionados

> **[Chat en vivo en Conversaciones](https://help.chateea.com/docs/conversaciones/chat-en-vivo.md)**
>
> Atiende los chats desde la bandeja unificada.

> **[Tu bot de IA responde a imágenes](https://help.chateea.com/docs/ia/bot-responde-imagenes.md)**
>
> Configura las respuestas a imágenes.

> **[Respuesta a notas de voz](https://help.chateea.com/docs/ia/respuesta-a-notas-de-voz.md)**
>
> Cómo la IA procesa los audios.

> **[Instalar el widget de chat](https://help.chateea.com/docs/sitios/instalar-widget-de-chat.md)**
>
> Agrega el widget a tu sitio.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.