# Gmail y Google Calendar

Conecte Gmail y Google Calendar para que una aplicación o un <Term id="agent">agente</Term> trabaje con sus correos y eventos.

- **Gmail** lee la bandeja de entrada con la que trabaja una aplicación, como pedidos, facturas o solicitudes de soporte, y envía respuestas o informes desde su propia dirección. El <Term id="knowledge-graph">grafo de conocimiento</Term> vincula cada correo con su cliente o pedido.
- **Google Calendar** lee sus eventos y encuentra tiempo libre: planifique según sus reuniones, encuentre un espacio libre o empiece el día con un breve resumen de lo que viene.

Ambos están en **Productividad** y la IA de su <Term id="studio">Studio</Term> los conecta con un inicio de sesión de Google.

## Antes de empezar [#antes-de-empezar]

- Un <Term id="project">proyecto</Term>. La IA de su Studio hace el trabajo. Consulte [Crear un proyecto](/docs/es/projects/create-a-project).
- La cuenta de Google cuyo correo o calendario debe usar la aplicación. Una dirección compartida (por ejemplo, una bandeja de pedidos) suele ser mejor que la de una persona.
- **Empiece con acceso de solo lectura y agregue el envío cuando lo necesite.**

## Conéctelo [#conéctelo]

<Steps>
<Step>
### Abra Gmail [#abra-gmail]
Vaya a <AppLink to="connectors" />, busque **Gmail** y ábralo.
</Step>
<Step>
### Envíe la solicitud a la IA de un proyecto [#envíe-la-solicitud-a-la-ia-de-un-proyecto]
En **Conéctelo con la IA de su Studio**, elija el **Proyecto** que usará Gmail. **Lo que se le pide a la IA** empieza con una solicitud para conectar Gmail a este proyecto para que pueda leer y enviar correos. Edítela para que diga exactamente lo que necesita, por ejemplo: "Lea los correos nuevos de la bandeja de pedidos cada 15 minutos y agregue cada pedido a la tabla pedidos. Todavía no envíe nada". Luego seleccione **Enviar a la IA**.

La IA empieza de inmediato si el Studio está abierto, o cuando se abra. Seleccione **Abrir Studio** para ir allí.

<Screenshot src="/docs/_media/connect-data-with-ai-in-dashboard-data-page.png" alt="Conectar Gmail con la IA de un proyecto desde la página de Conectores" />
</Step>
<Step>
### Termine la conexión [#termine-la-conexión]
La IA prepara la conexión y nunca le pide una clave en el chat. El borrador aparece como **Esperando su respuesta**. Seleccione **Conectar** para abrir el diálogo de conexión de Gmail.

Elija iniciar sesión con Google. El diálogo muestra el único sitio con el que se usa este inicio de sesión. Inicie sesión con la cuenta de Google que puede ver los archivos y apruebe el acceso que Google le pide. La conexión muestra luego la cuenta con la que inició sesión.
</Step>
<Step>
### Elija qué puede hacer la IA [#elija-qué-puede-hacer-la-ia]
En **Qué puede hacer la IA con ello**, elija **Puede leer** (nada cambia) o **Puede leer y modificar** (la IA también puede agregar, modificar y eliminar elementos). Luego seleccione **Conectar**.

<Screenshot src="/docs/_media/slack-connector-how-to-connect-in-ui.png" alt="El diálogo de conexión de Gmail con la elección de acceso" />
</Step>
<Step>
### Pruébela y avise a la IA [#pruébela-y-avise-a-la-ia]
El diálogo indica que Gmail está conectado. Seleccione **Probar** y luego **Avisar a la IA** para que continúe.
</Step>
</Steps>

También puede empezar desde un proyecto: en **Configuración**, **Claves**, descríbalo en **¿Qué quiere conectar?** y seleccione **Pedir a la IA que conecte**.

Para Google Calendar, abra **Google Calendar** y siga los mismos pasos. Por ejemplo: "Cada día hábil a las 8:00, lea los eventos de hoy en mi calendario y escriba un breve resumen."

<Callout type="warn" title="Enviar correos es un cambio">
  Leer correos solo necesita **Puede leer**. Enviar necesita **Puede leer y modificar**. Considere un agente con un paso que pregunte primero, para que una persona apruebe cada envío. Consulte [Ejecuciones y aprobaciones](/docs/es/agents/runs).
</Callout>

## Lo que obtiene [#lo-que-obtiene]

- **Correos como datos.** La IA puede convertir los correos en filas: remitente, asunto, fecha y los campos que le importan (un número de pedido, un valor). Esas filas llegan a una tabla de <Term id="nexus">Nexus</Term> que puede consultar en el <AppLink to="data.sql" />.
- **Vínculos en el grafo de conocimiento.** Una sola pregunta muestra un correo con su cliente o pedido. Consulte [Grafo de conocimiento](/docs/es/data/knowledge-graph).
- **Agentes que conocen su calendario.** Un agente puede leer eventos y tiempo libre antes de programar trabajo o escribir un resumen.

## Probar, pausar y reconectar [#probar-pausar-y-reconectar]

Las conexiones de un proyecto aparecen en su **Configuración**, en **Claves**, con su estado.

<Screenshot src="/docs/_media/manage-connections-by-toggle-on-off-per-project.png" alt="Las conexiones de un proyecto en Configuración, Claves" />

| Estado | Qué significa |
| --- | --- |
| **Esperando su respuesta** | La preparó la IA. Seleccione **Conectar** para terminarla. |
| **Funciona** | Conectada y lista para el proyecto. |
| **Requiere reconexión** | La clave o el inicio de sesión dejó de funcionar. Seleccione **Reconectar**. |
| **En pausa** | Nadie puede usarla hasta que seleccione **Reanudar**. |

Desde la misma fila: **Probar**, **Pausar**, **Desactivar aquí** (este proyecto deja de usarla) o **Quitar** (elimina la clave y todos los Studios que la usan dejan de acceder a Gmail o Google Calendar).

Una conexión pertenece al proyecto donde se creó. Propietarios y administradores las ven todas en **Sus conexiones**, en <AppLink to="connectors" />. Sigue desactivada para otros proyectos hasta que un administrador la active en la lista de proyectos que pueden usarla.

## Si la prueba falla [#si-la-prueba-falla]

**Probar** indica uno de estos resultados:

- Funciona: el proyecto llegó al servicio.
- La clave fue rechazada: seleccione **Reconectar** e ingrese una nueva.
- No se puede acceder al servicio: revise que esté disponible y acepte conexiones externas, y pruebe de nuevo.
- Internet está desactivado: el internet del proyecto está **Desactivado**. Actívelo en su **Configuración**. Con **Solo permitidos**, el Studio solo llega a sus conexiones y a los sitios que usted agregue.
- Aún no está conectada: seleccione **Conectar**.

Propios de Google:

- **Acceso limitado: no se concedieron algunos permisos.** Algunas acciones fallarán. Seleccione **Reconectar** y apruebe todo lo que el trabajo necesita.
- **La sesión terminó.** Un cambio de contraseña o un permiso vencido la cerró. Seleccione **Reconectar**.
- **El envío falla pero la lectura funciona.** La conexión solo tiene **Puede leer**, o el envío no se aprobó al iniciar sesión. Cámbiela a **Puede leer y modificar** y seleccione **Reconectar**.

## Use su propia aplicación de inicio de sesión [#use-su-propia-aplicación-de-inicio-de-sesión]

Si su organización solo permite iniciar sesión con una aplicación propia registrada, elija usar su propia aplicación en el diálogo de conexión. Registre una aplicación con el proveedor, agregue la dirección de retorno que muestra Klarety y luego pegue su id de cliente y su secreto de cliente, y guarde la aplicación. El secreto queda sellado y no se vuelve a mostrar.

## A dónde va su clave [#a-dónde-va-su-clave]

La clave o el inicio de sesión se cifra con un servicio de claves administrado en cuanto selecciona **Conectar**, y ni siquiera la IA puede leerlo. El Studio nunca tiene la clave. Si el único sitio al que se envía no es la dirección propia del servicio, Klarety se lo advierte y le pide escribir el sitio para confirmar.

## Siguientes pasos [#siguientes-pasos]

- [Qué hacen los agentes](/docs/es/agents)
- [Ejecuciones y aprobaciones](/docs/es/agents/runs)
- [Microsoft Teams y Outlook](/docs/es/connectors/teams-outlook)