查看邮件
目的
使用此API可获取单个电子邮件的详细信息,包括其内容,以及由任意受支持模块中的记录发送或接收的邮件。
端点
- GET /{module_api_name}/{record_id}/Emails/{message_id}
请求详情
请求 URL
{api_domain}/crm/{version}/{module_api_name}/{record_id}/Emails/{message-id}
支持的模块
潜在客户,Account,联系人,商机,报价,Invoices,Sales Orders,采购Orders,以及自定义
标题
授权:Zoho-oauthtoken d92d4xxxxxxxxxxxxx15f52
范围
ZohoCRM.modules.READ
或
ZohoCRM.modules.{module_name}.READ
并且
ZohoCRM.modules.emails.READ
可能的模块Name
线索、账户、联系人、交易、报价、发票、销售订单、采购订单和自定义
参数
- user_id整数,查看他人共享邮箱时必填。
您要获取其邮箱的用户ID。如果您获取的是自己的邮箱,该参数为可选项。
注意
当你获取特定邮件时,响应中的 content 键表示邮件正文。请注意,你只能在获取特定邮件时获取邮件正文,而不能获取记录中所有邮件的正文。
获取记录的特定电子邮件的示例请求
Copiedcurl "https://www.zohoapis.com/v8/Contacts/6821491000000566349/Emails/de735c09069d3022497a4379c012ccd7ee48d916546c214ee36206109afd4222?user_id=6821491000000565001"
-X GET
-H "Authorization: Zoho-oauthtoken 1000.8cb99dxxxxxxxxxxxxx9be93.9b8xxxxxxxxxxxxxxxf"可能的错误
- NO_PERMISSIONHTTP 400
- 权限被拒绝
用户没有查看该模块记录的权限。
解决方法:请联系管理员获取查看该模块记录的权限。 - 您的同事未为此记录相关的电子邮件提供查看权限。
用户没有权限查看该记录下此用户的电子邮件。
解决方法:电子邮件所属用户需通过公开或自定义共享设置,将邮件共享给当前查看邮件的用户。
- 权限被拒绝
- INVALID_DATAHTTP 400
所提供的相关ID似乎无效。
请求中提供的记录ID URL 无效。
解决方法: 提供一个有效的记录ID。 - CANNOT_PROCESSHTTP 400
- 此用户已被停用。管理员尚未启动备份。
解决方法: 联系管理员以启动Email备份。 - Customer的Email在CRM中暂时不可用。很抱歉给您带来不便。
解决方法: 检查并解决Email集成设置中的错误。 - 已配置的{0}邮箱可能已更改或被删除,无法访问。请配置其他邮箱。
解决方法: 检查并解决Email集成设置中的错误。 - Email同步正在进行中。同步完成后,您将收到Email通知。
用户的Email同步通过集成正在进行中。
解决方法: Email同步完成后,您可以重试。 - 同步尚未开始。
用户的Email集成尚未开始同步。
解决方法: Email同步完成后,您可以重试。 - Gmail APIAuthentication失败。
解决方法: 解决Email集成设置中的问题并重试。
- 此用户已被停用。管理员尚未启动备份。
示例回复
Copied{
"Emails": [
{
"attachments": [
{
"size": "24792",
"name": "email_templates.png",
"id": "72daf06xxx349c51ce66"
}
],
"subject": "test with attachment",
"editable": false,
"mail_format": "html",
"sent": true,
"intent": null,
"content": "<div>\n <div style=\"font-family:Verdana, arial, Helvetica, sans-serif; font-size:13px\">\n <div>\n <div style=\"font-family:undefined\"></div><font face=\"Verdana, Geneva, sans-serif\"><br /></font>hi<span id=\"x_373875665ecw_signature\"></span>\n </div>\n </div>\n </div>\n ",
"sentiment_info": null,
"sent_time": "2025-05-30T17:40:37+05:30",
"linked_record": null,
"thread_id": "a5e9238912f3f668bf9d304b89881492032b5476945134a8f304e35a55e4aff1",
"emotion": null,
"reply_to": {
"user_name": null,
"email": ""
},
"from": {
"user_name": "Patricia Boyle",
"email": "p.boyle@abc.com"
},
"to": [
{
"user_name": "John Smith",
"email": "smith.j@gmail.com"
}
],
"feedback_mechanism": false,
"status": [
{
"first_open": "2025-06-02T14:08:02+05:30",
"count": "10",
"type": "opened",
"last_open": "2025-06-02T14:10:01+05:30"
}
]
}
]
}