# Conectar Gmail

Conectar una cuenta de Gmail permite que el agente envíe y reciba correos directamente desde esa cuenta, usando la API de Google. No se usan contraseñas: el acceso es seguro mediante OAuth 2.0.

***

## Requisitos

* Una cuenta de Gmail o Google Workspace activa.
* Sesión iniciada en el panel de Anunzi.

***

## Paso a paso

1. Abre la **ficha del agente** de email que quieres conectar.
2. En la sección **Conexión**, selecciona la pestaña **Gmail**.
3. Haz clic en **Conectar con Google**.
4. Se abre la ventana de autorización de Google — selecciona la cuenta de Gmail que quieres usar.
5. Acepta los permisos solicitados (leer y enviar correos).
6. La ventana se cierra y vuelves a la ficha del agente, donde verás la confirmación: **"Gmail conectado"** con el correo vinculado.

> ⚠️ Si el panel está dentro de un iframe, la ventana de Google se abre en la pestaña principal del navegador para evitar bloqueos de seguridad. Es el comportamiento esperado.

***

## Permisos solicitados

Al conectar Gmail, Anunzi solicita acceso para:

| Permiso | Para qué se usa |
|---|---|
| **Leer correos** | Detectar respuestas de contactos a correos de campaña. |
| **Enviar correos** | Enviar correos de campaña y respuestas del agente. |
| **Modificar correos** | Marcar como leídos los mensajes ya procesados. |

Anunzi solo accede a los correos relacionados con campañas que el propio agente inició. No lee el resto de tu inbox.

***

## Cambiar la cuenta conectada

1. En la sección **Conexión → Gmail**, haz clic en **Cambiar**.
2. Sigue el mismo flujo de autorización con la nueva cuenta.
3. La cuenta anterior queda desvinculada y la nueva queda activa.

***

## Desconectar Gmail

1. En la sección **Conexión → Gmail**, haz clic en **Desconectar**.
2. Confirma la acción en el diálogo.
3. El acceso a la cuenta de Google queda revocado y el agente pierde la casilla.

> ⚠️ Si el agente tiene campañas activas al momento de desconectar, dejará de enviar y responder correos hasta que se conecte una nueva cuenta.

***

## Solución de problemas

| Problema | Solución |
|---|---|
| La ventana de Google no se abre | Verifica que el navegador no esté bloqueando ventanas emergentes del panel. |
| Error "acceso denegado" en Google | La cuenta puede tener restricciones del administrador de Google Workspace. Contacta a tu administrador. |
| El agente dice "sin token válido" | Desconecta y vuelve a conectar la cuenta para renovar los tokens. |
| El correo no llega desde Gmail | Verifica en la ficha que el agente esté activo y que la casilla figure como **Conectada**. |