Your AI Connector Docs

Modelo de IA y BYOK

Esta página explica qué modelo de IA impulsa su bot, por qué solo se admite un proveedor para BYOK (Bring Your Own Key - Traiga su propia clave) y cómo configurar su propia clave si su plan lo incluye.


Qué modelo de IA impulsa el bot

La plataforma utiliza Anthropic Claude como modelo principal para su bot. Se eligió a Claude porque, tras realizar pruebas exhaustivas en todos los principales modelos de frontera (término del sector para los modelos de IA más avanzados disponibles) del mercado, es el único que gestiona de forma fiable el volumen de mensajes en producción.

No necesita elegir un modelo. La plataforma selecciona automáticamente el adecuado para cada tarea y optimiza su uso entre bastidores (incluido el almacenamiento en caché de prompts avanzado, lo que reduce drásticamente el coste por conversación).


Por qué solo Anthropic para BYOK

Los clientes suelen preguntar si añadiremos soporte para OpenAI, Google Gemini, OpenRouter o modelos de código abierto para BYOK. La respuesta honesta es: ninguno de ellos, utilizados de forma bruta y sin optimizar, resiste el volumen de producción.

Para un proyecto pequeño, una tasa de éxito de 9 sobre 10 por parte de una IA es aceptable. Una vez que gestiona conversaciones reales con clientes a gran escala, una tasa de error del 10% significa reservas fallidas, respuestas incorrectas, seguimientos perdidos y ventas perdidas. Eso está cerca de lo que vemos incluso en los modelos de frontera de primer nivel de otros proveedores (aproximadamente entre un 6 y un 10% en casos límite adversarios, es decir, preguntas de prueba complicadas y deliberadamente difíciles), y eso sin tener en cuenta los modelos más baratos.

Los problemas se dividen en tres categorías:

  • Los casos extremos fallan de forma impredecible. Un modelo puede funcionar perfectamente durante cientos de chats y, de repente, alucinar una llamada a una herramienta, afirmar que hizo algo que no hizo o descartar instrucciones a mitad de la conversación.
  • El contexto largo se gestiona mal. Una única respuesta del bot utiliza el historial del chat, preguntas frecuentes, lógica de seguimiento, llamadas a herramientas y razonamiento. La mayoría de los modelos se bloquean con este volumen y producen resultados de peor calidad.
  • Lo “más barato” rara vez lo es. El precio de etiqueta más bajo por token se ve compensado por más reintentos, más tokens de salida y una peor conversión. El coste real por conversación exitosa termina siendo más alto.

Admitir 100 modelos diferentes es más una estrategia de marketing que una capacidad real. Preferimos ofrecerle un proveedor que funcione de forma fiable que cinco que fallen cada uno de maneras distintas.


Nuestro propio modelo: Max

Hemos creado nuestro propio modelo interno, Max: un modelo interno más una pila de optimización de varias pasadas, perfeccionado con datos de conversaciones reales de la plataforma. El objetivo era lograr un modelo significativamente más rentable que Claude, manteniendo la fiabilidad en los patrones de conversación que la plataforma ejecuta realmente, y eso es lo que ofrece Max: una fracción del precio Pro (0,25 créditos por acción), ajustado para mantener la precisión donde un modelo económico básico fallaría.

Max no requiere configuración: ni elección de modelo, ni cuenta de proveedor, ni clave. Se ejecuta completamente en nuestra infraestructura y es el modelo más preciso que ofrecemos: en nuestras propias pruebas de rendimiento, es el más sólido a la hora de ceñirse a lo que su empresa realmente dice. Para obtener un desglose completo de cómo se compara Max con Claude y con los modelos económicos de terceros por los que los clientes suelen preguntar —incluyendo lo que esos modelos hicieron mal en nuestras pruebas—, consulte Por qué Max es la mejor opción.

Quién ve el nivel Max

Si el selector de Calidad de IA en la pestaña de Instrucciones de IA de su Agente solo muestra Pro y Economy, es simplemente porque Max no está activado en la cuenta con la que ha iniciado sesión. Hay dos cosas que lo activan:

  • Las cuentas con un plan de por vida elegible obtienen Max automáticamente.
  • Cualquier otra cuenta necesita que Max se habilite explícitamente en ella.

En una cuenta proporcionada por una agencia, es posible que su proveedor haya elegido el modelo por usted. Si el selector de calidad de IA muestra solo una tarjeta y no hay nada a lo que cambiar, se trata de una configuración deliberada de su cuenta, no de un error; pídale a quien le proporciona su cuenta que la cambie. Si todavía se muestra una tarjeta con una nota que indica que ya no está disponible, su Agente está en un modelo que su proveedor ha eliminado desde entonces: sigue respondiendo, pero en uno de los modelos que sí permiten, así que elija uno de ellos para que el selector coincida con lo que realmente se ejecuta.

Conectar su propia clave de Anthropic (BYOK) no tiene nada que ver con si Max es visible o no. Ambos funcionan de forma paralela; consulte la nota de excepción en Configuración de BYOK para saber cómo se factura un Agente Max cuando tiene una clave conectada. Eliminar su clave API no hará que aparezca Max.

El nivel Mini

Si puede ver Max, también puede ver Mini, a 0.15 créditos por acción. Mini es la misma IA que Max a un precio menor, con dos concesiones:

  • Mayor probabilidad de errores. Mini es el modelo más ligero de los dos. Max es el modelo más preciso que ofrecemos (ajustado al máximo para ceñirse a lo que su empresa dice realmente), mientras que con Mini existe una mayor probabilidad de que se cuele un pequeño error o alucinación en una respuesta.
  • Memoria más ligera. En conversaciones largas, Mini recuerda menos mensajes antiguos y extrae menos fragmentos de la base de conocimientos por respuesta.

Max sigue siendo la opción recomendada para todo aquello en lo que un detalle incorrecto pueda costar una venta: reservas, preguntas sobre precios, asistencia con riesgos reales. Mini se adapta a conversaciones de gran volumen y sensibles al precio donde la velocidad y el coste importan más que el último porcentaje de precisión.

Mini se encuentra en el mismo selector de calidad de IA que Max, en todas las cuentas que tienen Max. Al igual que Max, Mini se ejecuta completamente en nuestra infraestructura y nunca utiliza una clave BYOK, por lo que una clave de Anthropic conectada no se utiliza (ni se factura) mientras un agente está en Mini.

Qué cubre la tarifa de 0.15 de Mini. El precio de Mini se aplica a todo lo que sucede dentro de una conversación en vivo: respuestas de IA, llamadas a herramientas de IA (como reservar una cita o alertar a un humano), evaluaciones de chat (decidir si una conversación debe ignorarse o cerrarse), gestión de interrupciones (cuando un contacto envía un mensaje nuevo mientras el bot aún está redactando su respuesta), resúmenes de chat y etiquetado automático por IA. Las funciones de IA únicas fuera de la conversación —optimización de campañas, generación de bases de conocimiento y etiquetado realizado a través de la API— tienen una tarifa plana única de 0.25 créditos tanto en Max como en Mini, por lo que es posible que vea entradas ocasionales de 0.25 en su historial de créditos incluso cuando cada Agente esté configurado en Mini. Se trata de esas funciones, no del modelo Max respondiendo a sus chats.


Configuración de BYOK

BYOK está incluido en los planes Agency y Agency Unlimited, y en los niveles de por vida de AppSumo a partir del Plan 2. No forma parte del plan Business. Si su plan lo incluye, puede conectar su propia clave de API de Anthropic (un código privado de su cuenta de Anthropic que permite a la plataforma facturar el uso de IA directamente a usted en lugar de utilizar los créditos de la plataforma).

Solo funcionan las claves oficiales de Anthropic. Una clave válida proviene de su propia cuenta en console.anthropic.com y siempre comienza con sk-ant-. Las claves de revendedores, proxies o sitios de “API de Claude con descuento” (que a menudo comienzan con un prefijo diferente) no son compatibles y no se guardarán. Tenga cuidado con las ofertas de tokens de Claude baratos muy por debajo de los precios de la propia Anthropic: nadie puede revender legítimamente el acceso a Claude por debajo de lo que cobra Anthropic, y esas ofertas son casi siempre estafas basadas en claves robadas o configuradas para obtener sus datos de pago mediante phishing.

¿Está en un teléfono? Es posible que la barra lateral izquierda esté oculta. Pulse primero el icono de menú () y, a continuación, pulse Settings.

¿No ve las claves API BYOK en el grupo Avanzado? La sección solo aparece en los planes que incluyen BYOK. Si su cuenta es administrada por un proveedor, solo aparecerá cuando este haya activado Traiga su propia clave API para su cuenta.

  1. En la barra lateral izquierda principal, haz clic en Settings (el icono de engranaje cerca de la parte inferior).
  2. En la página de Settings, en el menú de la izquierda, desplázate hasta el grupo Advanced.
  3. Haz clic en BYOK API Keys.
  1. Haga clic en Add key (Añadir clave) en la tarjeta de Anthropic. Aparecerá un campo Secret key (Clave secreta) (marcador de posición sk-ant-…).
  1. Pegue su clave de API de Anthropic en el campo y, a continuación, haga clic en Save key (Guardar clave).

Una vez habilitado, su bot utilizará su propia clave para las llamadas de IA, y usted le pagará a Anthropic directamente por ese uso en lugar de gastar créditos de la plataforma en respuestas de IA. La infraestructura del canal (servidores de WhatsApp Web, números de teléfono, etc.) sigue utilizando créditos como de costumbre.

Una excepción: el nivel Max. Si la Calidad de IA de un Agente está configurada en el nivel Max, ese Agente se ejecuta completamente en nuestra infraestructura interna y se factura a 0,25 créditos por acción incluso cuando tiene BYOK conectado; Max nunca utiliza su clave de Anthropic. (Lo mismo se aplica a Mini, donde esté disponible: 0,15 créditos por acción, nunca su clave). Para facturar las respuestas a su propia cuenta de Anthropic, mantenga el Agente en el nivel Pro (estándar). El selector de Calidad de IA se encuentra en la pestaña Instrucciones de IA de cada Agente. La página de configuración de Claves API BYOK muestra un aviso siempre que su clave esté registrada pero uno o más de sus Agentes sigan ejecutándose en el nivel Max, enumerando cuáles, para que pueda identificar de un vistazo por qué se siguen utilizando créditos.

Una nota sobre el coste: Traer tu propia clave ya no es la opción más económica. Con una clave conectada, tu agente funciona con Claude y pagas las tarifas medidas de Anthropic directamente (Anthropic te factura en función de cuánto utilizas realmente, de forma similar a una factura de servicios públicos). Si se mide en las cuentas que utilizan su propia clave, una respuesta de IA cuesta aproximadamente 3 veces lo que cuesta la misma respuesta en Max y más de 5 veces lo que cuesta en Mini, una vez que se cuenta el trabajo de fondo que desencadena una respuesta (búsqueda en la base de conocimientos, verificación de spam, extracción de nombres y correos electrónicos, evaluaciones de chat, etiquetado), todo lo cual está incluido en la tarifa plana de Max y Mini, pero se factura por token en tu clave. Nuestras optimizaciones de almacenamiento en caché de prompts también se aplican a tu propia clave, por lo que no se trata de una brecha de almacenamiento en caché; Max y Mini son simplemente modelos mucho más baratos que también obtienen mejores resultados en nuestro punto de referencia de conversaciones de ventas. Utiliza BYOK cuando quieras específicamente que el uso de la IA se facture a tu propia cuenta de Anthropic, no para ahorrar dinero.

Por qué la primera respuesta en una conversación cuesta mucho más que el resto. El almacenamiento en caché funciona guardando el contexto de la conversación con Anthropic la primera vez que se envía y luego reutilizándolo. Escribirlo cuesta más que una solicitud normal; cada respuesta que lo reutiliza cuesta aproximadamente una vigésima parte. Por lo tanto, la primera respuesta parece alarmantemente cara y las siguientes son muy baratas. Cualquier elemento grande en la conversación hace que esa primera respuesta sea mayor: un documento que un visitante sube es el principal. Un PDF de 24 páginas equivale a unos 70 000 tokens, porque cada página se envía tanto como texto como en imagen, y permanece en la conversación, por lo que se vuelve a enviar (y a almacenar en caché) con cada respuesta. Si una conversación permanece inactiva durante más de una hora, la copia almacenada caduca y la siguiente respuesta vuelve a pagar el costo de escritura.

Si está creando algo con muchos documentos (explicadores de contratos, consultas de manuales, cualquier cosa donde la gente suba archivos), el nivel Max suele ser la mejor opción: tiene un costo fijo de 0.25 créditos por respuesta sin importar qué tan grande sea el documento, por lo que no hay un pico en el primer mensaje ni exposición por token. Consulte Por qué Max es la mejor opción para ver cómo se compara Max en cuanto a calidad y costo.

Si tu clave BYOK falla (es inválida, no tiene cuota o tiene límite de velocidad, lo que significa que Anthropic ha limitado temporalmente cuántas solicitudes puede realizar tu clave), el hecho de que tu bot siga funcionando depende del interruptor “Fallback to credits” en la misma página de BYOK API Keys:

  • Activado: la plataforma recurre temporalmente a los créditos de la plataforma para que tu bot siga respondiendo, y sigue reintentando tu clave en segundo plano; en el momento en que una llamada vuelve a tener éxito, vuelve a cambiar automáticamente a tu propia clave.
  • Desactivado (la opción predeterminada): las respuestas de la IA se bloquean hasta que corrijas la clave. Nada consume tus créditos silenciosamente, pero tu bot también deja de responder, así que si prefieres que siga funcionando con créditos mientras solucionas el problema de la clave, activa este interruptor con antelación.

De cualquier manera, recibirás un correo electrónico la primera vez que falle tu clave (no uno por cada mensaje).


Preguntas frecuentes

¿Puedo usar OpenAI, Gemini u otro proveedor para BYOK? Actualmente no, para otros proveedores. Para la mayoría de las personas la respuesta ya está aquí: Max y Mini son nuestros propios niveles internos, a 0,25 y 0,15 créditos por acción respectivamente.

¿Se utilizará mi clave BYOK para todo? La mayoría de las operaciones de IA están libres de cargos de crédito cuando su propia clave de Anthropic (BYOK) está conectada: las respuestas de IA, el uso de herramientas, la optimización de campañas, la generación de bases de conocimiento y la búsqueda web se ejecutan con su clave. Cuatro cosas siguen costando créditos incluso con una clave conectada: el nivel Max a 0,25 créditos por acción y el nivel Mini a 0,15, porque ambos se ejecutan en nuestros propios modelos; Lead Finder a 0,25 por dirección de correo electrónico encontrada; y las Automatizaciones a 0,25 por ejecución más 0,25 por paso de IA. Para mantener un Agente completamente con su propia clave a 0 créditos, déjelo en el nivel Pro. Las tarifas de canal (la tarifa mensual de WhatsApp Web, la entrega de mensajes de WhatsApp y las tarifas de plantillas) se facturan por separado del uso de IA en cualquier caso. Si la clave falla en una llamada que se habría ejecutado con ella, si la plataforma recurre a los créditos depende de su interruptor Fallback to credits (Recurrir a créditos): consulte el interruptor “Fallback to credits” descrito anteriormente en esta página.

¿Cuándo cuestan exactamente 0 créditos las respuestas de la IA? BYOK es por cuenta. Las respuestas de la IA cuestan 0 créditos solo cuando esta cuenta ha conectado su propia clave de Anthropic. Sin su propia clave, las respuestas consumen créditos a la tarifa normal.

¿Afecta BYOK a la entrega de mensajes o a la fiabilidad del canal? No. BYOK solo cambia la forma en que se facturan las llamadas de IA de su bot. Todo lo demás (enrutamiento de mensajes, infraestructura del canal, seguimientos, campañas y difusiones) funciona exactamente igual.


Véase también: Por qué Max es la mejor opción · Configuración de su bot de IA · Agentes de IA