自定义销售信号
Zoho CRM 中的销售信号功能提供来自线索、联系人或潜在客户的所有接触点的实时通知。您可以跟踪多种渠道的客户互动，并从您的中心位置（即 Zoho CRM 帐户）跟进他们。点击 Zoho CRM 主页右上角的 
[通知图标] 时，将显示销售信号通知。
请参阅配置和查看销售信号以了解有关 Zoho CRM 中显示的销售信号类型以及显示时间。
您现在可以使用 Zoho Developer 控制台创建自定义销售信号，并在收到任何第三方应用程序的通知时生成销售信号，并将其显示给 Zoho CRM 中的销售代表。要实现此目的，您需要使用 Zoho Developer 控制台构建扩展，或者检查 Zoho 应用市场上是否已有这类扩展。
本文档将指导您完成为本机扩展和第三方集成创建和生成销售信号的逐步过程。
在本机扩展中定义并生成销售信号
本机扩展是一组捆绑在一起的自定义功能，以扩展 Zoho CRM 系统的功能而不受任何其他第三方服务的影响。例如，编写新的自定义工作流规则以在 Zoho CRM 中设置提醒/通知，每当进行中的交易长时间处于休眠状态（此时间段可由用户根据其需求定义）时发出提醒或通知。
为本机扩展配置销售信号包含两个步骤：
定义信号
第一步是在 Zoho Developer 控制台中创建并定义销售信号。
要创建销售信号，请执行以下操作：
- 在 Zoho Developer 控制台主页中，点击 Zoho CRM 的扩展。
- 在要在其中生成销售信号的扩展的下方点击编辑。
- 在扩展详细信息页面中，点击左窗格中的销售信号。
- 在销售信号页面中，点击定义信号。
- 提供以下详细信息以定义该信号。
- 信号名称 - 此名称将显示在设置页面中，用户可在此页面中启用/关闭信号。
- 名称空间 - 用于在任何自定义函数中找到此信号的唯一名称空间。
- 图标 - 在 Zoho CRM 中与通知一起显示的首选图标。
- 点击保存。
生成信号
可通过调用下面给出的 deluge 任务生成信号。此函数可与调度程序/自定义函数关联，以便销售流程中的交易在特定时间段内处于休眠状态时获得通知。以下样本函数可用于在销售在资质审查阶段停留 10 天时生成销售信号。
resp = zoho.crm.getRecords("Potentials");
for each usersVal in resp
{
id = usersVal.get("POTENTIALID");
time = (usersVal.get("Modified Time")).toTime();
stage = usersVal.get("Stage");
NumberofDaysinQualification = 10;
flag = 0;
NumberofDays = days360(time,zoho.currentdate);
if ((stage == "Qualification") && (NumberofDays.toLong() > NumberofDaysinQualification))
{
flag = 1;
}
if (flag == 1)
{
signalMap = map();
signalMap.put("signal_namespace", "guests.idledealalert");
signalMap.put("email", "abid.nadeem@zohocorp.com");
signalMap.put("subject", "Idle Deal Alert");
signalMap.put("message", "Your Deal is Stuck. Please look into it. Thanks !");
actionsList = List();
actionMap = map();
actionMap.put("type", "link");
actionMap.put("display_name", "View Potential");
actionMap.put("url", "EntityInfo.do?module=Potentials&id=" + id);
actionsList.add(actionMap); signalMap.put("actions", actionsList); result = zoho.crm.invokeConnector("raisesignal", signalMap); info result;
}
}
每当生成此信号时，您将在 Zoho CRM 中收到通知，如下所示。
对第三方集成定义并生成销售信号
第三方集成扩展允许用户将他们的 Zoho CRM 帐户链接至 Pandadoc、Google、Zendesk、SurveyMonkey 等外部服务。实现此集成后，用户可能需要来自第三方服务的更改的及时更新。例如，考虑以下场景：您已将 Zoho CRM 与 SurveyMonkey 集成。您已使用 SurveyMonkey 创建调查并将其发送至客户和潜在客户，同时希望客户查看您的调查或回复调查时收到及时通知。可通过使用 Zoho Developer 控制台设置销售信号来实现此目的。
定义信号
要为第三方应用程序创建销售信号，请执行以下操作：
- 在 Zoho Developer 控制台主页中，点击 Zoho CRM 的扩展。
- 在要在其中生成销售信号的扩展的下方点击编辑。
- 在扩展详细信息页面中，点击左窗格中的销售信号。
- 在销售信号页面中，点击定义信号。
- 提供以下详细信息以定义该信号：
- 信号名称 - 此名称将显示在设置页面中，用户可在此页面中启用/关闭信号。
- 名称空间 - 用于在任何自定义函数中找到此信号的唯一名称空间。
- 图标 - 在 Zoho CRM 中与通知一起显示的首选图标。
- 点击保存。
注册 webhook
大多数服务为其他服务提供 webhook 支持，以便注册要在第三方服务中发生特定活动时发送的通知。只需手动指定必需详细信息或通过编程就可完成此任务（如果服务具有用于完成此任务的配置）。要注册 Webhook，您需要 Webhook URL。
可定义独立 deluge 函数，并以 REST API 形式公开。针对此函数生成的 REST API 可在第三方服务注册为 Web hook URL。
从第三方服务调用此 URL 时，系统会执行 deluge 回调函数，您添加的生成信号任务将生成销售信号。
定义 deluge 函数
所以，注册 Webhook 的第一步是定义可作为 REST API 公开的 deluge 函数。用于定义函数的语法为：
<function_name> (map requestMap)
{
}
以 REST API 形式公开的所有函数的映射变量将定义为输入变量。 它包含发布至 API 的所有数据，并已定义三个键：
- 参数
- 头
- 请求字符串
定义并保存此函数后，系统将生成 REST API URL。此 URL 是必须提供给第三方应用程序的 Webhook URL。下面给出样本 REST API URL 模式：
http://platform.zoho.com/crm/v2/settings/custom_function/<function_name>/execute
定义 deluge 函数并获取 Webhook URL 后，您必须在第三方服务中注册 webhook。注册 webhook 之前，我们应了解第三方提供的身份验证类型。
如果第三方服务提供基于令牌的身份验证，那么可使用简单的 POST URL 任务实现此目的。请参阅 POST URL 以了解如何编写 POST URL 脚本。
如果第三方服务使用 OAuth 2.0 身份验证，那么您必须创建连接器和关联 API。对于任何第三方服务，可从其开发者文档获取 API URL 及其参数。
创建此连接器 API 后，可编写自定义函数以调用连接器 API。调用此连接器 API 的操作是根据第三方为注册 Webhook 而提供的选项完成的。某些服务允许在记录级别注册 webhook（每当创建或修改特定记录时），另一些服务允许在服务级别注册 webhook（每当服务中发生任何更改时）。
可使用以下给出的格式定义 webhook_url：
webhook_url="http://platform.zoho.com/crm/v2/settings/custom_function/<function_name>/execute"
要获取要在自定义函数中使用的 apikey 值，请使用以下代码：
getmap = { "nameSpace" : "<portal_name.extension_namespace>"};
apiresponse = zoho.crm.invokeConnector("crm.zapikey", getmap);
apikey = apiresponse.get("response");
SurveyMonkey 提供记录级别的选项。所以，每当在 CRM 中创建调查时，我们必须触发将执行自定义函数（它具有用于注册 webhook 的源代码）的工作流。下面给出了样本自定义函数（使用通过以上步骤获取的 webhook_url
survey_id = input.surveymonkey_details_.get("surveymonkey.Survey_ID");
crm_signal_webhook_url = webhook_url+"?survey_id=" + survey_id + "&zapikey="+apikey;
map = { "survey_id" : survey_id, "crm_signal_webhook_url" : crm_signal_webhook_url };
response = zoho.crm.invokeConnector("surveymonkey.surveymonkeyconnector.registerwebhook",map);
编写工作流规则以在 Zoho CRM 中使用 SurveyMonkey 创建新调查时调用此自定义函数。通过此方式可成功完成 webhook 注册。
通过将该函数添加为安装后脚本，还可在安装扩展时注册 webhook。
生成信号
每当第三方发生更改时，都会生成销售信号。例如，在 SurveyMonkey 中，每当用户完成调查时，该调查的详细信息将推送至 Zoho CRM。
您需要添加以下 deluge 任务以将该信号推送至 Zoho CRM。如上所述，您将在 requestMap 变量中获取来自第三方服务的所有详细信息。
survey_id=input.requestParamMap.get("survey_id");
response_id=input.requestContentStr.getJSON("object_id");
map={ "survey_id" : survey_id, "response_id" : response_id };
response = zoho.crm.invokeConnector(("surveymonkey.surveymonkeyconnector.getsurveyresponsedetails"),map);
responseObj=response.toString().getJSON("response");
EMAIL=responseObj.getJSON("metadata").getJSON("contact").getJSON("email").getJSON("value");
SUBJECT="Survey Monkey Responded";
MESSAGE="Response from survey monkey";
DETAIL_VIEW_LINK_NAME="View Survey Response";
DETAIL_VIEW_LINK_URL=responseObj.getJSON("analyze_url");
map={ "email" : EMAIL, "subject" : SUBJECT, "message" : MESSAGE, "preview_link_name" : DETAIL_VIEW_LINK_NAME, "preview_link_url" : DETAIL_VIEW_LINK_URL };
return map.toString();