> ## 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.

# Conectar Outlook a tu app

> Envía y lee correos y gestiona eventos del calendario desde tu app, con una cuenta compartida o con la cuenta propia de cada persona.

Conecta tu app a Outlook para enviar y leer correos, gestionar eventos del calendario y ejecutar flujos de trabajo cuando cambia un correo o un evento. Usa una cuenta compartida para toda tu app o deja que cada persona conecte su propia cuenta de Microsoft.

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

***

## Qué puedes hacer

Lleva tu correo y tu calendario de Outlook a los flujos de trabajo de tu app.

> [card] Enviar correos
>
> Envía correos desde tu cuenta de Outlook cuando pasa algo en tu app, como una nueva reserva.

> [card] Leer y organizar correos
>
> Lee los mensajes recientes, resúmelos y muévelos o actualízalos desde tu app.

> [card] Gestionar tu calendario
>
> Muestra tus eventos de Outlook en tu app y crea o actualiza eventos cuando se programa algo.

> [card] [Ejecutar flujos de trabajo](https://docs.base44.com/es/Building-your-app/Creating-workflows.md#connector)
>
> Inicia un flujo de trabajo cuando llega un correo a tu bandeja de entrada o se crea un evento del calendario. También cuando alguno de ellos se actualiza o se elimina.

**Prompts de ejemplo**

Describe en el chat de IA el buzón o el calendario, qué activa la acción y cualquier campo dinámico. Por ejemplo:

```text wrap theme={null}
Envía correos desde mi app con Outlook.
```

```text wrap theme={null}
Muestra los eventos de mi calendario de Outlook en el panel.
```

```text wrap theme={null}
Crea eventos de calendario en Outlook cuando se programe algo en mi app.
```

```text wrap theme={null}
Lee los correos recientes de Outlook y resúmelos.
```

> [!TIP]
>
> ¿Quieres que tu Superagent se una a tus reuniones de Outlook y tome notas? Consulta [Conectar tu calendario](https://docs.base44.com/es/superagents/meeting-notes.md#connecting-your-calendar).

***

## Conectar Outlook

Elige cómo se conectan las personas: una cuenta compartida para toda tu app o la cuenta propia de cada persona.

> [tab] Conector compartido
>
> Conecta una cuenta, y todas las personas que usan tu app la comparten junto con sus datos.
>
> **Para añadir un conector compartido de Outlook:**
>
> 1. Haz clic en **Conectores** en la barra lateral de tu espacio de trabajo.
>
> 2. Haz clic en **Agregar conector**.
>
> 3. Busca **Outlook** y haz clic en él.
>
> 4. Selecciona **Conector compartido** y luego haz clic en **Siguiente**.
>
> 5. Introduce un **Nombre de la conexión**.
>
> 6. En **Quién tiene acceso**, elige dónde se puede usar la conexión: **Apps y Super agente** (predeterminado), **Apps only** o **Super agent only**.
>
> 7. En **Permisos**, elige **Solo lectura** (predeterminado), **Lectura y escritura** o **Personalizado**. Para enviar correos, elige **Lectura y escritura**. Más información sobre [alcances y permisos](#scopes-and-permissions).
>
>    ![Configuración del conector compartido de Outlook con Connection name, Who can access y los permisos Read-only seleccionados](https://mintcdn.com/base44/dnY2McSyQ8BRavEs/images/apps-connectors-outlook-shared-setup.png?fit=max\&auto=format\&n=dnY2McSyQ8BRavEs\&q=85\&s=5638130e25a42638151162b63b297ef3)
>
>    Configurar un conector compartido de Outlook
>
> 8. Haz clic en **Agregar conector**.
>
> 9. Inicia sesión con la cuenta de Microsoft que quieres compartir.

> [tab] Conector para usuarios de la app
>
> Cada persona conecta su propia cuenta de Microsoft, así tu app puede trabajar con su correo y su calendario.
>
> > [!TIP]
> >
> > **Antes de empezar:** Solo los owners y admins del espacio de trabajo pueden configurarlo. Necesitas un registro de app de Microsoft con su Client ID y su Client Secret. Si no vas a introducir un [Microsoft Tenant ID](#using-a-microsoft-tenant), configura sus **Supported account types** para cuentas de cualquier directorio organizativo y cuentas personales de Microsoft. Consulta [Usar tu propio cliente OAuth](https://docs.base44.com/es/Integrations/Connectors.md#using-your-own-oauth-client).
>
> **Para añadir un conector de Outlook para usuarios de la app:**
>
> 1. Haz clic en **Conectores** en la barra lateral de tu espacio de trabajo.
>
> 2. Haz clic en **Agregar conector**.
>
> 3. Busca **Outlook** y haz clic en él.
>
> 4. Selecciona **Conector de usuario de la app** y luego haz clic en **Siguiente**.
>
> 5. Copia la **Callback URL**.
>
> 6. En el registro de tu app de Microsoft, añade la Callback URL a los URI de redirección permitidos.
>
> 7. De vuelta en el formulario **Add Outlook Connection**, introduce un **Nombre del conector**, el **ID de cliente** y el **Secreto del cliente**.
>
>    ![Formulario Add Outlook Connection con Callback URL, Connector name, Client ID y Client Secret](https://mintcdn.com/base44/dnY2McSyQ8BRavEs/images/apps-connectors-outlook-app-user-credentials.png?fit=max\&auto=format\&n=dnY2McSyQ8BRavEs\&q=85\&s=5fb6f375d00995fabb114eb4e9dd463c)
>
>    Introducir las credenciales de tu app de Microsoft
>
> 8. (Opcional) Revisa los alcances preseleccionados en **Scopes** y quita los que tu app no necesite.
>
>    ![Campo Scopes de Outlook con alcances bloqueados y predeterminados, y Additional scopes debajo](https://mintcdn.com/base44/dnY2McSyQ8BRavEs/images/apps-connectors-outlook-app-user-scopes.png?fit=max\&auto=format\&n=dnY2McSyQ8BRavEs\&q=85\&s=2d9c8f72c63f63496b4f8f45aae8daf4)
>
>    Elegir los alcances de un conector para usuarios de la app
>
> 9. Haz clic en **Agregar conector**.
>
> Después, pide al chat de IA de tu app que añada una forma de que las personas conecten su propia cuenta de Outlook.

***

## Alcances y permisos

Los alcances controlan lo que tu app puede hacer en Outlook. Los eliges al configurar un conector.

> [card]
>
> **1. Base44 añade**
>
> Siempre se incluyen, así que aparecen como alcances bloqueados en **Personalizado** para un conector compartido o en **Scopes** para un conector para usuarios de la app.
>
> * `User.Read`: Inicia sesión y lee el perfil de la cuenta que se conecta
> * `offline_access`: Mantiene la conexión funcionando sin volver a iniciar sesión
>
> **2. Tú configuras**
>
> Selecciona los alcances que necesita tu app en **Personalizado** para un conector compartido o en **Scopes** para un conector para usuarios de la app.
>
> Para un conector compartido, **Solo lectura** da a tu app `Mail.Read` y `Calendars.Read`. **Lectura y escritura** le da `Mail.ReadWrite`, `Calendars.ReadWrite` y `Mail.Send`.
>
> * `Mail.Read`: Lee correos
> * `Mail.ReadWrite`: Lee, crea, actualiza y elimina correos, sin enviarlos
> * `Mail.Send`: Envía correos como la cuenta
> * `Calendars.Read`: Lee eventos del calendario
> * `Calendars.ReadWrite`: Lee, crea, actualiza y elimina eventos del calendario
>
> **Acceso:** Tu app trabaja con el buzón y el calendario de la cuenta de Microsoft que autoriza la conexión.

### Usar un tenant de Microsoft

En un conector para usuarios de la app, puedes introducir un **Microsoft Tenant ID** en el formulario de configuración, en Connection Configuration. Déjalo vacío para usar `common`. Si introduces uno, la configuración de tipos de cuenta admitidos del registro de tu app de Microsoft no se aplica.

***

## Usar funciones de backend

Una vez conectado Outlook, tus funciones de backend pueden obtener un token de acceso y llamar directamente a la API de Microsoft Graph. Base44 gestiona el inicio de sesión y mantiene el token actualizado por ti.

* Para una conexión compartida, usa `getConnection()` para obtener el token.
* Para una conexión de usuario de la app, usa `getCurrentAppUserConnection()` para que cada solicitud use el token de la persona que inició sesión.

Llama a la API de Microsoft Graph en `graph.microsoft.com` y pasa el token en el encabezado `Authorization`:

```javascript theme={null}
// Shared connection: one account the whole app uses
const { accessToken } = await base44.asServiceRole.connectors.getConnection("outlook");

const response = await fetch(
  "https://graph.microsoft.com/v1.0/me/messages?$top=10",
  { headers: { Authorization: `Bearer ${accessToken}` } },
);
const { value: messages } = await response.json();
```

> [card] [Conectores compartidos](https://docs.base44.com/es/developers/backend/resources/connectors/shared-connectors.md)
>
> Configura, despliega y llama a una conexión compartida desde una función de backend.

> [card] [Conectores para usuarios de la app](https://docs.base44.com/es/developers/backend/resources/connectors/app-user-connectors.md)
>
> Obtén un token por usuario y llama a la API como la persona que inició sesión.

***

## Solución de problemas

Revisa la conexión y sus alcances si Outlook deja de funcionar en tu app.

> [accordion] Hay que reconectar la conexión
>
> Si el acceso a Outlook se pierde o caduca, la conexión muestra **Es necesario volver a conectar esta conexión**. Para un conector compartido, [reconéctala](https://docs.base44.com/es/Integrations/Connectors.md#managing-your-connectors) e inicia sesión con la misma cuenta de Microsoft. Todas las apps que la usan vuelven a funcionar. Para un conector para usuarios de la app, cada persona reconecta su propia cuenta desde dentro de tu app.

> [accordion] Tu app no puede enviar correos
>
> Tu app necesita el alcance `Mail.Send` para enviar correos. El alcance `Mail.ReadWrite` permite que tu app lea y cambie mensajes, pero no que los envíe.
>
> * Para un conector compartido, los permisos se fijan al añadir la conexión. Haz clic en **Add another connector** en la página del conector de Outlook y elige **Lectura y escritura** para la nueva conexión.
> * Para un conector para usuarios de la app, ábrelo en la página del conector de Outlook, añade `Mail.Send` a sus alcances y haz clic en **Guardar cambios**. Las personas que ya se conectaron mantienen su acceso anterior hasta que vuelvan a conectarse.

> [!NOTE]
>
> Esta página fue traducida usando IA. Para obtener la información más precisa y actualizada, consulta la [versión en inglés](https://docs.base44.com/index.md).


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.