Zoho crm Logo

记录级别的电子邮件共享

Zoho CRM 提供了一个选项,可以将记录的电子邮件与您 Zoho CRM 组织中的其他Users共享。这增强了团队成员之间的协作。您可以共享潜在客户、联系人和自定义模块中的记录的电子邮件。设置了自定义共享电子邮件权限的Users可以使用此API。

目的

通过API在您的Zoho CRM组织中为特定记录或多个记录与其他用户共享记录级的电子邮件。

端点

  • POST /{module_API_name}/actions/share_emails
  • POST /{module_API_name}/{record_ID}/actions/share_emails

请求详情

请求URL

在记录级别共享多个记录的邮件:
{api-domain}/crm/{version}/{module_API_name}/actions/share_emails

在记录级别共享特定记录的邮件:
{api-domain}/crm/{version}/{module_API_name}/{record_ID}/actions/share_emails

支持的模块

潜在客户、联系人和自定义模块

标题

授权:Zoho-oauthtokend92d4xxxxxxxxxxxxx15f52

范围

ZohoCRM.modules.ALL
(或)
ZohoCRM.modules.{module_name}.{operation_type}

可能的模块名称

潜在客户、联系人和自定义模块

可能的操作类型

全部 - 对记录有完全访问权限
创建 - 对记录有创建访问权限

示例请求

Copiedcurl "https://www.zohoapis.com/crm/v8/Leads/actions/share_emails"
-H "Authorization: Zoho-oauthtoken 1000.8cb99dxxxxxxxxxxxxx9be93.9b8xxxxxxxxxxxxxxxf"
-d @shareemails.json
-X POST

输入 JSON

  • IDs JSON 数组,当共享多个记录ID的电子邮件时是必需的。你可以通过一次 API 调用共享多达 200 个记录。

    一个包含以逗号分隔格式的记录ID的数组。这些是你希望共享其电子邮件的支持模块的记录的唯一ID。

注意

  • 分享单个记录的电子邮件时,跳过输入的 JSON。如果提供了输入 JSON,系统将忽略它。
  • 只能通过记录级别电子邮件共享 API 共享用于验证连接的用户账户的电子邮件。

示例输入

Copied{
    "ids": [
        "5843104000000425566",
        "5843104000000425570"
    ]
}

可能的错误

  • ALREADY_SHARED HTTP 400

    指定ID的电子邮件已经与同事共享
    解决方案:无需任何操作;电子邮件已被共享。

  • INVALID_DATA HTTP 400

    提供的记录ID似乎无效
    解决方案:确保输入JSON中的记录ID是正确的。

  • INVALID_DATA HTTP 400

    给定的相关ID似乎无效
    解决方法:确保端点中的记录ID是正确的。

  • NOT_ALLOWED HTTP 400

    电子邮件配置不存在
    解决方法:为您的 Zoho CRM 组织配置电子邮件集成。

  • NOT_ALLOWED HTTP 400

    用户未启用自定义共享
    解决方案: 为您的 Zoho CRM 组织设置自定义电子邮件共享权限 。

  • NOT_SUPPORTED HTTP 400

    所提供的模块在 API 中不被支持
    解决方案:支持的模块有潜在客户、联系人和自定义模块。

  • INVALID_REQUEST_METHOD HTTP 400

    请求方法不正确
    解决方法: 使用 HTTP POST 方法来进行此 API 调用。使用任何其他请求方法将导致此错误。

  • OAUTH_SCOPE_MISMATCH HTTP 401

    您用于进行此 API 调用的访问令牌不具有所需的范围
    解决方法: 生成一个具有此 API 所需范围的新访问令牌。请参阅本页面开头的 范围 部分以获取所需范围的列表。

  • INVALID_URL_PATTERN HTTP 404

    请求URL不正确
    解决方案: 请指定一个有效的请求URL。有关详细信息,请参阅本页面开头的请求URL部分。

  • INTERNAL_ERROR HTTP 500

    服务器中意外且未处理的异常
    解决方案: 联系支持团队,邮箱:support@zohocrm.com。

示例响应

Copied{
    "data": [
        {
            "code": "SUCCESS",
            "details": {
                "id": "5843104000000425566"
            },
            "message": "Successfully shared",
            "status": "success"
        },
        {
            "code": "SUCCESS",
            "details": {
                "id": "5843104000000425570"
            },
            "message": "Successfully shared",
            "status": "success"
        }
    ]
}