Recibir
Etiquetas y categorías
Archive automáticamente el correo enviado y recibido en etiquetas, y dé a un agente una categoría de la que sus conversaciones nunca salen.
Etiquetas
Una etiqueta funciona como una carpeta de Gmail. Un mensaje puede llevar hasta 10 etiquetas y un espacio de trabajo puede tener 200. Cree una con POST /labels, lístelas con sus recuentos de mensajes y de no leídos con GET /labels, y lea una con GET /emails?label=Billing. Las etiquetas se pueden referenciar en todas partes por nombre o por ID lbl_.
Enviar a una etiqueta
{
"from": "Orders <orders@example.com>",
"to": [
"customer@example.net"
],
"subject": "Order 1042",
"text": "Reply with a delivery window.",
"labels": [
"Agent/Orders"
]
}Los nombres de etiqueta desconocidos se crean. Todos los mensajes posteriores de la conversación, incluidas las respuestas del cliente, heredan las etiquetas de la conversación.
Categorías
Cree una etiqueta con "skip_inbox": true para convertirla en una categoría. El correo recibido que obtiene una etiqueta de categoría, ya sea por una regla de archivado, por una respuesta a una conversación etiquetada o mediante POST /emails/:id/labels, se archiva para que aparezca solo en la etiqueta y nunca en la bandeja de entrada. El correo enviado nunca aparece en la bandeja de entrada. En conjunto, las conversaciones de tareas de un agente quedan en un solo lugar en ambas direcciones.
{
"name": "Agent/Orders",
"skip_inbox": true,
"rules": [
{
"inbox_id": "inb_…"
}
],
"apply_to_existing": true
}Reglas de archivado
Las reglas archivan automáticamente el correo nuevo. Todas las condiciones definidas en una regla deben coincidir: inbox_id (la dirección de recepción), direction (in u out) y subcadenas, sin distinguir mayúsculas y minúsculas, de from, to (To y Cc) y subject. El skip_inbox propio de una regla archiva solo el correo recibido que coincide con ella. Agregue reglas con POST /labels/:id/rules; apply_to_existing archiva también el correo conservado.
Trabajar una categoría
Consulte periódicamente GET /emails?label=Agent%2FOrders&direction=in&unread=true, lea la conversación con GET /threads/:id, responda con reply_to_email_id y después márquela como atendida con PATCH /emails/:id {"read": true}. Mueva un mensaje hacia dentro o fuera con POST /emails/:id/labels {"add": [...], "remove": [...]}. El servidor MCP expone las mismas operaciones como create_label, create_label_rule, label_email y list_emails.