Conectar tu clave de IA

Tus Agentes IA responden con el modelo de tu propio proveedor. Tú creas una clave en Gemini, OpenAI, Anthropic u OpenRouter, la conectas en el CRM y el consumo se lo pagas directo a ese proveedor: Fulfillo no cobra por los mensajes de la IA. Sin clave conectada, los agentes no contestan. Esta página explica cómo conectarla y cómo elegir el modelo.

Dónde está

Agentes IA › tarjeta «Conexión de IA», arriba de la lista de agentes.

Antes de empezar

Crea la clave en la consola de tu proveedor: Google AI Studio para Gemini, la consola de OpenAI, la consola de Anthropic u OpenRouter. El diálogo del CRM trae el enlace de cada uno. Necesitas una cuenta con facturación o saldo: una clave gratuita se agota en pocas respuestas.

Paso a paso

1. En «Conexión de IA», pulsa «Conectar mi clave».
2. En «Proveedor», elige uno. Debajo te dice qué entiende: Gemini lee texto, imágenes, notas de voz, videos y PDF; Anthropic, texto, imágenes y PDF; OpenAI y OpenRouter, texto e imágenes. Las notas de voz se transcriben en todos los casos; con OpenAI, con tu misma clave.
3. Pega la clave en «Clave de API». Se guarda cifrada y no se vuelve a mostrar.
4. Pulsa «Ver los modelos de mi clave». El CRM le pide a tu proveedor la lista de modelos que tu clave puede usar.
5. En «Modelo», elige uno. El primero de la lista lleva la etiqueta «Recomendado»: es el que da buena calidad a bajo costo para atender clientes. Cada opción muestra su precio por millón de tokens.
6. Debajo del modelo elegido, lee el detalle: el precio de entrada y de salida, un aviso si el precio va a subir, y lo que te costaría al mes con lo que consumieron tus agentes en los últimos 30 días.
7. Pulsa «Guardar y probar». El CRM manda un mensaje corto a tu proveedor con esa clave y ese modelo; si funciona, la guarda.

La tarjeta pasa a mostrar «Conectada», el proveedor, el modelo y los últimos caracteres de la clave. Desde ahí puedes «Cambiar» la clave o el modelo, o «Quitar» la clave.

Elegir el modelo

• El «Recomendado» de cada proveedor es el equilibrio entre precio y calidad para conversaciones de soporte y ventas. Empieza por ahí.
• Un modelo más caro no atiende mejor una tienda: lo que más pesa es la calidad de tus instrucciones y de tu base de conocimiento.
• Si tus clientes mandan muchas notas de voz o fotos, Gemini las entiende directamente. Con los demás proveedores las notas de voz se transcriben y las fotos las entienden todos; los videos sólo Gemini.
• Si el modelo no tiene precio conocido, la pantalla te lo dice: revísalo en la página de tu proveedor antes de elegirlo.
• La estimación mensual no descuenta la caché del proveedor, así que suele salir bastante menos.

Cuando algo falla

La tarjeta y el editor de cada agente muestran un aviso «Tus agentes IA no están respondiendo» con el motivo:

• Todavía no hay una clave conectada. Conéctala.
• El proveedor rechazó tu clave: la revocaste o venció. Conecta una nueva.
• Tu cuenta con el proveedor no tiene saldo, agotó su cuota o llegó a su tope de gasto. Recárgala o sube el tope y pulsa «Volver a comprobar».
• El modelo ya no está disponible con tu clave. Elige otro.

Mientras dure el fallo, las conversaciones asignadas al agente se quedan esperando a una persona.

Preguntas frecuentes

¿Una clave para toda la cuenta o una por agente? Una por cuenta. Todos tus agentes responden con el mismo proveedor y modelo.

¿Qué ve el proveedor? Las conversaciones que atiende el agente, con tus instrucciones y tu base de conocimiento. Con una clave de nivel gratuito, algunos proveedores pueden usar esas conversaciones para mejorar sus modelos: revisa sus condiciones antes de usarla con clientes.

¿Qué pasa si quito la clave? Los agentes dejan de responder y sus conversaciones quedan esperando a una persona. Puedes volver a conectarla cuando quieras.