API de Gmail: qué se puede hacer y cómo usarla con agentes de IA
La API de Gmail da acceso programático a los buzones de correo de Gmail y de Google Workspace: mensajes, conversaciones, etiquetas y borradores. La usan las empresas que quieren automatizar la clasificación, las respuestas y el registro de correos en otros sistemas. El acceso es por OAuth 2.0 con un proyecto de Google Cloud.
Qué ofrece la API de Gmail
Mensajes y conversaciones
Lectura, búsqueda con la misma sintaxis de Gmail, envío y movimiento de correos y de hilos.
Borradores
Creación y edición de borradores que se pueden revisar antes del envío.
Etiquetas
Creación y aplicación de etiquetas para organizar el buzón.
Adjuntos
Descarga y envío de archivos adjuntos.
Notificaciones push
Avisos de cambios en el buzón mediante Google Cloud Pub/Sub.
Configuración
Filtros, respuestas automáticas, reenvío y firmas.
Cómo acceder a la API de Gmail
- Con las credenciales de tu empresaOAuth 2.0 con un proyecto de Google Cloud y scopes de Gmail; en las cuentas de Workspace, el administrador puede autorizar una cuenta de servicio con delegación de dominio.
- Google clasifica los scopes amplios de Gmail como restringidos y pueden exigir la verificación de la app.
- Hay cuotas de uso por usuario y por proyecto.
- Los correos contienen datos personales y confidenciales: limita a qué buzones accede el agente.
Documentación oficial: developers.google.com/gmail/api
Qué hace un agente de iTeam con la API de Gmail
Clasificación del buzón comercial
El agente lee los correos de contacto@, los clasifica por asunto, crea el lead en el CRM y prepara un borrador de respuesta para que lo revise el vendedor.
Facturas y recibos de proveedores
Los adjuntos de facturas y recibos se identifican, se guardan en la carpeta correcta y se registran como cuenta por pagar para su revisión.
Seguimiento que no se olvida
El agente sigue las propuestas enviadas y, sin respuesta tras el plazo acordado, sugiere un seguimiento con el tono de la empresa.
Resumen del buzón para dirección
Los directivos reciben un resumen diario de los correos que piden una decisión, separados del resto.
De la credencial al agente trabajando, con aprobación
Crea el proyecto en Google Cloud
Activa la API de Gmail, configura la pantalla de consentimiento y elige los scopes mínimos, como lectura y borradores.
Autoriza los buzones en iTeam
Cada buzón se autoriza por OAuth o por delegación del administrador; el token queda en la bóveda y tú defines qué puede hacer cada agente.
Empieza con borradores
Al principio el agente solo crea borradores y etiquetas; el envío directo se habilita después para mensajes de bajo riesgo.
Equipos de IA listos que usan Gmail
Prospección comercial B2B
Romeo arma la lista y la investiga, Dai escribe un primer mensaje pensado para esa empresa y tu vendedor decide qué sale.
Cuentas por pagar
Darwin lee cada factura que llega a Gmail, la registra y la deja lista para pagar; tú solo apruebas.
Cobranza y cuentas por cobrar
Darwin sabe quién debe y desde cuándo, Jaca escribe con tacto por WhatsApp o correo y Henry cuida que cada mensaje sea correcto.
Contabilidad del día a día
Darwin clasifica cada documento y propone el asiento, Nina persigue lo que falta y el contador dedica su tiempo a revisar y asesorar.
Reclutamiento y selección
Bia lee cada CV con los requisitos de la vacante, explica por qué recomienda a cada candidato y agenda la entrevista; la decisión la toma tu equipo.
Compras y cotizaciones
Darwin pide cotizaciones y las compara en una tabla, Henry revisa las condiciones y la orden de compra sale con la aprobación registrada.
Preguntas sobre la API de Gmail
¿La API de Gmail es gratuita?
Sí, en general el uso de la API no se cobra dentro de las cuotas de Google; el coste es la propia cuenta de Gmail o de Workspace.
¿Necesito programar para usar la API de Gmail con iTeam?
No. iTeam ya se conecta a Gmail y el equipo de implantación te ayuda con el proyecto de Google Cloud y las autorizaciones.
¿El agente envía correos en mi nombre sin que yo los vea?
Solo si tú lo habilitas. Por defecto, el agente prepara borradores y los envía después de tu aprobación.
