Agentes de IA en CRMInbox - CRMInbox

Agentes de IA en CRMInbox

¿Qué es un Agente de Inteligencia Artificial (IA) en CRMInbox?

En CRMInbox, hemos desarrollado una herramienta que le permite mantener una conversación más inmediata y dinámica con sus clientes. Los Agentes de IA son una herramienta que le permite crear y configurar un agente con la información de su negocio según sus necesidades, ya sea para ventas, soporte, validación de comprobantes, etc. Si se configuran de forma adecuada, un Agente de IA en CRMInbox puede:

  • Tomar control de la conversación y responderle a sus clientes

  • Acceder a Bases de Conocimiento para obtener la información que usted quiera subirle.

  • Con ayuda de los AI Triggers, ejecutar Flujos para realizar acciones.

Nuestros agentes actualmente pueden responder a:

  • Mensajes de texto de los clientes.
  • Imágenes.
  • Documentos PDF y texto.
  • Audios.

Acceder a la Lista de Agentes de IA

Cuando tienes el Plan con Agentes de IA, puedes acceder al apartado de Agentes. Dirígete al apartado de Automatización > Agentes > Lista  y accederás a la lista de Agentes de IA, donde verás los agentes que has creado. Desde aquí puedes crear, modificar o eliminar Agentes de IA.

Crear un Agente de IA en CRMInbox

Acceder al Formulario de Nuevo Agente

Para acceder al formulario para crear un Agente de IA, en la Lista de Agentes, da clic en Nuevo Agente y se te redirigirá al formulario para crear un agente.

Campos del Formulario de Nuevo Agente

Una vez en el formulario, usted puede llenarlo para crear el agente con la configuración y comportamiento que usted desee. Los campos del formulario son los siguientes:

  1. Nombre - El nombre que le quieras dar al agente para identificarlo.

  2. Prompt - Prompt que usará el agente. Aquí puedes definir su personalidad, comportamiento, libertades, limitaciones, etc. Trata de ser lo más específico posible, para obtener los resultados deseados.

  3. Modelo - El modelo de Inteligencia Artificial que usará el agente. Actualmente el sistema detecta el proveedor según tu API Key: OpenAI (GPT) si la clave empieza por sk-, o Google (Gemini) si empieza por AIza. El modelo concreto se asigna automáticamente al guardar.

  4. API Key - API Key que le otorga su proveedor de modelos de IA para comunicarse con su servicio de Inteligencia Artificial.

  5. Temperatura - Valor que define la creatividad de las respuestas del agente. Si el valor es alto, las respuestas serán creativas; si es bajo, dará respuestas más precisas.

  6. Máximo de Tokens - Valor de los tokens máximos en las respuestas del agente. Los tokens son un aproximado de lo largo de las respuestas del agente. Aproximadamente, un token son 4 caracteres (o letras y símbolos).

  7. Primario - Valor que determina si el agente es el primero en asociarse a las conversaciones nuevas.

  8. Activo - Valor que determina si el agente está activo o no. Si el agente está inactivo, no participará en las conversaciones.

  9. Triggers de IA (Opcional) - Estos son los AI Triggers que se asocian al agente. Para conocer más sobre los AI Triggers da clic aquí.

  10. Bases de Conocimiento (Opcional) - Estas son las Bases de Conocimiento que se asocian al agente. Para conocer más sobre las Bases de Conocimiento da clic aquí. Las bases deben estar en estado Listo para que el agente pueda consultarlas correctamente.

Editar un Agente de IA

Si deseas modificar algún apartado de algún agente que ya hayas creado dentro de CRMInbox, basta con que lo ubiques en la Lista de Agentes y des clic en el botón de Editar Agente.  Esto te redireccionará al formulario del agente para que puedas editar cualquier campo.

Errores al usar un Agente de IA

Cuando el agente no puede responder (por configuración, proveedor de IA, base de conocimiento o archivos), CRMInbox genera un mensaje de error legible con título, qué revisar y enlaces útiles (configuración del agente, facturación del proveedor, etc.). En la mayoría de los casos no hace falta contactar a soporte: el mensaje indica la causa y los pasos a seguir.

Dónde se muestran los errores

A diferencia de las Bases de Conocimiento, los agentes no muestran errores en la lista de agentes. Los errores aparecen según el contexto en el que se use el agente:

  1. Conversación de WhatsApp (chat del CRM) — Cuando el agente falla al procesar un mensaje del cliente, se registra un mensaje interno de tipo Log en el hilo de la conversación. Se muestra como una alerta gris en la línea de tiempo del chat, con el detalle formateado (títulos, listas y enlaces). Este mensaje es solo para el equipo: no se envía al cliente por WhatsApp. Revísalo en la conversación donde el agente estaba activo.

  2. Asistente de IA (panel lateral en el chat) — Si usas el asistente interno para probar o pedir ayuda con un cliente, los errores aparecen en un recuadro rojo dentro del panel, con el mismo formato de texto enriquecido (Markdown).

  3. Respuesta inteligente (Smart Reply) — Si usas la función de sugerencia automática de respuesta, el error se muestra en el área de la sugerencia con el prefijo Error: y el detalle del problema.

  4. Cliente en WhatsApp (solo archivos) — Si falla el procesamiento de un archivo (imagen, PDF, audio, etc.) enviado por el cliente, el sistema puede enviar al cliente un mensaje genérico: «Lo siento, hubo un problema procesando tu archivo. Por favor, inténtalo de nuevo.» En ese caso, el detalle técnico sigue estando en el chat interno (Log) para tu equipo.

Errores comunes del proveedor de IA (API Key y modelo)

Estos errores aparecen cuando la llamada al proveedor (OpenAI o Google) falla. El mensaje incluye un enlace para editar el agente en CRMInbox (Automatización > Agentes > Editar):

  • Error 429 — Cuota o fondos insuficientes — La cuenta del proveedor no tiene saldo o cuota. Revisa facturación en OpenAI o Google AI Studio.

  • Error 401 — API Key no válida — Clave incorrecta, incompleta, con espacios de más o desactivada. Genera o revisa la key en el panel del proveedor.

  • Error 403 — Sin API Key válida (común en Google) — No se detectó una key válida. Configura una API key activa en el formulario del agente.

  • Error 404 — Modelo o recurso no encontrado — El modelo no existe o no está disponible para tu cuenta.

  • Error 400 — Solicitud inválida — Parámetros incorrectos o configuración incompleta en el proveedor.

  • Error 429 — Límite de solicitudes — Demasiadas peticiones en poco tiempo. Espera unos minutos e intenta de nuevo.

  • Servicio de IA temporalmente no disponible — Fallo momentáneo del proveedor (timeout, error interno, etc.). Espera 15–30 minutos. Puedes consultar el estado en status.openai.com o status.cloud.google.com.

  • Error inesperado en el agente de IA — No se pudo identificar la causa exacta. Reintenta en unos momentos y, si persiste, revisa la configuración del agente (prompt, API Key, bases asociadas).

Errores relacionados con Bases de Conocimiento

Si el agente tiene Bases de Conocimiento asociadas y falla al consultarlas (embeddings, archivos PDF dañados, base no procesada, etc.), verás un mensaje orientado a la base de conocimiento afectada, con enlace para editarla y corregir archivos o API Key de embeddings. Los tipos de error son los mismos que al procesar una base (PDF sin texto, contraseña, archivo dañado, cuota del proveedor, etc.). Para el detalle completo, consulta la documentación de Bases de Conocimiento.

Recomendación: antes de asociar una base a un agente, confirma que en la lista de bases aparece en estado Listo. Si muestra Error, corrige la base primero.

Validaciones al crear o editar un agente

Al guardar el formulario del agente, pueden aparecer errores de validación en rojo, por ejemplo:

  • La API key no es válida — Debe comenzar por sk- (OpenAI) o AIza (Google).
  • Campos obligatorios vacíos (nombre, prompt, etc.).

Eliminar un Agente de IA

Si deseas eliminar alguno de los agentes que creaste dentro de la plataforma, es posible. Solo ubícalo en la Lista de Agentes y des clic en el botón de Eliminar. Esto te mandará a una página de confirmación; si realmente deseas eliminarlo, da clic en Sí, Eliminar y el Agente se borrará del sistema.

Ejemplo de Funcionamiento

En un sistema de pruebas, hemos creado un Agente de IA con una configuración para que se comporte como un asistente virtual de un ISP ficticio llamado InterCun. El Agente fue nutrido con una Base de Conocimientos sobre planes de la empresa ficticia. En el Prompt, definimos su personalidad y alcance. Además, implementamos un AI Trigger que se activa cuando el cliente quiere contratar. Este ejemplo permite ejemplificar el funcionamiento de los Agentes de IA dentro de CRMInbox. El ejemplo está con la velocidad aumentada.

SIGUIENTE PASO ➜

Sept. 11, 2025, 3:58 p.m. - Visitas: 2308