Zoho crm Logo

查看邮件

目的

使用此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"
                }
            ]
        }
    ]
}