> ## Documentation Index
> Fetch the complete documentation index at: https://docs.base44.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Uso de integraciones

> Conecta tus apps, workspaces y cuenta de Base44 a herramientas y servicios externos.

## Acerca de las integraciones

Las [integraciones](https://base44.com/integrations) conectan Base44 con el resto de tu stack para que puedas automatizar flujos de trabajo, traer datos y llamar a servicios externos sin programar cada llamada de API a mano.

Puedes integrar en 3 niveles:

* **Nivel de app:** Integraciones dentro de una sola app:
  * **Integraciones integradas** como Invoke LLM y SendEmail.
  * **Conectores** para conexiones basadas en OAuth con herramientas como Notion, Slack o Google Workspace.
  * **Llamadas a API externas con funciones de backend** que usan Secrets y funciones por app.
* **Nivel de workspace:** APIs compartidas gestionadas una sola vez para todo el workspace:
  * **Integraciones OpenAPI personalizadas** basadas en especificaciones OpenAPI que cualquier app del workspace puede llamar de forma segura.
* **Nivel de cuenta:** Conexiones que viven en tu cuenta de Base44:
  * **Conexiones MCP** que configuras una vez para que el chat de IA de Base44 pueda usar herramientas externas mientras construyes, sin cambiar el código desplegado de tu app.

***

## Integraciones a nivel de app

Las integraciones a nivel de app viven dentro de una sola app. Incluyen integraciones integradas, conectores y APIs externas impulsadas por el backend que conectas solo a esa app.

### Integraciones integradas

Algunas integraciones vienen preinstaladas en Base44 y están disponibles para usarse de inmediato. No requieren un plan de pago, configuración adicional ni claves API separadas. Con estas integraciones principales, puedes añadir IA, mensajería, manejo de archivos y lógica avanzada a cualquier app sin configuración adicional.

**Las integraciones integradas de Base44 incluyen:**

* **Invoke LLM:** Genera respuestas de IA desde el modelo de lenguaje integrado usando prompts detallados. Admite salidas con esquema JSON, archivos adjuntos para contexto adicional, análisis de imágenes y búsqueda web para información actualizada.
* **SendEmail:** Envía correos a personas en tu app de Base44 con nombres de remitente personalizables y contenido HTML enriquecido.
  <Note>
    SendEmail no admite el envío a listas de correo externas ni adjuntar archivos.
  </Note>
* **UploadFile:** Permite a las personas subir archivos a tu app. Usa la URL del archivo devuelto en otras integraciones o flujos de trabajo.
* **GenerateImage:** Crea imágenes a partir de prompts de texto detallados. Devuelve una URL a la imagen generada.
* **ExtractDataFromUploadedFile:** Extrae datos estructurados de archivos cargados (CSV, PNG, JPG, JPEG, PDF) usando esquemas JSON. Útil para importar datos en masa.

<Tip>
  Aprende más sobre las [integraciones integradas](/Integrations/built-in-integrations).
</Tip>

### Conectores

Los conectores son integraciones habilitadas con OAuth que permiten a una app específica conectarse a herramientas compatibles. Le pides al chat de IA que conecte un servicio, inicias sesión y apruebas los permisos solicitados. Tu app puede entonces leer o escribir datos en esa herramienta según lo que permitas.

<Warning>
  Necesitas un [**plan Builder**](https://base44.com/pricing) o superior para usar conectores en tu app.
</Warning>

**Ejemplos de lo que puedes construir con conectores:**

* Sincroniza una base de datos de Notion para alimentar una vista de conocimiento en tu app.
* Publica actualizaciones en un canal de Slack.
* Sincroniza registros de Salesforce o HubSpot en un dashboard interno.
* Guarda archivos de tu app en Google Drive.
* Bloquea tiempo en Google Calendar cuando se haga una nueva reserva.
* Publica una publicación de LinkedIn cuando se publique una nueva entrada de blog.
* Muestra estadísticas del perfil de TikTok y recuento de seguidores en un dashboard.

<Tip>
  [Aprende más sobre los conectores](/Integrations/Connectors).
</Tip>

### Llamadas a API externas con funciones de backend

Las integraciones externas que usan funciones de backend permiten que una app específica hable directamente con servicios de terceros como Stripe, Twilio o APIs de Google con credenciales por app. Estas llamadas se conectan a través de tus propias funciones de backend y Secrets.

<Frame caption="Conectar una integración a tu app de Base44 usando el chat de IA">
  <img src="https://mintcdn.com/base44/dZ1qJi0krzKe0iew/images/resend.png?fit=max&auto=format&n=dZ1qJi0krzKe0iew&q=85&s=147297448e51613a3fd7b1117c24d753" alt="Conectar una integración a tu app usando el chat de IA" className="mx-auto" width="1111" height="835" data-path="images/resend.png" />
</Frame>

**Usa funciones de backend cuando:**

* Quieras una integración única para una sola app.
* Necesites lógica personalizada estrechamente acoplada a esa app.
* El servicio aún no esté configurado como una integración OpenAPI personalizada en tu workspace.

**Ejemplos de integraciones externas con funciones de backend:**

* Enviar correos de bienvenida a personas nuevas que usan tu app a través de tu proveedor de correo.
* Sincronizar tu CRM existente con la base de datos de tu app.
* Alertar a tu equipo en Slack cuando alguien envíe un formulario.
* Generar contenido con herramientas de IA usando tus propias claves de proveedor.
* Llamar a APIs específicas de proveedores que aún no tienen un conector o una integración OpenAPI personalizada.

<Warning>
  **Importante:** Necesitas un [**plan Builder**](https://base44.com/pricing) o superior para usar funciones de backend.
</Warning>

Cuando solicitas una integración en el chat de IA, Base44 te guía paso a paso y te pide credenciales o autorización cuando es necesario. Luego conecta automáticamente la lógica del backend y el frontend para que puedas comenzar rápidamente.

Almacenas las credenciales como **Secrets** en el dashboard de la app y las usas en funciones TypeScript en **Dashboard → Code → Functions**.

<Tip>
  Cada función de backend tiene un archivo de código que puedes editar, ver y probar. También puedes revisar los registros de cada función desde **Dashboard → Code → Functions**.
</Tip>

***

## Integraciones a nivel de workspace

Las integraciones a nivel de workspace viven en un workspace y se pueden reutilizar en muchas apps sin repetir la configuración o las credenciales.

### Integraciones OpenAPI personalizadas

Las integraciones OpenAPI personalizadas te permiten registrar APIs externas compartidas a nivel de workspace desde una especificación OpenAPI. Importas una especificación una vez, seleccionas las operaciones que quieres exponer y cualquier app de ese workspace puede llamar a esas operaciones a través del SDK.

El AI builder y tu código frontend pueden llamar directamente a las integraciones OpenAPI personalizadas a través de `base44.integrations.custom` sin exponer credenciales. Las llamadas se proxean a través del backend de Base44, por lo que los secretos nunca llegan al navegador.

Esto es ideal para APIs internas y APIs de socios que tu equipo usa en muchas apps.

<Warning>
  **Importante:**

  * Solo los **propietarios y administradores del workspace en un plan Builder o superior** pueden crear o editar integraciones OpenAPI personalizadas.
  * Cualquiera en el workspace puede usar una integración OpenAPI personalizada existente en sus apps, incluso en un plan gratuito.
</Warning>

<Tip>
  Aprende cómo configurar estas APIs en detalle en [**Gestión de integraciones API personalizadas**](/documentation/integrations/using-custom-integrations).
</Tip>

***

## Conexiones a nivel de cuenta

Las conexiones a nivel de cuenta se configuran una vez para tu cuenta de Base44 y están disponibles dondequiera que uses el chat de IA de Base44.

### Conexiones MCP

Las conexiones MCP te permiten conectar servidores MCP personalizados a tu cuenta de Base44 para que el chat de IA pueda usar herramientas externas y datos como contexto mientras construyes. Esto te da un chat de builder consciente del contexto sin cambiar el runtime desplegado de tu app.

<Warning>
  **Importante:**

  * Las conexiones MCP están disponibles en el **plan Builder o superior**.
  * Los servidores MCP se configuran una vez por cuenta en **Account Settings → MCP Connections**.
  * El chat de IA solo llama a un servidor MCP cuando tu prompt lo requiere (por ejemplo, cuando mencionas ese servidor o pides datos que proporciona). No contacta con todos los servidores MCP en cada mensaje.
</Warning>

**Ejemplos de lo que puedes hacer con conexiones MCP:**

* Pídele al chat de IA que busque en un MCP de documentos internos y resuma las páginas más relevantes para una función.
* Conecta un servidor MCP de GitHub y pide un resumen de los issues abiertos en un repositorio específico.
* Conecta un MCP de analítica, como Amplitude o un servicio de métricas personalizado, y pídele al chat que extraiga métricas recientes del producto en la conversación mientras planeas cambios.

<Tip>
  Aprende cómo añadir y gestionar servidores MCP en [**Configurar un MCP personalizado**](/documentation/account-and-billing/setting-up-a-custom-mcp).
</Tip>

***

## Obtener tus claves API

Algunas integraciones requieren una clave API, que actúa como una contraseña privada entre Base44 y el servicio externo. Tu clave API demuestra la propiedad y mantiene tu conexión segura. Base44 almacena tu clave de forma segura para que tu app pueda usarla sin exponerla.

<Warning>
  Nunca compartas tu clave API públicamente. Trátala como una contraseña.
</Warning>

**Para obtener tu clave API:**

1. Inicia sesión en el servicio externo (por ejemplo, OpenAI, Resend, Notion).
2. Encuentra la sección **Developer**, **API** o **Integrations**.
3. Haz clic en **Create API Key** o **Generate Token** y cópialo.
4. Pega tu clave API en Base44:
   * **Usando el chat de IA:** Introduce tu clave API en el chat de IA cuando se te solicite.
     <Frame caption="Añadir tu clave API en el chat de IA en Base44">
       <img src="https://mintcdn.com/base44/_sloqzobDUv4viJs/images/chataiapi.png?fit=max&auto=format&n=_sloqzobDUv4viJs&q=85&s=c66214a04f7b320fc4c72d77963335ac" alt="Añadir tu clave API en el chat de IA en Base44" title="Añadir tu clave API en el chat de IA en Base44" className="mx-auto" style={{ width:"61%" }} width="1006" height="1234" data-path="images/chataiapi.png" />
     </Frame>
   * **Configurando manualmente:** Guarda tu clave API en **Secrets**.\
     a. Haz clic en **Dashboard** en el editor de tu app.\
     b. Haz clic en **Secrets**.\
     c. Haz clic en **Add Secret**.
   <Frame caption="Añadir secretos en el dashboard de la app de Base44">
     <img src="https://mintcdn.com/base44/md0uEgmxEQCB9Nzh/images/apikeys.png?fit=max&auto=format&n=md0uEgmxEQCB9Nzh&q=85&s=38737506f2d314b714dcc48fbfea347c" alt="Añadir secretos en el dashboard de la app de Base44" className="mx-auto" width="1270" height="727" data-path="images/apikeys.png" />
   </Frame>

Las integraciones OpenAPI personalizadas también usan secretos, pero estos los configura una vez un administrador del workspace al crear o editar la integración y se almacenan como secretos cifrados del workspace, no como Secrets por app.

***

## Preguntas frecuentes

Haz clic en una pregunta para aprender más sobre el uso de integraciones.

<AccordionGroup>
  <Accordion title="¿Cuál es la diferencia entre integraciones OpenAPI personalizadas y APIs externas por app?">
    Las integraciones OpenAPI personalizadas se configuran una vez en un workspace a partir de una especificación OpenAPI y están disponibles para cada app de ese workspace a través de `base44.integrations.custom.call()`. Las credenciales se almacenan como secretos cifrados del workspace y nunca se exponen al código de la app, y no necesitas funciones de backend para usarlas.

    Las APIs externas por app usan funciones de backend y Secrets en una app específica. Son ideales para lógica específica de la app o cuando no quieras compartir una API en todas las apps de un workspace.
  </Accordion>

  <Accordion title="¿Cómo debo probar mi integración antes de publicar?">
    Antes de publicar tu app, prueba tu integración para detectar problemas a tiempo:

    1. Usa el modo sandbox o de prueba (por ejemplo, claves de prueba de Stripe), si el proveedor lo ofrece.
    2. Prueba flujos reales y casos límite, no solo un único camino feliz.
    3. Verifica que las entradas y salidas coincidan con tus expectativas en tu UI y en el panel del proveedor.
    4. Monitorea el uso de créditos de integración tanto en Base44 como en el servicio externo.
    5. Previsualiza tu app para detectar carga lenta, llamadas API fallidas o datos faltantes antes de salir en vivo.
  </Accordion>

  <Accordion title="¿Por qué no funciona mi integración?">
    Si tienes problemas, verifica lo siguiente:

    * Tu workspace está en un plan Builder o superior (para APIs externas por app que usan funciones de backend).
    * Tu clave API es correcta y está guardada en Secrets o en la integración OpenAPI personalizada, si corresponde.
    * Tienes suficientes créditos activos en el servicio externo.
    * Estás usando credenciales en vivo, no de prueba, al probar flujos de producción.
    * Tu solicitud API incluye el endpoint, payload y parámetros correctos.
    * No has alcanzado los límites de velocidad del servicio.
  </Accordion>

  <Accordion title="¿Quién puede usar funciones de backend y APIs externas por app?">
    Las funciones de backend y las APIs externas por app requieren un plan Builder o superior en el workspace donde se creó la app. Si el workspace está en un plan gratuito o Starter, las funciones de backend y las integraciones que dependen de ellas no están disponibles.

    Los propietarios y administradores del workspace pueden crear funciones de backend en apps de las que son propietarios. Los colaboradores con un rol de Editor también pueden editar y crear funciones de backend en una app siempre que el workspace tenga un plan Builder o superior.
  </Accordion>

  <Accordion title="¿Por qué obtengo errores 403 al usar funciones de backend?">
    Si ves un error 403 al usar funciones de backend, puede significar que las funciones de backend no están disponibles para tu app o workspace, o que la solicitud no tiene permisos.

    Causas y soluciones comunes:

    * **Requisito del plan:** Las funciones de backend solo están disponibles en un plan Builder o superior. Si el workspace está en un plan gratuito o Starter, las llamadas al backend y las integraciones por app que dependen de ellas pueden fallar con 403.
    * **Permisos en tu función:** Tu función de backend puede estar rechazando la solicitud porque la persona no ha iniciado sesión o no tiene el rol correcto. Verifica las comprobaciones de rol o acceso que añadiste en el código de la función.
    * **Permisos del servicio externo:** Un 403 también puede provenir de la API externa que estás llamando. Asegúrate de que la clave API tenga los alcances correctos y que la solicitud use el endpoint y método correctos.
    * **¿Aún tienes problemas?** Consulta el artículo [Solución de problemas](/Community-and-support/Troubleshooting) o contacta con el soporte de Base44.
  </Accordion>

  <Accordion title="¿Cómo regenero o actualizo mi clave API?">
    Hay 2 tipos de claves API que es posible que necesites regenerar o actualizar:

    * **Claves de servicios de terceros:** Regenera tu clave en el portal de desarrolladores de ese servicio, por ejemplo OpenAI, Resend, Notion, luego actualízala en **Dashboard → Secrets** o en la configuración de tu integración OpenAPI personalizada.
    * **Clave API de tu cuenta de Base44:**
      1. Haz clic en tu icono de perfil en la esquina superior derecha de tu cuenta.
      2. Haz clic en **Account settings**.
      3. Haz clic en **Regenerate** junto a **API Key**.

    <Note>
      Una vez regenerada, tu clave API de Base44 se actualiza automáticamente en todas tus apps de Base44. Si añadiste tu clave de Base44 en otro servicio, actualízala también allí.
    </Note>
  </Accordion>

  <Accordion title="¿Qué pasa con mis integraciones si bajo de plan?">
    * Las integraciones integradas siguen disponibles.
    * Los conectores, las integraciones OpenAPI personalizadas, las conexiones MCP y las APIs externas por app que dependen de funciones de backend pueden dejar de funcionar hasta que actualices a un [**plan Builder**](https://base44.com/pricing) o superior.
  </Accordion>

  <Accordion title="¿Puedo usar múltiples integraciones en una app?">
    Sí. Puedes combinar integraciones integradas, conectores, integraciones OpenAPI personalizadas y APIs externas por app en la misma app, siempre que tu plan y configuración lo admitan.
  </Accordion>

  <Accordion title="¿Por qué Base44 o la IA no pueden obtener mi clave API por mí?">
    Por razones de seguridad, los servicios externos como Stripe, OpenAI o Notion no permiten que terceros, incluido Base44, accedan a tus credenciales automáticamente. En su lugar, debes:

    1. Iniciar sesión en el servicio.
    2. Ir a la sección API o developer.
    3. Generar tu clave.
    4. Pegarla en Base44 como Secret o encabezado del workspace.

    Una vez añadida, tu app o integración OpenAPI personalizada puede usar esa clave en segundo plano de forma segura y sin código.

    <Note>
      **Por qué importa:** Las claves API actúan como contraseñas para los servicios. Mantenerlas privadas y bajo tu control mantiene tus datos seguros y garantiza que solo tú autorices el acceso.
    </Note>
  </Accordion>

  <Accordion title="¿Las conexiones MCP funcionan como otras integraciones de app?">
    No. Las conexiones MCP son solo para el chat de IA de Base44 mientras construyes. Se configuran a nivel de cuenta en **Settings → MCP Connections** y se usan solo cuando tu prompt requiere ese servidor MCP. Tu app desplegada no llama a servidores MCP a través de esta página de configuración.
  </Accordion>
</AccordionGroup>

<Tip>
  ¿Aún necesitas ayuda? Únete a nuestro [**Discord**](https://discord.com/invite/ThpYPZpVts) y obtén soporte en tiempo real del equipo y la comunidad de Base44.
</Tip>

<Note>Esta página se tradujo con IA. Para información más precisa y actualizada, consulta la [versión en inglés](/). </Note>