Установка скиллов и плагинов OpenClaw осуществляется на ваш страх и риск. Все файлы были получены из открытых источников и предоставляются «как есть». Мы не гарантируем их корректную работу, безопасность или совместимость с вашей системой. Перед установкой настоятельно рекомендуется ознакомиться с содержимым кода и убедиться, что вы понимаете, какие изменения будут внесены в вашу систему.
Навык Zoho Mail предоставляет разработчикам удобный способ работать с почтой Zoho через REST API. С его помощью можно читать письма, выполнять поиск, управлять папками, цепочками сообщений, вложениями и метками — напрямую из агента или автоматизированного сценария. :
Обзор возможностей
Интеграция охватывает ключевые сценарии работы с почтой:
- чтение и просмотр писем;
- поиск сообщений по различным критериям;
- работа с папками и метками;
- доступ к цепочкам переписки;
- управление вложениями;
- получение информации об аккаунте.
Все операции выполняются через стандартные HTTP-запросы к Zoho Mail API с использованием OAuth-аутентификации. :
Быстрый старт
Перед началом работы необходимо получить access token через refresh token. Далее можно выполнить базовые операции.
Получение ID аккаунта
curl -s "https://mail.zoho.com/api/accounts" \
-H "Authorization: Zoho-oauthtoken $ZOHO_ACCESS_TOKEN"Список папок
curl -s "https://mail.zoho.com/api/accounts/$ZOHO_ACCOUNT_ID/folders" \
-H "Authorization: Zoho-oauthtoken $ZOHO_ACCESS_TOKEN"Получение писем из Inbox
curl -s "https://mail.zoho.com/api/accounts/$ZOHO_ACCOUNT_ID/messages/view?folderId=$INBOX_ID&limit=10" \
-H "Authorization: Zoho-oauthtoken $ZOHO_ACCESS_TOKEN"Эти базовые шаги позволяют быстро начать работу с почтовым ящиком и перейти к более сложным сценариям автоматизации. :
Работа с письмами
Навык поддерживает полный цикл взаимодействия с письмами:
- чтение конкретного письма по ID;
- получение только содержимого письма;
- просмотр списка сообщений в папке;
- получение вложений.
Также доступна работа с цепочками писем (threads), что удобно для анализа переписки и построения логики обработки сообщений.
Поиск писем
Поиск реализован через параметр searchKey и поддерживает гибкий синтаксис:
- простой текстовый поиск;
- фильтрация по отправителю (from:);
- поиск по теме письма (subject:);
- фильтрация по дате (after / before);
- комбинированные запросы.
Это позволяет быстро находить нужные письма даже в больших почтовых ящиках. :
Дополнительные возможности
- получение списка меток и тегов;
- работа с вложениями (просмотр, загрузка);
- получение информации об аккаунте (имя, email, хранилище);
- анализ статуса писем (прочитано/непрочитано).
Навык также поддерживает работу с различными регионами Zoho (EU, India, Japan и др.), что важно при использовании локализованных дата-центров.
Особенности и ограничения
- access token действует около 1 часа и требует обновления;
- refresh token не истекает, пока не отозван;
- лимит API — около 30 запросов в минуту;
- время получения письма возвращается в миллисекундах (epoch).
Для корректной работы важно учитывать ограничения API и правильно управлять токенами доступа. :
Заключение
Zoho Mail skill — это практичный инструмент для автоматизации работы с электронной почтой. Он подходит как для простых сценариев (чтение писем), так и для сложных задач: поиска, анализа переписки и интеграции с другими сервисами.
Благодаря REST API и OAuth-аутентификации, интеграция остается гибкой, безопасной и легко масштабируемой под любые задачи.
Файл из источника