Zoho CRM API和函数迁移到v2.0

Zoho CRM API和函数迁移到v2.0

大家好,

一年前，我们发布了CRM API 2.0版本，它提供了比API 1.0版本更多的功能。除此之外，我们还宣布了弃用API v1.0，并且API v1.0将于2019年12月31日彻底失效。这是之前发布的公告的链接。

我们想提醒您尽快迁移到最新版本的CRM API，因为旧版本自明年开始将不可用。如果您的代码仍然使用API的1.0版本，那么它们将从2020年1月1日起停止工作，并且可能会有一些数据丢失。

在Zoho CRM内，访问 设置 > 开发者空间 > API。如果API仪表板显示有‘您的应用程序使用API v1.0’的横幅，则可能从以下一个或所有位置进行了API调用。
  1. Deluge函数
  2. 直接API调用
  3. 第三方集成
1. Deluge函数
Deluge函数 (在Zoho CRM或其它 Zoho服务内) 使用API v1.0调用方法 和/或 集成任务。

a. 调用方法
将 getUrl, postUrl, or invokeUrl Deluge任务中使用v1 URL的所有实例更改为其在v2中等效的URL。

b. 集成任务
在Zoho CRM内，访问 设置 > 开发者空间 > 函数 并将标记为"弃用" 的函数内使用的所有v1.0集成任务更改为v2.0。
同时，请确保更改其它Zoho服务内所使用的v1.0集成任务。

参阅我们的 函数迁移向导 以就如何迁移集成任务和调用URL了解更多信息。

为了进一步停用弃用的版本，从2019年11月1日起，我们将不允许使用v1集成任务和本地v1 URL调用在Deluge中创建新函数。

此外，您将无法更新在此日期之后创建的函数，来使用v1集成任务或调用URL。


2. 直接API调用
如果您的机构有用不同编程语言编写的特定于应用程序的脚本，并且它们使用API v1.0调用Zoho CRM，那么您必须将此类实例也更改为v2.0。

使用下面的清单可以方便地迁移API。
  1. 检查您是否需要 迁移用户访问令牌 或使用新权限重新验证。
  2. 熟悉新的v2语法。API v2.0只接受JSON输入。
  3. 熟悉字段属性和字段格式的更改。帮助文档中也提到了这一点 : 区别 - v1 和 v2。
  4. 看一下v1中可用的API方法，以及它们在v2中的不同之处 这里。
  5. 更新应用程序中处理的错误，以将正确的状态码运用到v2错误。
参阅我们的 API迁移向导 以获取更多详细信息。

3. 第三方集成
您的CRM帐户可能与任何仍然使用API v1.0的第三方应用程序（如MailChimp、Zendesk等）集成。在这种情况下，您只能敦促第三方供应商尽早迁移到2.0版本。为了加快迁移速度，我们已经向一些供应商发送了邮件，要求他们迁移到v2.0。

更新:

API v2内域"crm.zoho.com"的使用量


我们强烈建议您将 https://www.zohoapis.com 作为域来使用，而非crm.zoho.com，以获得API v2的全部益处。
确保根据帐户所在的数据中心指定域。例如，如果您的帐户位于欧盟数据中心，则您的API URL必须是 https://www.zohoapis.eu。

参阅 多数据中心支持 以获取有关各个数据中心和对应API URL的更多详细信息。


为了让每个人都知道这些变化，我们已经

  1. 给仍在代码中使用v1.0 API的所有机构的主用户发送提醒邮件。
  1. 在设置面板上显示一个横幅，提醒使用v1.0 API的用户。
  1. 在“函数”页上显示一个横幅，附带一个PDF，其中包含机构中需要迁移到v2.0的函数列表。


更新：

横幅什么时候展示？

  1. 您在过去24小时内进行了v1.0 API调用。
  1. 在“函数”页上，当函数仍然使用v1.0集成任务或调用URL时。请注意，这些统计数据每24小时刷新一次。因此，即使您更新/删除了一个使用v1.0代码的函数，在刷新统计数据之前，它仍然会出现在PDF中。

我们强烈建议您尽快完成迁移，以避免造成任何的数据丢失。如果您还有其它问题，请发送邮件给我们 support@zohocorp.com.cn。

    • Related Articles

    • Zoho Desk与Zoho CRM的集成

      Zoho CRM集成通过维护始终保持同步的单个客户数据库，为您的销售和支持团队提供客户的整体视图。对于集成，您必须在Zoho Desk中具有管理员权限。 此外，请确保您有可用的Zoho CRM管理员。 功能 与Zoho CRM集成带来以下功能，以提供卓越的客户体验 : 使用联系人、客户和产品的双向同步以及自定义字段的数据（如果有），维护客户和产品信息的统一数据库。 客服人员可以查看从CRM中获取的客户信息 - 例如与支持工单相同的窗口上的商机、备注、任务、通话及活动。 在Zoho ...

    • 为什么选择Zoho Desk?

      按需且基于网络  Zoho Desk，一个按需且基于网络的帮助台软件，允许您的客服人员与客户进行互动，以最快、最简单的方式提升满足感。并且因为它是完全在云端，所以安装与维护的成本较低，您可以专注于业务，而非软件本身。 智能定价 付费版以1008元/客服坐席/年起价，您可以期待Zoho Desk彻底地改变您客户技术支持服务的方式。如果您的客户支持流程涉及到一个全团队或者您的技术支持成本超出了预算，那么您可以注册我们的免费版，它支持添加3位客服人员。 功能强大 Zoho ...

    • 从 Zoho CRM 迁移

      Zoho CRM 非常适合寻求广泛定制和企业级业务流程的大型团队。而小型团队可能会寻找像 Bigin 这样更简单的替代方案。当您决定从 Zoho CRM 切换到 Bigin 时，只需点击一下即可将 Zoho CRM 数据导入到 Bigin。 可用性： 使用速成版（包括试用版）Bigin 或 Zoho One 版本的机构可以从 Zoho CRM 迁移数据。 权限： 只有具有管理员角色的用户才可发起此迁移。 数据将从以下模块迁移： 用户 联系人 公司 商机 产品 任务 活动 通话 备注 备注中的附件 ...

    • 与 Zoho CRM 集成

      Bigin 是一款以销售管道为中心的易用 CRM，可帮助您轻松管理您的销售管道，而 Zoho CRM 是一款完整的客户关系解决方案，可帮助您从头到尾处理您的销售流程。您可以使用 Zoho CRM 来存储客户的所有数据，而在 Bigin 中，您可以创建多个销售管道。例如，您可以创建一个流程来收集客户感言或管理服务请求。在这种情况下，必须将客户的详细信息从 CRM 同步到 Bigin，然后才能执行流程，并将面向销售管道的数据推送回 CRM，在一个地方维护与客户相关的所有详细信息。 利用 Zoho ...

    • 使用握手模式

      手动工单优先级排序不仅不方便，它还占用了您处理帮助台内重要任务的宝贵时间。Zoho Desk握手模式可以基于Zoho CRM内的客户类型来将帮助台内的工单进行列排序，让您的技术支持团队能够专注于服务支持。 如何工作: 握手模式由以下的工单列组成，在Zoho CRM内以联系人类型来命名 : 客户 商机 联系人/线索 新  可在Zoho CRM内快速检查技术支持工单的联系类型，并添加到合适的列。通常，工单的列是根据Zoho CRM内联系人的邮箱地址或者电话号码来决定。 ...