Comunicación
Conectar Gmail a un agente de IA autónomo
Gmail concentra los intercambios con clientes y los internos. Un agente de Atako puede clasificar, preparar borradores y limpiar una bandeja, sin ver jamás su contraseña de Google.
Próximamente — crea tu cuenta y te avisaremos en cuanto esta integración esté lista.
Flujos de trabajo posibles
Triaje y borradores de respuesta para la bandeja de soporte compartida
Una bandeja support@ recibe decenas de mensajes al día. El agente lista los mensajes no leídos con list_messages, los clasifica por label con add_label_to_message (facturación, error, pregunta general), y luego redacta una respuesta en borrador con create_draft para cada solicitud clara. Una persona la revisa y la envía con send_draft. El agente solo usa send_email si se le ha concedido ese grant preciso.
Limpieza periódica de la bandeja
Newsletters, notificaciones automáticas, acuses de recibo: el agente busca esos mensajes con search_messages (por ejemplo from:noreply), comprueba su label con list_labels y luego los envía a la papelera con trash_message en lugar de dejarlos acumularse en la bandeja principal. La bandeja se mantiene legible sin que una persona dedique diez minutos cada mañana a ese triaje manual repetitivo, semana tras semana.
Seguimiento de los hilos de clientes que hay que retomar
El agente busca los hilos sin respuesta desde hace más de tres días con search_messages, obtiene el contexto completo con get_thread, los etiqueta con add_label_to_message y luego prepara un borrador de seguimiento con create_draft. Nada sale sin validación humana: el agente se limita a preparar el terreno para que el mensaje de seguimiento salga ese mismo día, sin esperar a que alguien del equipo comercial se acuerde por su cuenta.
Acciones del conector
list_messages
Lectura. Listar los identificadores de mensajes, filtrables por label.
search_messages
Lectura. Buscar mensajes con una consulta de Gmail.
get_message
Lectura. Obtener un mensaje completo, encabezados y cuerpo incluidos.
get_thread
Lectura. Obtener un hilo de conversación entero.
list_drafts
Lectura. Listar los borradores existentes.
create_draft
Escritura. Crear un borrador de respuesta sin enviarlo.
send_draft
Escritura. Enviar un borrador existente.
send_email
Escritura. Enviar directamente un correo desde la cuenta conectada.
add_label_to_message
Escritura. Añadir un label a un mensaje.
trash_message
Escritura. Enviar un mensaje a la papelera.
Requisitos previos
- Rol de administrador en la empresa Atako para conectar la integración.
- Cuenta de Gmail o Google Workspace cuya bandeja se va a conectar.
- Consentimiento OAuth de Google, scope https://www.googleapis.com/auth/gmail.modify.
- Un grant explícito por agente, en particular para la acción send_email.
Cómo conectar
- 1
Abrir Ajustes → Integraciones
Un administrador elige Gmail en la lista de conectores disponibles.
- 2
Comprobar las acciones expuestas
La ventana muestra todas las acciones de lectura y escritura, send_email incluida, antes de autorizar.
- 3
Autenticarse mediante la pantalla de Google
Redirección al consentimiento de Google, ninguna contraseña se transmite a Atako.
- 4
Conceder el acceso a un agente
Se eligen las acciones precisas por agente, por ejemplo solo create_draft para mantenerse prudente.
Por qué conectar un agente autónomo a Gmail
Gmail concentra los intercambios con clientes, proveedores y el equipo. Un agente autónomo conectado a él no se limita a responder a una orden puntual: funciona de forma continua y decide, según la instrucción recibida, buscar un mensaje, clasificarlo o preparar una respuesta, gracias al tool calling.
La conexión usa OAuth 2.0, scope https://www.googleapis.com/auth/gmail.modify (scopes de Gmail de Google). Este scope permite leer, redactar y enviar, pero no eliminar un mensaje de forma inmediata y permanente.
Esto es lo que hace útil un flujo como el triaje de la bandeja de soporte, cercano a lo que hace un agente de triaje de soporte o de automatización del soporte: recibe cada mensaje nuevo y prepara una respuesta sin esperar a que una persona abra una conversación de chat. Gmail forma parte de las integraciones cubiertas por el plan Standard, sin una línea de facturación separada por conector.
Límites y buenas prácticas
La acción más sensible del conector es send_email: una vez concedida en alcance de escritura, el agente envía sin volver a pasar por usted. La práctica más segura consiste en conceder solo create_draft, el agente prepara, una persona revisa y desencadena el envío con send_draft.
El scope gmail.modify cubre toda la bandeja conectada, no una etiqueta o un label concreto. El límite real viene por tanto del grant: liste las acciones exactas que necesita el agente en lugar de conceder todo de golpe desde la conexión.
La documentación no menciona un límite de tasa propio del conector de Gmail. Cada llamada, enviada o rechazada, sigue siendo consultable en el registro de auditoría de la página del agente. Y como con cualquier cuenta OAuth, si el token expira o se revoca del lado de Google, la conexión pasa a estado de error hasta que se vuelva a conectar.
Casos de uso relacionados
Integraciones complementarias
Preguntas frecuentes
¿Puede el agente enviar un correo en mi lugar sin validación?
Sí, si el grant incluye send_email en alcance de escritura, el agente envía entonces directamente. La mayoría de las empresas prefieren conceder solo create_draft: el agente prepara la respuesta, una persona la revisa y la envía con send_draft.
¿Hace falta un plan de pago para conectar Gmail?
Sí, se necesita un plan de Atako activo, pero Gmail forma parte de todas las integraciones ya incluidas en el plan Standard, sin coste adicional por conector.
¿Cómo se revoca el acceso de Atako a mi bandeja de Gmail?
Desde Ajustes → Integraciones, haga clic en Revoke sobre la conexión de Gmail. El token cifrado se elimina de inmediato, y todos los agentes que lo usaban pierden el acceso al instante.
¿El scope gmail.modify permite eliminar correos de forma definitiva?
No, ese scope permite leer, redactar, enviar y enviar a la papelera, pero no eliminar un mensaje de forma inmediata y permanente, eso requeriría un scope más amplio que el usado por el conector.
Qué leer a continuación
Fuentes
- Gmail API, scopes OAuth · consultado el 4 de septiembre de 2026
- Gmail API, guide d'envoi d'emails · consultado el 4 de septiembre de 2026
CTO de Atako
Este contenido fue redactado por los agentes de IA de Atako, y luego revisado, corregido y validado por Romain Laodicina, CTO de Atako.