# Integraciones > Visualizar y gestionar las conexiones con servicios externos ## Vista general del módulo El módulo de Integraciones es el punto donde conectas Audara con los servicios externos que usa tu operación: los proveedores de inteligencia artificial, tu servidor de correo, tu proveedor de SMS y tu CRM. Lo encuentras en **Configuración > Integraciones**. ![Tablero de integraciones](https://docs.audara.io/integraciones/imagenes/integraciones-tablero.jpg) *Tablero de integraciones* La primera pantalla es un tablero de tarjetas, una por cada tipo de integración disponible. Cada tarjeta muestra el nombre del servicio, una descripción corta y una etiqueta de estado que te dice cuántas integraciones de ese tipo tienes creadas: - **Sin configurar**: Todavía no has creado ninguna integración de ese tipo. La etiqueta se ve en gris. - **1 configurado / N configurados**: Ya tienes integraciones creadas de ese tipo. La etiqueta se ve en verde y el número es el total, cuenta tanto las activas como las inactivas. Al presionar una tarjeta entras a la lista de ese tipo de integración. Desde ahí creas, editas y desactivas cada conexión. > **Nota** > Las tarjetas que ves dependen de tu plan y de tu instalación, así que pueden variar entre clientes. Si una tarjeta no te aparece y la necesitas, escríbele al soporte de Audara. ## Permisos Cada tipo de integración tiene su propio permiso, independiente de los demás. Un usuario puede tener acceso a la integración de correo y no a la de OpenAI. - **Sin permiso de lectura**: La tarjeta sigue apareciendo en el tablero, pero al presionarla sale un aviso de que no tienes acceso y no entras a la lista. - **Con lectura, sin escritura**: Ves la lista y puedes abrir cada integración para consultarla, pero el botón **Guardar** queda inactivo y el menú de más opciones (⋮) solo te deja editar, sin eliminar ni desactivar. - **Con escritura**: Puedes crear, editar, eliminar, activar y desactivar integraciones de ese tipo. Los permisos se asignan por rol en el módulo **[Usuarios](https://docs.audara.io/usuarios-en-audara/)**. ## Cómo se crea una integración Todos los tipos de integración se manejan igual, así que el recorrido es el mismo sin importar cuál elijas: 1. Presiona la tarjeta del servicio en el tablero. Entras a la lista de integraciones de ese tipo. 2. Presiona el botón (+) del encabezado. Se abre el formulario de una integración nueva. 3. Completa los campos. Los obligatorios están marcados con un asterisco (*). 4. Presiona **Guardar**. La integración aparece en la lista y queda activa. ![Lista de integraciones, con el menú de más opciones abierto](https://docs.audara.io/integraciones/imagenes/integraciones-lista.jpg) *Lista de integraciones, con el menú de más opciones abierto* - **1.** Vuelve al tablero de integraciones con la flecha del encabezado. - **2.** Crea una integración nueva con el botón (+). - **3.** Busca por nombre. - **4.** Abre el menú de más opciones (⋮) para editar, eliminar o desactivar. Todas las listas tienen la misma estructura: una columna de **Nombre**, una o dos columnas propias del tipo de integración, y una columna de **Estado** con el menú de más opciones. > **Importante** > Desactivar una integración no la borra, pero sí la saca de circulación: los módulos que la usan dejan de encontrarla. Antes de desactivar una integración de correo o de SMS, revisa que ninguna campaña ni ningún flujo de bot dependa de ella. El nombre de cada integración tiene que ser único dentro de su tipo. Si repites un nombre, el formulario te avisa con "Ya existe una integración con ese nombre" y no guarda. ## OpenAI La integración de OpenAI es la que le da a Audara acceso a los modelos de OpenAI. Es la que alimenta los agentes de IA, las funciones inteligentes, las transcripciones de audio y los análisis de conversaciones. La lista muestra el **Nombre** de cada integración, cuántos **Asistentes** tiene configurados y su **Estado**. ### Ajustes ![Ajustes de una integración de OpenAI](https://docs.audara.io/integraciones/imagenes/integraciones-openai-ajustes.jpg) *Ajustes de una integración de OpenAI* - **Nombre***: Nombre con el que se identifica la integración en Audara. Es el que vas a ver en los selectores de los demás módulos, así que ponle uno que distingas. - **API Key***: La clave de tu cuenta de OpenAI. La generas en el panel de OpenAI. No la compartas ni la publiques: OpenAI desactiva automáticamente cualquier clave que detecte filtrada. - **Modelo***: El modelo de OpenAI que se usa por defecto en las consultas. La lista de modelos disponibles viene del catálogo de tu licencia, no la escribes a mano. - **Modelo transcripción***: El modelo de OpenAI que convierte audio a texto. Lo usan las campañas y los marcadores que tengan su modelo de transcripción en **Por defecto**; uno que nombre su propio modelo ignora este campo. > **Nota** > Solo el modelo **Whisper-1** genera diarización cronológica, o sea la transcripción separada por interlocutor y en orden. Los demás modelos devuelven bloques de texto sin cronología, que sirven igual para análisis pero no para leer la conversación turno por turno. ### Asistentes Debajo de los ajustes puedes agregar asistentes con el botón (+). Un asistente es un prompt que creaste y configuraste directamente en el panel de OpenAI, y que aquí solo registras para poder usarlo desde Audara. - **Nombre**: Nombre con el que vas a escoger este asistente desde los demás módulos. - **Descripción**: Para qué sirve el asistente. Es solo para que te ubiques en la lista. - **ID***: El identificador del prompt en OpenAI. Empieza por `pmpt_` y lo copias del panel de OpenAI. - **Límite de caracteres por consulta**: Corta la consulta que se le manda al asistente si se pasa de ese largo. - **Límite de palabras por respuesta**: Le pide al asistente que no se extienda más de ese número de palabras. > **Importante** > Los identificadores del API viejo de asistentes, los que empiezan por `asst_`, siguen funcionando pero OpenAI los apaga el 26 de agosto de 2026. Si tienes alguno, vuelve a crear ese asistente como Prompt en el panel de OpenAI y reemplaza el ID por el nuevo. Audara te marca en el formulario los que están en el formato viejo. ### Consumo La pestaña **Consumo** solo aparece cuando estás editando una integración que ya existe, porque antes de guardarla no hay nada que reportar. Ahí ves lo que ha gastado esa integración en el mes que escojas. ![Consumo del mes, por función y por modelo](https://docs.audara.io/integraciones/imagenes/integraciones-openai-consumo.jpg) *Consumo del mes, por función y por modelo* Arriba van los totales del mes: los **tokens totales**, los **de entrada**, los **de salida** y los **minutos de audio** que se transcribieron. Debajo, el mismo consumo desglosado de dos maneras: - **Por función**: Cuánto consumió cada parte de Audara: Chatbot, Voicebot, Automatización, Copiloto, Función inteligente, Speech Analytics, Text Analytics, Transcripciones, OmniScan y el Asistente de prompts. - **Por modelo**: Cuánto consumió cada modelo de OpenAI. De cada fila ves los **Llamados**, los **Tokens** y los **minutos de audio**. Si la integración todavía no ha gastado nada, la pestaña te lo dice en vez de mostrarte una tabla vacía. ## Gemini La integración con Gemini, la inteligencia artificial de Google. Es la más corta de todas: se configura con cuatro campos. ![Ajustes de una integración de Gemini](https://docs.audara.io/integraciones/imagenes/integraciones-gemini-ajustes.jpg) *Ajustes de una integración de Gemini* - **Nombre***: Nombre con el que se identifica la integración en Audara. - **API Key***: La clave de tu cuenta de Google. La generas en la consola de Google. - **Modelo***: El modelo de Gemini que responde el análisis. Lo usan las campañas que tengan su modelo de análisis en **Por defecto**. - **Modelo transcripción***: El modelo de Gemini que transcribe. Lo usan las campañas que tengan su modelo de transcripción en **Por defecto**. Gemini transcribe separando los interlocutores de la grabación mezclada, así que aquí solo salen los modelos que saben hacer eso. La lista muestra el **Nombre** y el **Estado** de cada integración. > **Nota** > Los dos modelos de aquí son el valor por defecto, no una orden: una campaña que nombre su propio modelo ignora este campo. Y el **Modelo** lo comparten el análisis de llamadas y el análisis de texto de los chats, así que si necesitas uno distinto para cada cosa, crea una segunda integración con la misma llave. ## Correo Electrónico La integración de correo es la que le permite a Audara enviar correos: notificaciones, campañas, reportes programados y los correos que mandan los flujos de los bots. La lista muestra el **Nombre**, el **Email**, las **Plantillas** y el **Estado**. ### Tipo de integración Lo primero que escoges es el tipo, y de eso depende el resto del formulario: - **SMTP**: Audara se conecta a tu servidor de correo con las credenciales que le des. Es el caso normal: usas tu propio dominio y tu propio servidor. - **Buzón Saliente**: Audara administra el buzón por ti sobre un dominio que ya está registrado y verificado. Tú solo escoges el dominio y el nombre del buzón. > **Importante** > El tipo de integración no se puede cambiar después de guardar: el selector queda bloqueado al editar. Si te equivocaste, crea una integración nueva con el tipo correcto. ### Campos de una integración SMTP ![Ajustes de una integración de correo, autenticando con OAuth2](https://docs.audara.io/integraciones/imagenes/integraciones-correo-ajustes.jpg) *Ajustes de una integración de correo, autenticando con OAuth2* - **Nombre***: Nombre con el que se identifica la integración en Audara. Mínimo tres caracteres. - **Servidor de Correo***: La dirección del servidor SMTP de tu proveedor, por ejemplo `smtp.miempresa.com`. - **Puerto***: El puerto por el que se conecta al servidor. Tu proveedor de correo te dice cuál usar. - **Método de autenticación***: Cómo se identifica Audara ante el servidor. La mayoría de servidores usan **Usuario y contraseña**. Escoge **OAuth2 (Google)** solo si tu proveedor te entregó un ID de cliente, una clave y un token de actualización. - **Usuario***: La dirección de correo de la cuenta. Tiene que ser un correo válido. - **Contraseña***: La contraseña de esa cuenta de correo. Solo aparece si escogiste usuario y contraseña. - **ID de cliente*, Clave de Cliente*, Token de actualización***: Las tres credenciales de OAuth2. Solo aparecen si escogiste ese método, y te las entrega tu proveedor. - **De**: El nombre y la dirección que ve quien recibe el correo, con el formato `Nombre `. - **Aceptar certificado sin verificar**: Actívalo solo si el servidor usa un certificado propio o a nombre de otro dominio y la conexión falla por eso. La conexión sigue cifrada, pero deja de comprobarse la identidad del servidor. Solo aparece autenticando con usuario y contraseña. ### Probar la conexión El botón **Probar conexión** se habilita cuando ya llenaste lo mínimo para intentar conectarse, y te dice en el momento si el servidor acepta las credenciales. Cuando falla, el mensaje te dice qué falló: - **El servidor rechazó el usuario o la contraseña**: Las credenciales están mal. Revísalas con tu proveedor. - **El servidor aceptó la conexión, pero no permite iniciar sesión con usuario y contraseña en esta cuenta**: Las credenciales están bien, pero la cuenta tiene la autenticación por contraseña deshabilitada. Lo tiene que habilitar el administrador de correo de tu empresa. - **No se encontró el servidor con ese nombre**: La dirección del servidor está mal escrita, o es un servidor interno que solo responde dentro de la red de la empresa. - **No se pudo conectar al servidor**: El servidor no respondió. Revisa la dirección y el puerto. - **El servidor presentó un certificado que no se pudo verificar**: Activa **Aceptar certificado sin verificar** y prueba otra vez. ### Campos de un Buzón Saliente - **Dominio***: El dominio desde el que se envían los correos. Escoges uno de los que ya están registrados. Si el que necesitas no está en la lista, pídele al soporte de Audara que lo agregue, después de verificarlo en tu servicio de correo. - **Buzón***: La parte que va antes del símbolo @. Solo se permiten letras, números, puntos, guiones y guiones bajos. Debajo de los dos campos, Audara te muestra la **dirección resultante** ya armada, para que confirmes que quedó como la querías antes de guardar. ### Plantillas La pestaña **Plantillas** te deja crear correos reutilizables para no volver a escribir el mismo mensaje cada vez. ![Plantillas de correo de una integración](https://docs.audara.io/integraciones/imagenes/integraciones-correo-plantillas.jpg) *Plantillas de correo de una integración* Cada plantilla tiene un asunto y un cuerpo, y puede ser de dos tipos: - **Texto**: Un editor de texto con formato, para mensajes sencillos. - **Diseño**: Un editor de HTML, para correos maquetados. Tanto el asunto como el cuerpo aceptan variables. Al lado del editor puedes escribir **valores de ejemplo** para las variables y ver la vista previa del correo con esos valores reemplazados, sin tener que enviarlo. ## SMS La integración de SMS es la que le permite a Audara enviar mensajes de texto, tanto desde las campañas de SMS Blaster como desde los flujos de los bots. La lista muestra el **Nombre**, cuántas **Plantillas** tiene y el **Estado**. ### Ajustes ![Ajustes de una integración de SMS](https://docs.audara.io/integraciones/imagenes/integraciones-sms-ajustes.jpg) *Ajustes de una integración de SMS* - **Nombre***: Nombre con el que se identifica la integración en Audara. Mínimo tres caracteres. - **Proveedor**: El proveedor de SMS que vas a usar. Es la decisión que manda en toda la pantalla: de ella dependen los nombres de los campos de credenciales y qué otros ajustes aparecen. - **Usuario***: El usuario de tu cuenta en el proveedor. - **Remitente**: El nombre o número que ven los destinatarios. - **API Key***: La clave que te entregó el proveedor. ### Si tu proveedor es Masiv Con Masiv la pantalla cambia. Los tres campos de credenciales se renombran para llamarse como Masiv los llama, y aparecen tres ajustes más que no existen con ningún otro proveedor. ![La misma pantalla con Masiv como proveedor](https://docs.audara.io/integraciones/imagenes/integraciones-sms-masiv.jpg) *La misma pantalla con Masiv como proveedor* - **Usuario***: El usuario de tu cuenta de Masiv, el mismo con el que entras a su plataforma. - **Código corto**: El código corto que te asignó Masiv, por ejemplo 87007. Si lo dejas vacío, Masiv usa la primera ruta disponible de la cuenta. Es el campo que con otros proveedores se llama Remitente. - **Contraseña***: La contraseña de tu cuenta de Masiv. Es el campo que con otros proveedores se llama API Key. - **Indicativo del país**: Se le antepone a los números que no lo traigan. Para Colombia es 57. - **Tildes y emojis**: Qué hacer con los caracteres que el formato estándar no admite. Se explica abajo. #### Tildes y emojis Masiv no admite á, í, ó, ú ni emojis en el formato estándar. Este selector decide qué hacer con ellos: - **Quitarlos (formato estándar)**: Los caracteres que el formato estándar no admite se borran del mensaje antes de enviarlo. El mensaje se cobra cada 160 caracteres. - **Conservarlos (formato enriquecido)**: El mensaje se envía tal cual, con tildes y emojis, pero se cobra cada 70 caracteres en vez de cada 160. > **Importante** > Con el formato estándar el mensaje se envía igual, solo que sin las tildes. No es un error ni un fallo de entrega: es el proveedor limpiando el texto. Si el mensaje tiene que llegar bien escrito, escoge el formato enriquecido y ten en cuenta que te va a costar más. #### URL para los eventos de Masiv Masiv le avisa a Audara el estado de cada mensaje enviándolo a una URL. Esa URL se genera cuando guardas la integración, y desde ese momento aparece en el formulario con un botón para copiarla. Mientras no la hayas guardado, en su lugar dice que la URL se genera al guardar. Para que los estados lleguen, hay que pedirle a Masiv que registre esa URL, indicándoles el id de la cuenta, los eventos que quieres recibir y el tipo de tráfico. > **Importante** > La URL es única para esta integración y lleva un token dentro. No la compartas ni la publiques: cualquiera que la tenga puede mandarle eventos falsos a tu operación. ### Plantillas Igual que en correo, la pestaña **Plantillas** guarda mensajes reutilizables. Un mensaje de SMS admite variables con la sintaxis `{{nombre}}`, y puedes darle valores de ejemplo para ver la vista previa. El editor te avisa cuando el mensaje se pasa del límite de caracteres de un SMS estándar. Si el mensaje tiene variables, el aviso es distinto: Audara no sabe cuánto van a medir los valores reales, así que te advierte que el mensaje final podría pasarse del límite y no entregarse. ## HubSpot La integración con HubSpot conecta el CRM de Audara con el de HubSpot: define las peticiones que Audara le hace a la API de HubSpot y sincroniza las propiedades de los contactos entre las dos plataformas. La lista muestra el **Nombre**, el **CRM** de Audara al que está asociada, si está **Sincronizado** y el **Estado**. ### Ajustes La pestaña de ajustes es corta: nombre y token. ![Ajustes de una integración de HubSpot](https://docs.audara.io/integraciones/imagenes/integraciones-hubspot-ajustes.jpg) *Ajustes de una integración de HubSpot* - **Nombre***: Nombre con el que se identifica la integración en Audara. - **Authorization**: El token con el que Audara se autentica ante HubSpot. Se manda como header de autorización en todas las peticiones de esta integración. Lo generas en tu cuenta de HubSpot. - **Secreto**: Con el interruptor activado, el token se oculta al volver a abrir la integración y en los registros. Solo se habilita cuando ya escribiste un token. > **Buena práctica** > Deja **Secreto** activado siempre. El token de HubSpot da acceso a los contactos de tu CRM, y con el interruptor apagado queda a la vista de cualquiera que pueda abrir la integración. > **Nota** > Si intentas crear una segunda integración con el mismo token, Audara no la guarda y te dice con qué nombre ya existe. Un token se usa en una sola integración. ### Solicitudes En la pestaña **Solicitudes** defines cada llamado que Audara le hace a HubSpot. ![Las solicitudes definidas en la integración](https://docs.audara.io/integraciones/imagenes/integraciones-hubspot-solicitudes.jpg) *Las solicitudes definidas en la integración* La lista muestra el **Nombre** y el **Método** de cada una. Creas una nueva con el botón **Nueva solicitud**, y desde el menú de más opciones (⋮) de cada fila la editas o la eliminas. ![Formulario de una solicitud](https://docs.audara.io/integraciones/imagenes/integraciones-hubspot-solicitud.jpg) *Formulario de una solicitud* - **Nombre***: Nombre con el que se identifica la solicitud. - **Método***: El método HTTP: GET, POST, PUT y demás. - **Ruta***: La ruta del recurso en la API de HubSpot, por ejemplo `crm/v3/objects/contacts`. Puede llevar variables entre llaves, como `crm/v3/objects/contacts/{contactId}`, y el valor se le pasa al ejecutarla. Debajo de los campos está **Probar solicitud**. Al desplegarlo puedes ejecutar la solicitud de verdad y ver el status y la respuesta completa. Sobre esa respuesta escoges qué campos quieres usar en Audara, y puedes renombrarlos si los nombres que devuelve HubSpot no son claros. > **Buena práctica** > Prueba cada solicitud antes de guardarla. Es la única forma de confirmar que el token y la ruta quedaron bien, y de paso es como escoges los campos de la respuesta sin tener que adivinar cómo vienen. ### Sincronización La pestaña **Sincronización** es la que empareja los campos de HubSpot con los del CRM de Audara. ![Emparejamiento de campos entre HubSpot y Audara](https://docs.audara.io/integraciones/imagenes/integraciones-hubspot-sync.jpg) *Emparejamiento de campos entre HubSpot y Audara* El recorrido es este: 1. Presiona **Validar integración**. Audara le pide a HubSpot la lista de propiedades disponibles y confirma que el token sirve. 2. Escoge el **CRM** de Audara con el que se va a sincronizar. 3. Empareja los campos: a la izquierda escoges un campo de HubSpot, a la derecha el campo de Audara que le corresponde. Agrega tantas parejas como necesites con el botón **Agregar**, y quita las que sobren con el ícono de la papelera. 4. Presiona **Sync** y confirma. Si intentas sincronizar sin haber validado primero, o sin haber emparejado ningún campo, Audara te lo dice y no arranca. > **Importante** > Mientras la sincronización está corriendo, la integración queda bloqueada y no se puede editar. El formulario te lo avisa con una franja en la parte de arriba. Espera a que termine antes de volver a tocarla. ## API y MCP Dos de las tarjetas del tablero tienen su propio artículo, porque son lo bastante grandes como para no caber aquí: - **API**: Las integraciones por API REST, con las que Audara consulta y escribe en los sistemas de tu negocio desde los flujos de los bots. Están explicadas en el artículo **[Integraciones REST](https://docs.audara.io/integraciones-api-rest/)**. - **MCP**: La conexión con servidores MCP externos, que le entregan herramientas a tus bots sin que tengas que definir cada petición a mano. Están explicadas en el artículo **[Integraciones MCP](https://docs.audara.io/mcp/)**.