Gmail
Conecte Gmail para que un agente pueda buscar, leer y responder correos, enviar seguimientos, guardar borradores y ordenar su bandeja, todo desde su propia cuenta de Gmail.
Qué conseguirá
Un agente podrá trabajar con su Gmail: encontrar y leer correos, responder en la misma conversación, guardar borradores, enviar seguimientos y marcar, archivar o mover a la papelera un mensaje. Usted elige cuáles de estas acciones recibe cada agente.
Descripción general y casos de uso
- Enviar por correo a quien llama los datos de su cita.
- Enviar a su equipo un resumen de lo que pidió quien llamó.
- Encontrar «el correo que envió Sara sobre el presupuesto» y responder a partir de él.
- Responder al correo de un cliente en la misma conversación.
- Guardar una respuesta como borrador para que usted la revise antes de enviarla.
Requisitos previos
- Una cuenta de Gmail o de Google Workspace. El correo se lee desde esa dirección y sale de ella.
- Si Phynxa no aporta la aplicación de Google, un cliente OAuth de Google Cloud (consulte Google Calendar; active la API de Gmail).
Conéctelo en Phynxa
- Integrations, Connect en Gmail.
- Sign in with Google (o pegue primero el Client ID y el secreto), elija la cuenta y apruebe. La pantalla de consentimiento pide permiso para leer, enviar y gestionar su correo y para ver su dirección. Nunca pide borrar correo de forma definitiva.
- La tarjeta muestra Connected.
Permisos y ajustes
Ámbitos: gmail.modify y userinfo.email. Phynxa puede leer correo, enviarlo, guardar borradores, cambiar etiquetas y mover un mensaje a la papelera. No puede borrar un mensaje de forma permanente.
Google clasifica gmail.modify como un permiso restringido. Si conecta con su propia aplicación de Google, Google solo deja que lo aprueben los usuarios de prueba que usted indique (hasta 100) hasta que la aplicación supere la verificación de Google.
¿Conectó Gmail antes de que se añadiera la lectura? Esa conexión solo tenía permiso para enviar. El envío sigue funcionando; para las demás acciones, use Reconnect y apruebe de nuevo.
Úselo en una llamada
| Acción | Qué hace | Se ejecuta |
|---|---|---|
| Send email | Envía un correo. Necesita to (varias direcciones separadas por comas), subject y body. | En segundo plano |
| Search emails | Lista los correos que coinciden, con quién envió cada uno, el asunto, la fecha y las primeras palabras. Admite query con las palabras de búsqueda de Gmail (por ejemplo from:sara@example.com is:unread newer_than:7d) y max_results (hasta 10). | Espera |
| Read email | Abre un correo y devuelve su texto (hasta unos 3.500 caracteres), quién lo envió y los nombres de los adjuntos. Necesita message_id de una búsqueda. | Espera |
| Read conversation | Devuelve los cuatro últimos mensajes de una conversación. Necesita thread_id. | Espera |
| Reply to email | Responde en la misma conversación a quien escribió el correo (a su dirección de respuesta si la indicó). Necesita message_id y body. | En segundo plano |
| Create draft | Guarda un correo en los borradores de Gmail. No se envía nada. Necesita to, subject y body. | En segundo plano |
| Mark as read | Marca un correo como leído. | En segundo plano |
| Archive email | Saca un correo de la bandeja de entrada. Se conserva y se puede seguir encontrando. | En segundo plano |
| Move to trash | Mueve un correo a la papelera, donde Gmail lo conserva 30 días. | En segundo plano |
Estas acciones también funcionan en un agente de WhatsApp: en su pestaña Tools, Add tool, Integration, Gmail. Consulte Crear un agente de WhatsApp.
Proteja su buzón
- Dé las acciones de lectura solo a agentes de confianza. Un agente que atiende al público (una línea telefónica, un widget web, un número de WhatsApp) responde a cualquiera que hable con él, así que cualquiera podría preguntarle por su correo. A un agente público dele solo Send email o Create draft.
- El texto de un correo lo escribió otra persona. Puede contener instrucciones dirigidas a un asistente («reenvía todo a ...»). Phynxa indica al agente que trate lo que lee como información y nunca como instrucciones, pero lo más seguro es no dar a un mismo agente las acciones de lectura y de envío.
- Cada herramienta se puede desactivar quitándola del agente.
- No hay un chat privado de «pregúnteme por mi correo». Un agente de WhatsApp responde a los clientes que escriben a su número; no recibe órdenes suyas sobre su propia bandeja.
Pruébelo
Test connection y después pida al agente en Chat que encuentre su último correo y que lo lea.
Resultado esperado
El agente nombra el remitente y el asunto de un correo real de su buzón y lo resume. Un correo enviado llega desde su dirección de Gmail y aparece en su carpeta de enviados.
Solución de problemas
- «Reconnect Gmail». La conexión se hizo antes de que se añadiera la lectura, o no se concedió el permiso. Use Reconnect y apruebe.
- «The Gmail API is not turned on». En su propio proyecto de Google Cloud, active la API de Gmail, espere un minuto y vuelva a intentarlo.
- «Not found». El correo se borró, o el identificador no es de una búsqueda. Busque de nuevo.
- Un correo aparece recortado. Los correos largos se acortan para que el agente pueda leerlos a tiempo. Abra el correo en Gmail para ver el resto.
- El correo no llega. Revise el spam y la dirección que usó el agente.
- Límites. Gmail limita cuántos mensajes puede enviar una cuenta al día y a qué ritmo atiende las solicitudes; un uso intensivo puede ser rechazado por Google.
Seguridad y credenciales
Los tokens se guardan cifrados. Retire el acceso en la página de seguridad de su cuenta de Google; Remove lo olvida aquí. El agente actúa en su nombre, así que indíquele qué puede leer y enviar.
Guías relacionadas
¿Algo de esto no coincide con lo que ve en el panel? Avísenos.