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

# Claves y lectura de medios de la IA

> Registra las claves de los proveedores de IA y activa la lectura de audios, imágenes y PDF.

## Para qué sirve

En **Ajustes › Inteligencia artificial** registras la clave de cada proveedor de IA (**OpenAI**, **Groq**, **Gemini**, **Fish Audio**) y activas la **lectura de medios** del Copiloto: transcribir audios, describir imágenes y resumir los PDF que envía el cliente.

La clave sirve al Copiloto, a los Agentes y a la IA de Voicer. Se configura una vez por proveedor.

## Quién puede

**Dueño y Admin** pueden modificar. Los demás roles solo ven. Los elementos **Agentes** e **IA de Voicer** de esta área dependen de los módulos habilitados por la agencia: cuando faltan, la pantalla dice "Habla con tu agencia".

## Dónde hacer clic

**Ajustes › Inteligencia artificial**: **Copiloto**, **Agentes**, **IA de Voicer** y **Claves y proveedores**. **Copiloto · lectura de medios** se abre desde el enlace dentro de la página del Copiloto. Atajo: en los Agentes de IA, **las claves y proveedores están en Ajustes**. Las claves se guardan por WhatsApp; elige el WhatsApp en el selector.

## Paso a paso

**1. Abre Claves y proveedores**

Elige el WhatsApp en **Selecciona el WhatsApp**.

**2. Pega la clave**

En el proveedor, haz clic en **Añadir**, en **Pega la clave** y guarda. Aparece "Clave guardada". Una vez guardada, nunca se vuelve a mostrar completa.

**3. Activa la lectura de medios**

En **Copiloto · lectura de medios**, activa por tipo: **Audios (Transcripción)**, **Imágenes (Descripción)** y **PDFs (Resumen)**. Elige el **Proveedor de IA** de cada uno.

## Qué pasa después

Cuando está activado, el contenido recibido se procesa y el texto aparece junto al mensaje. Los Agentes usan las **Claves de la organización**, que valen para todas las bandejas y tienen prioridad sobre la clave de la bandeja. De una clave solo se muestran los últimos 4 caracteres.

## Errores comunes

* **No hay clave de API configurada para el proveedor.** Añádela en **Claves y proveedores**; sin la clave, el proveedor no aparece para elegirlo.
* **Esa clave no parece válida.** Revísala e inténtalo de nuevo.
* **Error al guardar la clave** / **No se pudo eliminar la clave.**
* **Quitar la clave** hace que el Copiloto y los Agentes de la bandeja se detengan hasta que añadas otra.
* **No se pudieron cargar las claves** o **la lectura de medios.** Usa **Intentar de nuevo**.
* **Falta la clave de búsqueda.** La base de conocimiento del agente necesita una clave de OpenAI o de Gemini.

## Siguiente paso

* [Agentes de IA](https://docs.stchat.app/es/subcontas/agentes-de-ia.md)
* [Flows: visión general](https://docs.stchat.app/es/subcontas/flows.md)


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