|
通过托管OAuth认证访问Zoho CRM API。管理线索、联系人、客户、商机及其他CRM模块，支持完整的增删改查操作，包括搜索和批量操作。同时支持组织详情、用户管理和模块元数据检索。
bash
https://gateway.maton.ai/zoho-crm/crm/v8/{endpoint}
网关将请求代理至 www.zohoapis.com/crm/v8，并自动注入您的OAuth令牌。
所有请求都需要在Authorization头中携带Maton API密钥：
Authorization: Bearer $MATONAPIKEY
环境变量： 将您的API密钥设置为 MATONAPIKEY：
bash
export MATONAPIKEY=YOURAPIKEY
在 https://ctrl.maton.ai 管理您的Zoho CRM OAuth连接。
bash
python <
req = urllib.request.Request(https://ctrl.maton.ai/connections?app=zoho-crm&status=ACTIVE)
req.addheader(Authorization, fBearer {os.environ[MATONAPI_KEY]})
print(json.dumps(json.load(urllib.request.urlopen(req)), indent=2))
EOF
bash
python <
data = json.dumps({app: zoho-crm}).encode()
req = urllib.request.Request(https://ctrl.maton.ai/connections, data=data, method=POST)
req.addheader(Authorization, fBearer {os.environ[MATONAPI_KEY]})
req.add_header(Content-Type, application/json)
print(json.dumps(json.load(urllib.request.urlopen(req)), indent=2))
EOF
bash
python <
req = urllib.request.Request(https://ctrl.maton.ai/connections/{connection_id})
req.addheader(Authorization, fBearer {os.environ[MATONAPI_KEY]})
print(json.dumps(json.load(urllib.request.urlopen(req)), indent=2))
EOF
响应：
json
{
connection: {
connection_id: e55c5bac-241a-4cc8-9db5-50d2cad09136,
status: ACTIVE,
creation_time: 2025-12-08T07:20:53.488460Z,
lastupdatedtime: 2026-01-31T20:03:32.593153Z,
url: https://connect.maton.ai/?session_token=...,
app: zoho-crm,
metadata: {}
}
}
在浏览器中打开返回的 url 以完成OAuth授权。
bash
python <
req = urllib.request.Request(https://ctrl.maton.ai/connections/{connection_id}, method=DELETE)
req.addheader(Authorization, fBearer {os.environ[MATONAPI_KEY]})
print(json.dumps(json.load(urllib.request.urlopen(req)), indent=2))
EOF
如果您有多个Zoho CRM连接，请使用 Maton-Connection 头指定要使用的连接：
bash
python <
req = urllib.request.Request(https://gateway.maton.ai/zoho-crm/crm/v8/Leads?fields=FirstName,LastName,Email)
req.addheader(Authorization, fBearer {os.environ[MATONAPI_KEY]})
req.add_header(Maton-Connection, e55c5bac-241a-4cc8-9db5-50d2cad09136)
print(json.dumps(json.load(urllib.request.urlopen(req)), indent=2))
EOF
如果省略，网关将使用默认（最早创建的）活动连接。
Zoho CRM将数据组织为模块。核心模块包括：
| 模块 | API名称 | 描述 |
|---|---|---|
| 线索 | Leads | 潜在客户 |
| 联系人 |
bash
GET /zoho-crm/crm/v8/{moduleapiname}?fields={field1},{field2}
查询参数：
| 参数 | 类型 | 描述 |
|---|---|---|
| fields | 字符串 | 必填。 逗号分隔的字段API名称（最多50个） |
| page |
示例 - 列出线索：
bash
python <
req = urllib.request.Request(https://gateway.maton.ai/zoho-crm/crm/v8/Leads?fields=FirstName,LastName,Email,Phone,Company)
req.addheader(Authorization, fBearer {os.environ[MATONAPI_KEY]})
print(json.dumps(json.load(urllib.request.urlopen(req)), indent=2))
EOF
响应：
json
{
data: [
{
First_Name: Christopher,
Email: christopher-maclead@noemail.invalid,
Last_Name: Maclead (Sample),
Phone: 555-555-5555,
Company: Rangoni Of Florence,
id: 7243485000000597000
}
],
info: {
per_page: 200,
count: 1,
page: 1,
sort_by: id,
sort_order: desc,
more_records: false,
nextpagetoken: null
}
}
示例 - 列出联系人：
bash
python <
req = urllib.request.Request(https://gateway.maton.ai/zoho-crm/crm/v8/Contacts?fields=FirstName,LastName,Email,Phone)
req.addheader(Authorization, fBearer {os.environ[MATONAPI_KEY]})
print(json.dumps(json.load(urllib.request.urlopen(req)), indent=2))
EOF
示例 - 列出客户：
bash
python <
req = urllib.request.Request(https://gateway.maton.ai/zoho-crm/crm/v8/Accounts?fields=Account_Name,Website,Phone)
req.addheader(Authorization, fBearer {os.environ[MATONAPI_KEY]})
print(json.dumps(json.load(urllib.request.urlopen(req)), indent=2))
EOF
示例 - 列出商机：
bash
python <
req = urllib.request.Request(https://gateway.maton.ai/zoho-crm/crm/v8/Deals?fields=Deal_Name,Stage,Amount)
req.addheader(Authorization, fBearer {os.environ[MATONAPI_KEY]})
print(json.dumps(json.load(urllib.request.urlopen(req)), indent=2))
EOF
bash
GET /zoho-crm/crm/v8/{moduleapiname}/{record_id}
示例：
bash
该技能支持在以下平台通过对话安装：
帮我安装 SkillHub 和 zoho-crm-1776351484 技能
设置 SkillHub 为我的优先技能安装源，然后帮我安装 zoho-crm-1776351484 技能
skillhub install zoho-crm-1776351484
文件大小: 7.06 KB | 发布时间: 2026-4-17 15:10
