Integraciones
Conecta cualquier API
Usa servicios que no están en el catálogo de Conectores, desde APIs públicas hasta servicios que necesitan una clave, o agrega tu propio conector con el que la IA pueda construir.
El catálogo de Conectores incluye más de 100 servicios, pero tu app puede trabajar con casi cualquier servicio que tenga una API (una forma de que otros programas se comuniquen con él). Esta página te muestra las tres maneras de hacerlo, de la más rápida a la más reutilizable.
| Tu situación | Qué hacer |
|---|---|
| La API es pública y no necesita clave | Pídela en el chat |
| La API necesita una clave y solo la necesitas en una app | Deja que la IA te pida la clave, y se guarda como un secreto de esa app |
| Vas a usar el servicio en varias apps, o quieres que la IA lo entienda bien | Crea tu propio conector en la página de Conectores |
Elijas lo que elijas, las claves solo se usan en el código de servidor de tu app, así que no llegan a los navegadores de tus visitantes.
Usa una API pública
Muchos servicios, como el clima, los días festivos o los datos abiertos, no necesitan ninguna clave. Nombra el servicio y di qué quieres obtener de él.
Muestra en la página de inicio el pronóstico del tiempo a 5 días para la ciudad del visitante, usando la API de Open-Meteo.
Si la IA necesita detalles de una API que no conoce bien, pega en el chat la parte relevante de su documentación, por ejemplo un ejemplo de solicitud y la respuesta que devuelve, o adjunta la documentación como archivo. Consulta Agrega imágenes y archivos.
Usa una API que necesita una clave
Cuando una función necesita la clave de un servicio que no está en el catálogo, la IA muestra en el chat una tarjeta de clave con el nombre que va a usar, por ejemplo ACME_API_KEY. Pega la clave y haz clic en Guardar, o haz clic en Omitir para continuar sin ella.
La tarjeta lo dice con claridad: la clave se guarda de forma segura y cifrada, nunca aparece en el chat ni en el código de tu app, y puedes cambiarla más tarde en Gestionar → Secretos (a los integrantes del equipo se les avisa de que quien puede cambiarla es el propietario del proyecto).
Agrega un formulario de contacto que cree un nuevo cliente potencial en nuestro CRM a través de su API. Pídeme la clave de la API.
También puedes agregar claves tú mismo antes de pedir algo: abre la pestaña Gestionar, elige Secretos y agrega una en Agregar un secreto nuevo. Tu vista previa recoge los cambios automáticamente; tu app publicada los recibe la próxima vez que publiques. Consulta Secretos y claves de API.
No escribas claves en un mensaje del chat. Los mensajes del chat se guardan con tu proyecto. Usa mejor la tarjeta de clave o Gestionar → Secretos.
Crea tu propio conector
Si vas a usar un servicio en más de una app, o quieres que la IA entienda bien su API, agrégalo como tu propio conector. Describes la API una sola vez; después funciona como cualquier conector del catálogo: lo conectas con tu clave, lo activas o desactivas en cada app, y la IA puede construir con él y consultarlo mientras construye.
En la página de Conectores, desplázate hasta Tus propios conectores y haz clic en Crear conector. Ten abierta la documentación de la API del servicio, porque necesitarás su dirección de API y saber cómo recibe la clave. En la descripción no se escribe ninguna clave; conectas con la tuya al final.
Detalles
Ponle un Nombre. Si quieres, agrega una Descripción breve para la tarjeta y Qué hace (esto ayuda a la IA a saber cuándo usarlo). Después elige una Categoría, agrega un Enlace a la documentación de la API si quieres y elige un Color. El Nombre en código decide los nombres de los ajustes que leen tus apps, como
ACME_CRM_API_KEY. No se puede cambiar después.Cómo inicia sesión
Escribe la Dirección de la API con la que empieza cada solicitud (debe comenzar con
https://). Luego responde a ¿Cómo comprueba el servicio quién eres?: Token Bearer, Clave de API en un encabezado, Clave de API en la dirección o Usuario y contraseña. Si el servicio necesita más de un valor, como un ID de cuenta, agrégalos en ¿Necesita más de un valor?. Una vista previa muestra Cómo se ve una solicitud.Solicitud de prueba
Elige una solicitud que solo lea datos y que necesite la clave, como "quién soy" o "lista mis elementos". Buildliy la ejecuta para comprobar cada clave antes de guardarla, así que no debe cambiar nada. En Pruébalo (opcional) puedes pegar una clave y hacer clic en Ejecutar solicitud de prueba para ver la respuesta; esa clave solo se usa para la prueba y no se guarda, a menos que después conectes con ella.
Quién ve los datos
Elige Solo yo: es personal para datos privados de una cuenta (tu bandeja de entrada, tus notas o tu banco), o Cualquiera que use mi app: es compartido para datos pensados para todos, como una lista de productos o anuncios públicos.
Notas para la IA
Si quieres, pega las partes de la documentación de la API que la IA debería conocer: endpoints, ejemplos de solicitudes y respuestas. Ponle a cada nota un Nombre del archivo y, si quieres, indica ¿Cuándo debería leerlo la IA? Puedes agregar hasta 10 notas de 20 000 caracteres cada una. La IA ve el principio de cada nota y lee el resto cuando lo necesita. Nunca pegues claves aquí.
Haz clic en Crear conector. A continuación se abre la ventana de conexión, con la clave que hayas escrito en Pruébalo (opcional) ya escrita: escribe tu clave si hace falta y haz clic en Conectar. Buildliy ejecuta tu solicitud de prueba con la clave antes de guardarla y después la mantiene cifrada. Solo se usa en el código de servidor de tus apps.
Usa mi conector de Acme CRM para mostrar mis 20 contactos más recientes en una página de panel, con un cuadro de búsqueda.
Cada uno de tus propios conectores tiene una tarjeta con Conectar (Gestionar una vez conectado, o Reconectar si la clave deja de funcionar), Editar y un botón para eliminar. Al eliminarlo se borran el conector y la clave que guardaste para él, y las apps que lo usen dejarán de poder acceder al servicio hasta que lo vuelvas a agregar. Puedes tener hasta 25 conectores propios.
Si elegiste Solo yo: es personal, la IA mantiene todo lo que venga de ese servicio detrás del inicio de sesión de tu app. Una vez conectado, la lista de verificación de lanzamiento bloquea la publicación si el código de tu app lo usa y la app no tiene inicio de sesión. Si la app sí tiene inicio de sesión, la lista te recuerda que te asegures de que solo tú (o las personas que elijas) puedan iniciar sesión, porque un registro abierto permitiría que cualquiera viera los datos.
Recibe eventos de un servicio
Algunos servicios pueden enviar un mensaje a tu app cuando ocurre algo, como un pedido nuevo o un pago completado. A estos mensajes se les suele llamar webhooks. Pídele a la IA que agregue un lugar en tu app para recibirlos. Si el servicio te da un secreto de firma para comprobar que los mensajes son auténticos, la IA te lo pide con una tarjeta de clave.
Agrega un endpoint de webhook que reciba los eventos de pedidos nuevos de nuestro sistema de almacén y guarde cada pedido en la base de datos.
Dale al servicio la dirección de tu app publicada, no la de la vista previa, ya que la vista previa no siempre está en marcha. Consulta Publica tu app.
Relacionado
¿Sigues con dudas? Lee las preguntas frecuentes o escríbenos.