记录级别的电子邮件共享
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"
}
]
}