curl -s -X POST "https://accounts.zoho.com/oauth/v2/token" \
     -d "code=YOUR_GRANT_CODE" \
     -d "client_id=YOUR_CLIENT_ID" \
     -d "client_secret=YOUR_CLIENT_SECRET" \
     -d "grant_type=authorization_code" | jq
   

Zoho Mail 技能

直接从 Clawdbot 读取、搜索和管理 Zoho Mail。

设置

1. 1. 前往 Zoho API 控制台 并创建一个 自客户端
2. 记下 客户端 ID 和 客户端密钥
3. 使用以下作用域生成授权码：ZohoMail.messages.READ,ZohoMail.folders.READ,ZohoMail.accounts.READ
4. 将授权码兑换为刷新令牌：

bash curl -s -X POST https://accounts.zoho.com/oauth/v2/token \ -d code=YOURGRANTCODE \ -d clientid=YOURCLIENT_ID \ -d clientsecret=YOURCLIENT_SECRET \ -d granttype=authorizationcode | jq

1. 5. 设置环境变量：

bash export ZOHOCLIENTID=your-client-id export ZOHOCLIENTSECRET=your-client-secret export ZOHOREFRESHTOKEN=your-refresh-token

认证

Zoho 使用 OAuth 2.0。访问令牌在 1 小时后过期，因此在调用 API 前务必刷新。除非被撤销，刷新令牌不会过期。

获取访问令牌

bash ZOHOACCESSTOKEN=$(curl -s -X POST https://accounts.zoho.com/oauth/v2/token \ -d refreshtoken=$ZOHOREFRESH_TOKEN \ -d clientid=$ZOHOCLIENT_ID \ -d clientsecret=$ZOHOCLIENT_SECRET \ -d granttype=refreshtoken | jq -r .access_token)

重要提示： 在每次 API 会话前或收到 401 错误时运行此命令。以下所有命令均假定已设置 $ZOHOACCESSTOKEN。

使用方法

所有命令均使用带有 Zoho-oauthtoken 授权头的 curl。注意：Zoho 使用 Zoho-oauthtoken 前缀，而非 Bearer。

获取账户 ID

bash curl -s https://mail.zoho.com/api/accounts \ -H Authorization: Zoho-oauthtoken $ZOHOACCESSTOKEN | jq .data[0] | {accountId, mailboxAddress, firstName, lastName}

为后续调用存储账户 ID：
bash
ZOHOACCOUNTID=$(curl -s https://mail.zoho.com/api/accounts \
-H Authorization: Zoho-oauthtoken $ZOHOACCESSTOKEN | jq -r .data[0].accountId)

列出文件夹

bash curl -s https://mail.zoho.com/api/accounts/$ZOHOACCOUNTID/folders \ -H Authorization: Zoho-oauthtoken $ZOHOACCESSTOKEN | jq .data[] | {folderName, folderId, unreadCount, messageCount}

获取收件箱文件夹 ID

bash INBOXID=$(curl -s https://mail.zoho.com/api/accounts/$ZOHOACCOUNT_ID/folders \ -H Authorization: Zoho-oauthtoken $ZOHOACCESSTOKEN | jq -r .data[] | select(.folderName==Inbox) | .folderId)

列出收件箱邮件

bash curl -s https://mail.zoho.com/api/accounts/$ZOHOACCOUNTID/messages/view?folderId=$INBOX_ID&limit=10&start=0 \ -H Authorization: Zoho-oauthtoken $ZOHOACCESSTOKEN | jq .data[] | {subject, sender, fromAddress, receivedTime, messageId, status2}

列出特定文件夹中的邮件

bash curl -s https://mail.zoho.com/api/accounts/$ZOHOACCOUNTID/messages/view?folderId={folderId}&limit=10&start=0 \ -H Authorization: Zoho-oauthtoken $ZOHOACCESSTOKEN | jq .data[] | {subject, sender, receivedTime, messageId}

读取特定邮件

bash curl -s https://mail.zoho.com/api/accounts/$ZOHOACCOUNTID/messages/{messageId} \ -H Authorization: Zoho-oauthtoken $ZOHOACCESSTOKEN | jq .data | {subject, sender, fromAddress, toAddress, ccAddress, receivedTime, content}

仅获取邮件正文内容

bash curl -s https://mail.zoho.com/api/accounts/$ZOHOACCOUNTID/messages/{messageId}/content \ -H Authorization: Zoho-oauthtoken $ZOHOACCESSTOKEN | jq -r .data.content

搜索邮件

bash curl -s https://mail.zoho.com/api/accounts/$ZOHOACCOUNTID/messages/search?searchKey={query}&limit=10 \ -H Authorization: Zoho-oauthtoken $ZOHOACCESSTOKEN | jq .data[] | {subject, sender, receivedTime, messageId, summary}

搜索语法支持：

• - 简单文本：searchKey=invoice
• 发件人筛选：searchKey=from:john@example.com
• 主题筛选：searchKey=subject:quarterly report
• 日期范围：searchKey=after:2024-01-01 before:2024-06-30
• 组合：searchKey=from:boss@company.com subject:meeting

列出邮件线程

bash curl -s https://mail.zoho.com/api/accounts/$ZOHOACCOUNTID/threads/view?folderId=$INBOX_ID&limit=10&start=0 \ -H Authorization: Zoho-oauthtoken $ZOHOACCESSTOKEN | jq .data[] | {subject, threadId, messageCount}

获取线程详情（线程中的所有邮件）

bash curl -s https://mail.zoho.com/api/accounts/$ZOHOACCOUNTID/threads/{threadId} \ -H Authorization: Zoho-oauthtoken $ZOHOACCESSTOKEN | jq

列出标签

bash curl -s https://mail.zoho.com/api/accounts/$ZOHOACCOUNTID/tags \ -H Authorization: Zoho-oauthtoken $ZOHOACCESSTOKEN | jq .data[] | {tagName, tagId, color}

列出邮件附件

bash curl -s https://mail.zoho.com/api/accounts/$ZOHOACCOUNTID/folders/{folderId}/messages/{messageId}/attachments \ -H Authorization: Zoho-oauthtoken $ZOHOACCESSTOKEN | jq .data[] | {attachmentName, attachmentId, fileSize}

获取账户信息

bash curl -s https://mail.zoho.com/api/accounts/$ZOHOACCOUNTID \ -H Authorization: Zoho-oauthtoken $ZOHOACCESSTOKEN | jq .data | {firstName, lastName, mailboxAddress, usedStorage, planStorage}

区域端点

如果您的 Zoho 账户不在美国区域，请将 mail.zoho.com 和 accounts.zoho.com 替换为：

区域	邮件 API	认证
美国	mail.zoho.com	accounts.zoho.com
欧洲

mail.zoho.eu | accounts.zoho.eu |
| 印度 | mail.zoho.in | accounts.zoho.in |
| 澳大利亚 | mail.zoho.com.au | accounts.zoho.com.au |
| 日本 | mail.zoho.jp | accounts.zoho.jp |
| 加拿大 | mail.zohocloud.ca | accounts.zohocloud.ca |

注意事项

• - 访问令牌在 1 小时 后过期 — 每次会话前请刷新
• 除非被撤销，刷新令牌 不会 过期
• 速率限制：每个账户 每分钟 30 次 API 请求
• receivedTime 是自纪元以来的毫秒数 — 使用以下命令转换：date -d @$((receivedTime/1000))
• status2 字段：0 = 未读，1 = 已读
• 认证头使用 Zoho-oauthtoken 前缀，而非 Bearer

-