Configuración de OpenAI para Agentes IA de 3CX

Introducción

Esta guía explica cómo integrar OpenAI con los Agentes IA de 3CX para activar escenarios inteligentes de recepcionista y manejar llamadas impulsadas por IA.

Esta función requiere una licencia 3CX IA.

Paso 1: Configuración de una Cuenta OpenAI

Si aún no tiene una cuenta de OpenAI, deberá crear una, configurar la facturación y generar una Clave API.

Crear un Proyecto y Configurar la Facturación

• Ingrese a OpenAI desde la página de inicio de sesión.
• Genere un Nuevo Proyecto y asígnele un nombre descriptivo.
• Vaya a “Ajustes → Facturación” y complete el proceso de configuración de la suscripción.
• Asegúrese de tener suficiente crédito para el uso esperado.

Nota: Debe tener una cuenta OpenAI de pago para que funcione correctamente; las cuentas de prueba son limitadas y pueden presentar problemas o errores impredecibles. Las cuentas de OpenAI que pagan un mínimo de $100 suelen pasar directamente al Nivel 3.

Configurar el Acceso al Modelo y los Límites

• Vaya a “Proyecto → Límites”.
• Establezca un presupuesto para controlar sus gastos.
• En Modelos permitidos o bloqueados, mantenga la lista vacía para permitir todos los modelos.
• En Límites de Tarifa, aumente los límites para los modelos anteriores según sea necesario (las instalaciones más grandes pueden requerir límites más altos para evitar comportamientos impredecibles).

Nota sobre los Límites de Tarifas: su capacidad para aumentar los límites depende de su nivel de uso de la API de OpenAI y del historial de su cuenta.

Generar una Nueva Clave API

• Vaya a “Panel de Control → Claves API”.
• Haga clic en Crear una Nueva Clave Secreta.
• Ingrese un nombre descriptivo y establezca los permisos en Todos.
• Copie y guarde la clave de forma segura.

Paso 2: Configuración de OpenAI en 3CX

• En la Consola de Administración, vaya a "Admin → Integraciones → IA" y haga clic en el botón API de OpenAI.

• Pegue su Llave Secreta OpenAI.
• Seleccione los Modelos:

• Modelo OpenAI para Llamadas en Tiempo Real: gpt-realtime (recomendado).
• Modelo OpenAI para Texto: gpt-5o-mini (recomendado).

• Ingrese los siguientes detalles:

• Nombre de la Empresa
• Descripción de la Empresa - utilizada por los Agentes IA para comprender el contexto de su organización.

• Haga clic en Guardar.

Paso 3: Agregar Fuentes de Conocimiento / RAG (aportar su propio contenido)

Las Fuentes de Conocimiento permiten a los agentes recuperar contenido específico de la empresa durante las llamadas o chats (políticas, preguntas frecuentes, reglas de enrutamiento, documentación de productos). En el ecosistema de OpenAI, esto se implementa normalmente mediante la incorporación de archivos o la búsqueda embebida / vector para la recuperación.

• En la Consola de Administración, vaya a "Admin → Integraciones → IA".
• Haga clic en Fuentes de Conocimiento seguido de clic en el botón Agregar.

• Ingrese un Nombre y Descripción a su base de conocimientos.
• Cargue archivos (PDFs / documentos / texto) que contengan cualquier información relacionada con su negocio, como:

• Horas de trabajo y días festivos.
• Instrucciones de enrutamiento del departamento.
• Preguntas frecuentes sobre productos / precios.
• Texto "Qué hacemos / cómo comunicarse con nosotros".

• TIPS

• Asegúrate de que la Descripción refleje con precisión el contenido de la base de conocimientos para mejorar la recuperación de información.
• Si tiene documentos que abarcan contextos diferentes y no relacionados entre sí (por ejemplo, documentos médicos y documentos internos sobre políticas de viajes), no los guarde en el mismo almacén; genere almacenes de conocimiento separados para cada contexto.
• La API de OpenAI no actualiza 3CX cada vez que se produce un cambio en la base de conocimientos; cada vez que realice un cambio, pulse el botón Actualizar y espere a que se complete el proceso.

Nota: Las Fuentes de Conocimiento se crean y se facturan bajo el proyecto / clave de OpenAI que haya configurado.

Paso 4: Creación y Configuración de Agentes IA

• Haga clic en el botón “Admin → Integraciones → IA → Agregar Agente”:

• Elija el tipo de agente:

• Recepcionista: Agente de IA orientado a la empresa para el manejo y enrutamiento básico de llamadas.
• Asistente Personal: Configurado para atender llamadas de un usuario específico (por ejemplo: el Jefe).

• En la pestaña Información del Agente:

• Defina la Configuración General para su Agente IA:

• Extensión - extensión única para el Agente IA.
• Asistente para (AP solamente) - qué usuario representa el Asistente Personal (AP).
• Membresía del Departamento - a qué departamentos pertenece el Agente IA.
• Nombre y Apellido del Agente - identidad oral / visible para el Agente IA.
• Números DID Asignados - números directos entrantes que llegan al Agente IA.

• Configurar los Ajustes de Voz y Llamadas para su Agente IA:

• Estilo de Voz - seleccione la opción de voz preferida.
• Grabación de Llamadas - Desactivado o Todas las llamadas o Solo llamadas externas.
• Duración Máxima de la Llamada
• Enlace Click-to-Talk del Agente - habilitar la función Click-to-Talk en sus sitios.

• Haga clic en la pestaña Tipo de Agente:

• Defina las Fuentes de Conocimiento - elija a qué Fuentes de Conocimiento puede acceder el agente.
• Defina el Idioma de Presentación - elija el idioma predeterminado para saludar.

• También puede Permitir el Cambio de Idioma.

• Defina el Mensaje de Bienvenida - el primer idioma al responder.

• En la pestaña Instrucciones del Agente, las Instrucciones de Comportamiento de la IA ya están preconfiguradas; sin embargo, si es necesario, el botón Personalizar Anuncio permite ajustar el tono, los límites de la política y las reglas de "hacer / no hacer".
• En la pestaña Bloquear Llamadas Spam:

• La Protección contra Spam está activada de forma predeterminada.
• También puede personalizar Qué Cuenta como Spam para definir qué significa Spam o Fraude y qué acción tomar:

• Finalizar Llamada.
• Transferir A (a un supervisor / encargado).
• Enviar proyección de resumen + desconectar.

• En la pestaña Enrutamiento de Llamadas (solo Recepcionista):

• Agregue reglas de Comportamiento de Enrutamiento para que su Agente IA pueda enrutar de manera inteligente las llamadas y los chats a diferentes destinos según su descripción.

• Por ejemplo, si la persona que llama dice "Me sale el error 404", el Agente IA puede clasificarlo como una llamada de soporte técnico y transferirla a un destino con una descripción como "En caso de errores HTTP, transferir aquí".
• Puede crear varias entradas de enrutamiento, pero evite el uso excesivo de entradas para garantizar un enrutamiento preciso.

• Si permite el Enrutamiento de Extensiones por Nombre, su Agente IA permite a las personas que llaman solicitar transferencias por nombre; por ejemplo, "Por favor, transfiera mi llamada a Jorge".
• Con el Modo de Confidencialidad activado:

• esto evita que la IA revele información confidencial, como apellidos e información sobre los empleados.
• tenga en cuenta que si combina esto con Permitir Enrutamiento de Extensiones por Nombre, su Agente IA no podrá, por ejemplo, preguntar "Tenemos dos Jorges, Jorge Sánchez y Jorge Juárez, ¿con cuál desea comunicarse?", sino que le pedirá al llamante el nombre completo del destinatario deseado.

• En la pestaña Proyección de Llamadas:

• Puede Desactivar la Proyección de Llamadas para Contactos Conocidos, lo que facilita el proceso de proyección para los contactos conocidos y de confianza almacenados en la agenda.
• Puede activar la casilla de verificación Comprobar Ocupado Antes de Transferir la Llamada para asegurarse de que la extensión de destino está disponible antes de transferir la llamada.

• En la pestaña Opciones:

• Las Acciones de Respuesta a Llamadas se dirigen a dos tipos específicos de personas problemáticas:

• Personas hostiles o abusivas.
• Personas que llaman y no colaboran, lo que dificulta la conversación.

• Se pueden configurar acciones adecuadas para manejar estas situaciones automáticamente.

Notas Técnicas

• Códec de audio: Solo compatible con PCMU.
• Configuración de Red / Cortafuegos (‘Firewall’)

• Asegúrese de que el Verificador de Cortafuegos le dé un informe favorable.
• También deberá permitir el tráfico saliente a:

• TCP 443 (HTTPS).
• UDP 3478 (STUN / TURN).

• Nota sobre los Modelos IA:

• OpenAI actualiza constantemente sus modelos y, a medida que se lanzan versiones nuevas y mejoradas, las versiones anteriores quedan obsoletas. La información de este documento se actualizará periódicamente para mantenerla al día con las opciones recomendadas actualmente. Deberá asegurarse de que su cuenta de OpenAI esté configurada para permitir que 3CX utilice los modelos más recientes.
• Las nuevas versiones de 3CX actualizarán automáticamente los modelos configurados a sus equivalentes más modernos.

Última Actualización

Este documento se actualizó por última vez el 26 de Mayo de 2026

https://www.3cx.es/docs/configuracion-agente-ia/