Herramientas de correo

Un buzón conectado es también una familia de herramientas para el agente, leer, buscar, abrir, enviar, responder, marcar y mover correo. Todas owner-only, y distintas del correo como canal.

El buzón que conectas como canal Email tiene doble superficie: además de responder al correo entrante, pone a disposición de tu agente una familia de herramientas, leer la bandeja de entrada, buscar, abrir un mensaje, enviar, responder en el hilo, marcar como leído/no leído y mover mensajes. Cada una de estas herramientas es owner-only. Esto es lo que un agente interno puede hacer con un buzón usado como herramientas.

Conectar

No hay un paso de conexión aparte para las herramientas de correo, conectar el canal Email es lo que las activa. La misma fila del buzón alimenta ambas superficies.

Conecta un buzón en Canales → Agregar canal → Email, acceso con Gmail, o IMAP/SMTP para cualquier otro proveedor. Los pasos completos están en la página del canal Email.
Adjunta esa conexión a un agente interno, el Dashboard o BotFather. Las herramientas de correo solo aparecen para las llamadas internas.
Habla con el agente. Pídele que revise la bandeja de entrada, busque un remitente o redacte una respuesta.

El detalle que lo habilita: estas herramientas son owner-only, solo funcionan en superficies internas y nunca para un visitante del sitio web, porque un buzón contiene correo privado. Un agente de web chat público no las verá ni siquiera después de conectarlas. Y la opción Solo lectura del canal es el interruptor de encendido/apagado de la mitad de escritura: actívala y enviar, responder, marcar y mover desaparecen, dejando solo las herramientas de lectura.

Qué puede hacer el agente

Herramienta	Acceso	Tipo	Qué hace
`email_list_accounts`	Solo propietario	Read	Enumera los buzones conectados a este agente con su dirección, proveedor y estado, llámala primero cuando haya más de uno conectado para obtener el uid de la cuenta.
`email_read_inbox`	Solo propietario	Read	Enumera los mensajes recientes de una carpeta (INBOX por defecto) con asunto, remitente, fecha y estado de lectura.
`email_search`	Solo propietario	Read	Busca en una carpeta por palabra clave en el asunto, el remitente y el cuerpo; devuelve los mensajes coincidentes.
`email_get_message`	Solo propietario	Read	Abre un mensaje por su id, asunto completo, de/para/cc, fecha y texto del cuerpo.
`email_send`	Solo propietario	Write	Envía un correo nuevo (texto plano o HTML) con CC y BCC opcionales, desde la dirección conectada.
`email_reply`	Solo propietario	Write	Responde a un mensaje en el hilo, establece los encabezados de hilo y antepone 'Re:' al asunto.
`email_mark_read`	Solo propietario	Write	Marca un mensaje como leído o no leído.
`email_move`	Solo propietario	Write	Mueve un mensaje a otra carpeta o etiqueta, Papelera, Archivo y similares.

Owner-only, y la separación lectura/escritura

Ninguna de estas es segura para uso público. Las ocho están restringidas a una llamada interna más la presencia del complemento de correo, y cada llamada se marca como sensible para que permanezca oculta del flujo del chat. Dentro de eso, hay dos niveles: las cuatro herramientas de lectura (enumerar cuentas, leer la bandeja de entrada, buscar, abrir mensaje) y las cuatro herramientas de escritura (enviar, responder, marcar como leído, mover). El interruptor Solo lectura del canal elimina las cuatro de escritura, un buzón de solo lectura permite al agente clasificar y citar el correo pero nunca actuar sobre él.

Ejemplo práctico

Le dices a tu agente de soporte interno: «Revisa mi bandeja de entrada en busca de cualquier cosa de Acme esta semana y, si preguntaron por la factura, responde que va en camino.» El agente ejecuta email_search para Acme, email_get_message para leer el hilo y luego email_reply para responder en el hilo con tu nombre de remitente y tu firma, un solo ida y vuelta, sin cambiar de contexto a tu cliente de correo.

Límites y honestidad

Las escrituras son envíos reales. email_send y email_reply entregan a destinatarios reales desde tu dirección real. Prueba primero en un agente interno.
Solo lectura es la protección. Con la opción Solo lectura del canal activada, las herramientas de escritura quedan completamente ocultas, el agente puede leer pero nunca enviar, marcar ni mover.
Los id son opacos y dependen del proveedor. El id de un mensaje es un número para los buzones IMAP y una cadena para Gmail, devuelve siempre exactamente lo que email_read_inbox o email_search te devolvieron; no adivines.
Elige el buzón cuando hay más de uno. Con varios buzones conectados, llama primero a email_list_accounts y pasa el account_uid; con un solo buzón se elige por ti.

Solución de problemas

El agente no ve las herramientas de correo, probablemente estás en un agente público/de web chat. La familia es owner-only; adjunta el buzón a un agente interno.
Las lecturas funcionan, el envío se rechaza, el buzón está en modo Solo lectura, o (en IMAP) la mitad SMTP no logró autenticarse. Revisa ambas.
"No email accounts connected", el buzón no está adjunto a este agente, o la conexión dio error. Vuelve a conectar desde Canales.

Preguntas frecuentes

¿Es diferente del canal Email? Misma conexión, segunda superficie. El canal responde al correo entrante; las herramientas permiten a un agente interno leer y actuar sobre todo el buzón.

¿Un visitante del sitio web puede leer mi bandeja de entrada? Nunca, las ocho herramientas son owner-only y permanecen desactivadas en los agentes de cara al cliente.

¿Puedo conectar más de un buzón? Sí, cada uno tiene su propio account_uid; enumera primero las cuentas y luego apunta a una.

Siguientes pasos

Canal Email, la otra mitad: el correo entrante como conversaciones
Google Workspace, Drive, Docs, Calendar y Gmail
Habilidades del agente, cómo se adjuntan las herramientas a un agente
Panorama de las integraciones

Herramientas de correo

En esta página