常见问题: 开发者中心

常见问题: 开发者中心

如何使用 API 从线索模块获取数据到我的应用程序?

您可以使用 Zoho CRM REST API 从线索模块和其他模块检索数据。请参阅此文档了解更多详细信息。

API 密钥是针对用户特定还是针对机构特定的?

Zoho CRM API 密钥是针对特定机构的。您可以为所有具有不同工单 ID(针对特定用户)的用户使用同一 API 密钥。

将任务或活动与 CRM 记录关联的 xmlData 参数的格式是什么?

使用以下示例 XML 将活动与客户和联系人分别关联。

客户

<Events><rowno="1">
<FL val="SEMODULE">Accounts</FL>
<FL val="SEID">22222222222</FL>
<FL val="Subject">test</FL>
<FL val="Start DateTime">12/12/2009
11:12:25</FL>
<FL val="End
DateTime">12/12/2009 11:12:25</FL>
</row>
</Events>

联系人

<Events><rowno="1&">
<FL val="SEMODULE">Contacts</FL>
<FL val="CONTACTID">22222222222</FL>
<FL val="Subject">test</FL>
<FL val="Start DateTime">12/12/2009
11:12:25</FL>
<FL val="End
DateTime">12/12/2009 11:12:25</FL>
</row>
</Events>


我可以通过 API 插入线索后触发邮件吗?

是的,您可以通过创建工作流来在线索进入 CRM 时自动发送邮件来实现这一点。当您调用 API 插入线索时,请附加参数 "wfTrigger",并将其值设置为 "true"。有关插入记录参数的更多信息,请阅读。
这将在工作流插入记录后触发工作流,进而发送邮件。

我如何使用 getAllRecords 检索单个客户?

您可以使用 getRecordById 方法通过传递记录的 ID 来获取单个客户。

通过 API 插入新线索时,如何将其分配给所有者?

通过 API 插入线索时,请确保您指定了线索所有者的邮箱地址。如果您使用线索所有者的姓名或用户 ID,线索将被分配给生成工单时使用的默认登录凭证。

如果我在使用旗舰版,并且额外订阅了 2 个用户,每天可以发起多少次 API 请求?

在 Zoho CRM 中,单个旗舰版用户每天最多可发起 25,000 次请求,或每个用户许可最多 500 个请求,以较低者为准。
最小和最大限制根据机构当前使用的版本而有所不同。
在此了解更多关于 API 限制的信息

通过 Zoho CRM API 是否可以上传并关联附件到记录?

是的。可以通过 Zoho CRM API 使用 uploadFile 方法将附件与记录关联起来,该方法用于将文件附加到记录上。

另见:uploadFile 方法

如果在获取记录时未指定 newFormat 参数的值,会发生什么?

如果获取记录时未指定 newFormat 参数,则该参数将被赋予默认值 "1",即 newFormat = 1。


可以通过 HTTP POST 插入记录吗?

不可以。记录只能通过 XML POST 插入。详情请参考此链接。

对于 updateRecords 方法,我可以在哪里获取记录 ID 的值?

在插入或获取记录后获得的 XML 响应中,将提供唯一记录 ID 的值。
 
例如:<FL val="Id">508020000016189251</FL>


什么是 CRM 认证Token?

CRM 认证Token是一个加密的字母数字字符串,用于验证您的 Zoho CRM 凭证。它用于将您的 CRM 账户与第三方软件和服务集成。

我可以生成一个新的认证Token吗?

可以。有两种方法可以生成一个新的认证Token。

1. 第一种方法是 API 模式。您可以使用生成现有文件时使用的相同 URL 格式。URL 格式为:


2. 第二种方法是浏览器模式。要使用此方法,
  • 点击设置 > 开发者中心 > API 及 SDK
  • 在 CRM API 页面中,点击设置并选择认证Token生成。点击生成按钮立即获取认证Token。


请注意,现有的认证Token也将有效。

我该如何删除现有的认证Token?

要删除现有的认证Token:
  1. 登录到 accounts.zoho.com.cn。
  2. 点击我的个人信息。
  3. 进入会话并点击活跃的认证Token。
  4. 所有生成的授权Token将列在此处。
  5. 选择您要删除的授权Token的复选框,然后点击移除所选。该授权Token将被删除。
有关授权Token的更多信息,请点击此处。

我正在使用 insertRecords 方法插入线索,但关联的工作流规则没有触发。为什么?

要让工作流规则被触发,您需要将 wfTrigger 参数的值设置为 true。默认情况下,此参数将被设置为 false。

如果我的 API 每日限额被超出,会发生什么?

如果您的 API 日限制已超出,Zoho CRM 将不会在当天剩余时间内响应 API 调用。您需要等到 API 限制在第二天重置后才能继续使用。API 限制每天会在太平洋标准时间凌晨 12 点至凌晨 3 点之间重置。

如果当前的 API 限制无法满足您的业务需求,您可以增加每日 API 限制。有关提高 API 调用限制的定价详情,请发送邮件至 support-crm@zohocorp.com.cn。

为了优化您的 API 使用,每次请求最多获取 200 条记录,并每次请求最多插入、更新或删除 100 条记录。

注意:在所有 Zoho CRM 版本中,getSearchRecords 和 getCVRecords 方法的标准限制是每天 250 次 API 调用。

我可以提高 API 限制吗?

可以。如果当前的 API 限制无法满足您的业务需求,您可以增加每日 API 限制。您只需发送邮件至 support-crm@zohocorp.com.cn,说明您的需求,我们将回复您关于提高 API 调用限制的定价详情。

能否使用 getRelatedRecords 方法获取自定义查找字段的关联记录?

不能使用 getRelatedRecords 方法获取自定义查找字段的关联记录。可以使用此方法获取系统定义项目的关联记录。

例如:可以获取与客户、联系人等相关的任务/会议/电话。

另见:API 方法

公司里的每个人可以使用同一个 API 密钥吗?

是的,公司里的每个人都可以使用同一个 API 密钥进行第三方应用的开发和集成。


insertRecords 和 updateRecords 方法的 xmlData 参数的格式是什么?

在使用 insertRecords 和 updateRecords 方法时,请使用以下 XMLData 参数:

insertRecords: https:// crm.zoho.com/crm/private/ xml / Leads /insertRecords?apikey= API Key &ticket= Ticket
  1. ticket=xxxxxxxxxxxxxx
  2. apikey=xxxxxxxxxxxxxx
  3. xmlData= as given below
  1. <Leads>
    <row no="1">
    <
    FL val ="Lead Source">Web Download</FL>
    <
    FL val ="First Name">contacto 1</FL>
    <
    FL val ="Last Name">apellido</FL>
    < FL val ="Email"> testing@testing.com < /FL >
    <
    FL val ="Title">Manager</FL>
    <
    FL val ="Phone">1234567890</FL>
    <
    FL val ="Home Phone">0987654321</FL>
    <
    FL val ="Other Phone">1212211212</FL>
    <
    FL val ="Fax">02927272626</FL>
    <
    FL val ="Mobile">292827622</FL>
    </row>
    </Leads>

updateRecords: https://crm.zoho.com/crm/private/xml/Leads/updateRecords?apikey=API Key&ticket=Ticket
  • ticket=xxxxxxxxxxxxxxx
  • apikey=xxxxxxxxxxxxxxx
  • id = 1000000019001
  • xmlData= as given below
  1. <Leads>
    <row no="1">
    <
    FL val="Lead Source">Web Download</FL>
    <
    FL val="First Name">contacto 1</FL>
    <
    FL val="Last Name">apellido</FL>
    <FL val="Email">testing@testing.com</FL>
    <
    FL val="Title">Manager</FL>
    <
    FL val="Phone">1234567890</FL>
    <
    FL val="Home Phone">0987654321</FL>
    <
    FL val="Other Phone">1212211212</FL>
    <
    FL val="Fax">02927272626</FL>
    <
    FL val="Mobile">292827622</FL>
    </row>
            </Leads>

是否必须在 POST 中发送所有参数?

是的,必须在 POST 中发送所有参数。


将任务或活动关联到 CRM 记录的 xmlData 参数的格式是什么?

使用以下示例 XML 将活动与客户和联系人分别关联。

  1. 客户

    <Events><row no="1">
    < FL val =" SEMODULE "> Accounts </FL>
    < FL val ="SEID"> 22222222222 </FL>
    < FL val ="Subject">test</FL>
    < FL val ="Start DateTime">12/12/2009 11:12:25</FL>
    < FL val ="End DateTime">12/12/2009 11:12:25</FL>
    </row>
    </Events>
  2. 联系人

    <Events><row no="1&">
    < FL val = "SEMODULE "> Contacts </FL>
    < FL val = "CONTACTID "> 22222222222 </FL>
    < FL val ="Subject">test</FL>
    < FL val ="Start DateTime">12/12/2009 11:12:25</FL>
    < FL val ="End DateTime">12/12/2009 11:12:25</FL>
    </row>
    </Events>

在将查找字段与模块关联时,我可以使用记录 ID 吗?

是的,您可以在将查找字段与模块关联时使用记录 ID(例如:将市场活动与线索或客户与联系人关联)。

如果我在免费版中,每天可以发起多少次 API 请求?

在免费版中,每个机构每天最多可以发起 1000 次请求。

如果我在获取记录时没有为newFormat 参数指定值会怎样?

如果获取记录时没有为newFormat 参数指定值,将为其分配默认值"1",即 newFormat = 1。


在通过 API 创建任务时,我可以关联客户或联系人吗?

是的,您可以通过 API 创建的任务与客户或联系人关联。以下是关联任务与客户或联系人的示例 XML:
 
<Tasks> 
<row no='1'> 
<FL val='Subject'>test 11111111</FL> 
<FL val='Due Date'>20/2/2021</FL> 
<FL val='CONTACTID'>xxxxxxxxxx</FL> 
<FL val='SEMODULE'>Accounts</FL> 
<FL val='SEID'>xxxxxxxxx</FL> 
</row> 
</Tasks>