# Ajustes y credenciales de proveedor # Ajustes y credenciales de proveedor **Ajustes** es donde traes tus propios proveedores de IA e integración al Portal. Los agentes no vienen con claves de modelo cableadas — las pestañas LLM y Audio solo ofrecen un proveedor una vez que tu organización tiene una credencial para él aquí. Esta página también es donde gestionas las preferencias de cuenta, las notificaciones, la seguridad y la apariencia. Abre **Ajustes** (`/settings`). ## Qué hay en la página de Ajustes La página es un conjunto de pestañas. Las primeras cuatro están disponibles para todos; el resto aparece según tu rol: - **General** — el **idioma** de la interfaz y la **zona horaria**. - **Notificaciones** — preferencias de notificaciones por email, push y de marketing. Los administradores también obtienen un panel para enviar notificaciones push. - **Seguridad** — cambia tu contraseña y activa la autenticación de dos factores. - **Apariencia** — **tema** claro/oscuro, **familia tipográfica**, **densidad** del diseño y un selector de **tema de color**. - **Credenciales de API** — credenciales de proveedor para servicios de IA e integraciones (administradores de organización). - **Entrega de email** — proveedores de envío de email (administradores de organización), gestionados en su propia pestaña en lugar de bajo Credenciales de API. El resto de esta página se centra en **Credenciales de API**, que es de lo que se nutre el constructor de agentes. ## Credenciales de API La pestaña **Credenciales de API** es donde registras los proveedores que un agente puede usar. Las credenciales se agrupan en dos filas: - **Servicios de IA** — **LLM** (modelo de lenguaje), **STT** (voz a texto) y **TTS** (texto a voz). - **Integraciones de funciones** — **SMS**, **CRM**, **Calendario**, **Tickets**, **Pagos** e **Identidad**. Estas alimentan las [funciones integradas](./agents/tools-mcp) del agente (por ejemplo, enviar un SMS o crear un contacto en el CRM). Cada pestaña muestra un recuento de cuántas credenciales has configurado para ese tipo. Selecciona un tipo y luego **Añadir credencial** para registrar una. :::info[Las credenciales de IA son a nivel de sistema; las credenciales de integración son por organización] Las credenciales de LLM, STT y TTS son **a nivel de sistema**, compartidas entre todas las organizaciones y gestionadas por el equipo de imatic — no hay un selector de organización para ellas. Los tipos de integración (SMS, CRM, calendario, etc.) están **acotados a una organización**: elige la organización en la parte superior de la pestaña, y las credenciales que añadas se aplican a ella. ::: ### Añadir una credencial **Añadir credencial** abre un formulario: 1. **Nombre** — una etiqueta descriptiva, p. ej. *"Azure GPT-4o (India)"* o *"Deepgram Nova-3"*. Nombrar con el modelo y la región hace que una lista de credenciales sea fácil de escanear. 2. **Tipo de proveedor** — LLM, STT, TTS o un tipo de integración. 3. **Proveedor** — el proveedor específico para ese tipo (consulta las listas más abajo). 4. **Campos del proveedor** — el formulario muestra entonces exactamente los campos que ese proveedor necesita (clave de API, endpoint, región, despliegue, etc.). Los campos secretos se enmascaran con un conmutador para mostrar/ocultar. 5. **Establecer como predeterminada** — opcionalmente marca esta credencial como la predeterminada para ese proveedor, usada cuando no se elige nada más específico. Las credenciales se almacenan cifradas. El tipo de proveedor y el proveedor no se pueden cambiar después de crear una credencial — añade una nueva en su lugar. ### Proveedores de IA que puedes añadir - **LLM** — Azure OpenAI, Google Gemini, Groq, OpenRouter y Sarvam AI (lenguas índicas). - **STT** — Deepgram, Azure Speech, Groq (Whisper) y Sarvam Saarika (índicas). - **TTS** — ElevenLabs, Azure Speech, Groq (Orpheus), Cartesia, Google Gemini TTS y Sarvam Bulbul (índicas). Los campos dependen del proveedor. Los proveedores de clave única (Deepgram, ElevenLabs, Groq y similares) solo necesitan una **clave de API**. **Azure OpenAI** necesita una **API Key**, una **Endpoint URL**, un **Deployment Name** y una **API Version** — de modo que cada credencial de Azure representa un despliegue. **Azure Speech** necesita una **Speech Key** y una **Region**. :::tip Añade **una credencial de Azure OpenAI por despliegue**. En la [pestaña LLM](./agents/llm) del agente, la lista de modelos de Azure se construye a partir de tus despliegues configurados — una credencial, un modelo seleccionable — así que crea una credencial para cada despliegue entre los que quieras que elijan los agentes. ::: ### Proveedores de integración que puedes añadir Estos suministran las claves que usan las funciones integradas del agente para actuar sobre el mundo exterior: - **SMS** — Twilio, Exotel, Meta WhatsApp Business. - **CRM** — HubSpot, Salesforce, Zoho CRM. - **Calendario** — Google Calendar, Microsoft Outlook, Calendly. - **Tickets** — Zendesk, Freshdesk. - **Pagos** — Stripe, Razorpay. - **Identidad** — un proveedor personalizado. Para **Google Calendar** y **Outlook**, el formulario recopila el **Client ID** y el **Client Secret** de OAuth. Créalos en tu aplicación OAuth — la Google Cloud Console o el equivalente en el Registro de aplicaciones de Azure — y, ya que estás ahí, registra la URI de redirección de imatic en el cliente OAuth (la lista de **Authorised redirect URIs**) para que se pueda completar la conexión. ### Gestionar las credenciales existentes Cada credencial guardada aparece como una fila que muestra su nombre, estado, proveedor y una clave enmascarada. Desde la fila puedes: - **Habilitarla / deshabilitarla** con el conmutador (una credencial deshabilitada permanece guardada pero no se usa). - **Editar** sus detalles. - **Eliminarla**. Eliminar una credencial de CRM también desconecta la integración de CRM correspondiente. ## Cómo llegan las credenciales a tus agentes Una vez que una credencial está habilitada aquí, pasa a ser seleccionable en el constructor de agentes: - En la [pestaña LLM](./agents/llm), la lista de **proveedores** muestra solo los proveedores para los que tu organización tiene credenciales habilitadas — y para Azure, las opciones de modelo provienen de tus despliegues. - En la [pestaña Voz y audio](./agents/voice-audio), las listas de proveedores de STT y TTS funcionan de la misma manera. - Las credenciales de Integración de funciones alimentan las [herramientas y funciones integradas](./agents/tools-mcp) del agente y las [integraciones de CRM](./integrations-crm). Si un proveedor que esperas no aparece en esas pestañas, la razón más común es que no existe aquí ninguna credencial habilitada para él. ## Próximos pasos - [Establece el modelo de lenguaje](./agents/llm) una vez que tus credenciales de LLM estén en su lugar. - [Configura la voz y el audio](./agents/voice-audio) usando tus credenciales de STT y TTS. - [Conecta un CRM](./integrations-crm) y configura las [herramientas y funciones](./agents/tools-mcp). - [Conecta un agente a los canales de mensajería](./channels).