• 在 Zoho Books 中关闭某个商机后，您可以推送客户信息到会计软件（例如Zoho Books）中，并自动为客户生成发票。
  
• 您可以使用Zoho CRM的web表单，基于网站收集的线索或联系人，在电子邮件营销软件（如MailChimp）中向邮件列表添加订阅者。
• 您可以为现场销售代表触发SMS提醒，关于客户会议、备忘录和其它活动。
  
• 商机状态由观望转向报价时，可以在会计软件（例如 Zoho Books）中生成预估。
  
• 在 Zoho CRM 中关闭某个交易之后，可以在 Zoho Creator内置的销售佣金应用程序中自动计算给销售代表的佣金。
  

• 有管理工作流权限的 CRM 用户
  
• 有 REST API 技能的编程人员
  

所需权限
有管理工作流权限的用户可以使用此功能。

Webhook中的字段列表

字段名称	描述	限制以及数据类型
名称	指定webhook名称。	字母数字 (100)
说明	为webhook添加说明。	200个字符
方法	选择API方法类型 - POST, GET,  PUT, 以及DELETE。 POST支持您在相关应用程序字段中输入数值。 GET支持您检索信息以更新Zoho CRM中记录的字段。 PUT更新相关应用程序中的现有值。 DELETE删除相关应用的现有值。   注意：系统默认POST方法。	选择列表
URL通知	指定第三方应用程序的REST API URL。	300个字符
授权类型	选择所需授权类型 -  常规 ( 包含 API密钥或AUTH令牌)  以及连接器 (OAuth, API密钥等)	单选按钮
连接器	如果选择连接器，可以从列表中选择适当的连接器。   注意：连接器选项将只列出现有的连接。可以选择已存在连接或创建新的连接。 如果添加新连接，点击刷新按钮，下拉列表中将显示新添加的连接。	单选按钮
模块	选择Zoho CRM的一个模块。 支持的模块： CRM的主要模块，例如线索，联系人，客户，商机等。 任务，通话及会议模块。 注意：不能为通话记录或备注添加webhooks。	选择列表
标题	注意：URL 参数- 一个URL由Zoho CRM与其它应用间的触发信息组成。webhook中的URL常分为标题和正文。 添加到标题部分的参数有与其他应用程序标题同步的数据。除了触发信息外，标题可以携带API密钥/授权令牌。要形成标题URL参数，请选择模块参数和/或自定义参数。	标题限制：一个webhook最多可以容纳10个标题URL参数。
模块参数	指定参数名称、参数类型和相应的参数值。添加多个参数来构建字符串。这种格式是动态的，CRM提供了从选择列表中选择字段值的选项。 参数类型包括： CRM主要模块 用户 机构	-
自定义参数	为webhook指定CRM参数名称和相应的值。名称和值是配置的因为自定义参数的值是静态的。这个key/值主要用于发送Auth令牌、安全令牌、API密钥等。
正文	URL的主体部分包含URL字符串中关于触发其他应用程序的信息。您可以从选择列表中选择使用表单数据或原始数据，来配置URL的主体部分。 表单数据：创建URL的主体部分，只需将参数名称和参数类型或参数值加在一起即可。可通过三种方式创建表单-模块参数，自定义参数，以及用户定义的格式。 用户定义的格式：指定参数名称和参数值。这种格式也是动态的，能够使用#号从插入合并字段选项中选择数值的类型。 原始数据：除了组成参数外，如果选择原始数据作为主体类型，还可以在文本编辑器中写出自己的数据值。可用以下任意格式输入数据，XML，JSON，HTML，或文本。也可以使用#合并字段来表示脚本中的字段值。	原始数据限制：在原始数据文本编辑框里，一个webhook 可最多容纳15000个字符。
预览URL	预览URL显示GET和DELETE请求方式的完整Webhook URL，而对于POST和PUT方式，只显示配置的URL。 要预览URL，点击文本编辑器底部是刷新图标，也可以复制URL。	只读

设置Webhook

有时候可能在webhook说明值编辑器中使用的合并字段值现在显示为 ${Unsupported_Field}。 以下是可能的原因：

自定义字段被删除

您插入数值的合并字段被删除。 如果您的 webhook说明值编辑器继续包含已删除字段的合并字段值，该值将显示为 ${Unsupported_Field}。

自定义查找字段被删除

您插入数值的自定义查找字段被删除。 如果您的 webhook 值说明编辑器继续包含已删除查找字段的合并字段值，该值将显示为 ${Unsupported_Field}。

字段未在可用合并字段列表中列出

如果您为所选模块使用了不再可用合并字段列表中某字段的合并字段值，则它将显示为 ${Unsupported_Field}。

例如，如果您在线索模块的${Leads.Lead Id}值说明编辑器中插入合并字段值，其将显示为不支持的字段。

集成/功能被禁用

某个功能或集成被禁用于您的账户时，作为集成其中一部分创建的字段在取消激活后对账户也不可用。 如果此字段的合并字段值被插入值说明编辑器，它将显示为${Unsupported_Field}。 适用于下列功能/集成。

• Google AdWords 集成 - 不再可用的 Google AdWords 字段将不受支持。
  
• 访客追踪（Zoho SalesIQ 集成）： 不再可用的访客追踪字段将不受支持。
  
• 区域管理 - 不再可用的字段将不受支持。
  
• 多货币 - 曾被取消激活的货币将不受支持。

如需将 Webhook 与工作流规则关联

1. 点击设置> 自动化>工作流规则。
   
2. 在 工作流规则 页面，点击新建规则。
   
3. 在 新建规则  页面中，指定工作流规则参数。
   
4. 在 工作流操作 下方，选择 webhook。
   
5. 在调用 Webhook 弹出页面，选择所需的 Webhook 并点击关联。
   
6. 点击保存。

如需测试 Webhook 集成

1. 根据您的工作流规则条件在 CRM 中添加测试数据。
   
2. 通过 Webhook 通知在您的应用程序中检查从Zoho CRM收到的数据。
   
3. 如果发生错误或数据不匹配，在Zoho CRM中修改您的Webhook设置。
   
4. 继续这一测试，直至您从Zoho CRM获取所需数据到您的应用程序中。
   

重要注意事项

• 您可以为每条工作流规则关联最多 6 个（1 个即时操作和 5 个基于时间的操作）Webhook。
  
• 您可以利用Webhook最多从10个Zoho CRM字段中传输数据至第三方应用程序。
  
• 不可以使用Webhook从其它应用检索Zoho CRM的数据。
  
• 您必须依据第三方应用程序中的限制定期更新 API 许可。
  
• 如果Webhook集成因为第三方 API 中的任何问题停止运行，您不会收到邮件通知。
  
• 在Webhook中，允许最多 10000 个字符用于用户定义格式，同时使用 POST 方法。
  
• 如果这一过程中有任何故障，Webhook会先发送通知，Zoho CRM会在 15 分钟后发送第二次通知。之后，系统不会因为特定的工作流触发发送任何Webhook通知。
  
• 如果您超过了每天的最大限制，系统不会将剩余的Webhook通知发送给第三方应用程序，而会将故障告知管理员。
  
• 在URL通知字段中，如果您想要指定端口，请注意仅支持80 或 443端口号。
  
• 您可在Webhook参数配置期间选择所需的日期/日期时间格式和时区。
  
• Webhook的限制：
  
• 高级版 - 10000 次调用/天或 100 次调用/用户（以较低者为准）。
  
• 旗舰版 - 100000 次调用/天或 500 次调用/用户（以较低者为准）。
  
• 超级版 - 500000次调用/天或1000次调用/用户/天（以较低者为准）。 
  

1. 在 CRM 中添加测试商机，类型和付款到期日期字段分别为现有业务和今天。输入测试数据时，确保同时输入金额、关闭日期、记录所有者、客户名称和商机名称。
   
2. 在您的手机中检查 SMS 提醒
   如果您未收到 SMS，修改 Webhook 配置，继续测试。 测试成功后，删除测试条目，并将这一集成转出给您的 CRM 用户。

Webhook 执行失败时，Zoho CRM 中将显示下列错误消息之一：

• Bad Request - 可能缺失一个必填参数。
  
• Unauthorized Request  - 提供了的身份验证令牌无效。
  
• Request Failed - 参数有效，但请求失败。
  
• Page not Found - 如果请求项不存在。
  
• Third-party error - 由于第三方应用程序中的故障。
  
• Third-party server not available - 在第三方API服务器上断开连接。
• Internal process failure - 如果处理webhook时出错。
  
• Day limit reached - 如果机构已达到当天的最大限制。
  
• Invalid URL - 如果该URL易受SSRF攻击或是无效的URL。
  
• Socket timeout - 如果调用了webhook，但直到10秒才收到响应。