Documentación
Agentes de Email.md

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