Получение

Метки и группы

Автоматически раскладывайте отправленные и полученные письма по меткам и выделите агенту группу, из которой его переписка никуда не денется.

Метки

Метка работает как папка в Gmail. У письма может быть до 10 меток, а в рабочем пространстве — до 200. Создайте метку через POST /labels, получите список меток с количеством писем и непрочитанных через GET /labels, а письма с конкретной меткой — через GET /emails?label=Billing. Везде на метки можно ссылаться по имени или по ID вида lbl_.

Отправка с меткой

Тело POST /emails
{
  "from": "Orders <orders@example.com>",
  "to": [
    "customer@example.net"
  ],
  "subject": "Order 1042",
  "text": "Reply with a delivery window.",
  "labels": [
    "Agent/Orders"
  ]
}

Метки с неизвестными именами создаются автоматически. Все последующие письма в переписке, включая ответы клиента, наследуют метки этой переписки.

Группы

Создайте метку с "skip_inbox": true, чтобы сделать её группой. Полученные письма, получившие метку группы — по правилу сортировки, как ответ на переписку с этой меткой или через POST /emails/:id/labels, — архивируются и отображаются только в метке, но никогда во «Входящих». Отправленные письма во «Входящих» не отображаются никогда. В итоге рабочая переписка агента в обоих направлениях собрана в одном месте.

Тело POST /labels
{
  "name": "Agent/Orders",
  "skip_inbox": true,
  "rules": [
    {
      "inbox_id": "inb_…"
    }
  ],
  "apply_to_existing": true
}

Правила сортировки

Правила автоматически раскладывают новые письма. Должны совпасть все условия, заданные в правиле: inbox_id (адрес получения), direction (in или out) и подстроки без учёта регистра в from, to (To и Cc) и subject. Собственный параметр правила skip_inbox архивирует только те полученные письма, которые подходят под правило. Добавляйте правила через POST /labels/:id/rules; apply_to_existing раскладывает и уже сохранённые письма.

Работа с группой

Опрашивайте GET /emails?label=Agent%2FOrders&direction=in&unread=true, читайте переписку через GET /threads/:id, отвечайте с reply_to_email_id, а затем отмечайте письмо обработанным через PATCH /emails/:id {"read": true}. Чтобы переместить письмо в группу или из неё, используйте POST /emails/:id/labels {"add": [...], "remove": [...]}. MCP-сервер предоставляет те же операции: create_label, create_label_rule, label_email и list_emails.