跳到导航
集成设置指南现场服务

JobNimbus

使用 webhook 工具将新来电者作为潜在客户添加到 JobNimbus。

使用下方的 webhook 工具，接待员可以将新来电者添加到 JobNimbus，作为潜在客户工作流中的联系人，并记录其电话号码、地址和需求，方便团队跟进。

开始前

  1. 在 JobNimbus 中，选择右上角的个人资料图标，然后依次选择 Settings → API，创建新的 API 密钥。
  2. 选择可创建联系人且权限仅满足所需范围的 Access Profile。该密钥会保留创建时此配置文件拥有的权限。
  3. 复制完整 API 密钥，而非 Key ID。JobNimbus 只会显示一次。

该工具会在 Authorization 请求标头中以 Bearer YOUR_API_KEY 的形式发送密钥。

API 密钥可访问 JobNimbus 数据。请妥善保存，切勿分享。新密钥会在一年后过期，因此请在此之前创建替代密钥。

还需要新潜在客户应进入的联系人工作流和状态的准确名称，即 JobNimbus 设置中显示的名称，例如 Customer 和 Lead。

创建工具

前往 Integrations，选择 Add integration，再选择 Webhook Tool，然后填写以下字段。

字段值
名称create_jobnimbus_contact
描述”当来电者需要服务且此前未使用过我们的服务时，将其作为新潜在客户添加到 CRM。“
方法POST
URLhttps://app.jobnimbus.com/api1/contacts
请求标头Authorization：Bearer YOUR_API_KEY
正文参数first_name（字符串，必填）：“来电者的名字。”
last_name（字符串，必填）：“来电者的姓氏。”
record_type_name（字符串，必填）：“始终使用准确值 Customer。”
status_name（字符串，必填）：“始终使用准确值 Lead。”
mobile_phone（字符串，必填）：“来电者的电话号码，仅限数字。”
email（字符串）：“来电者提供时填写其邮箱地址。”
address_line1（字符串）：“需要服务的街道地址。”
city（字符串）：“该地址所在城市。”
state_text（字符串）：“州，使用两个字母的代码。”
zip（字符串）：“邮政编码。”
description（字符串，必填）：“来电者需要什么服务、何时有空，以及他们告知的其他信息。”
分配给智能体Receptionist

将 Customer 和 Lead 替换为自己的工作流和状态名称。

选择 Enable，然后以需要屋顶检查的新来电者身份 测试接待员。联系人会以潜在客户状态显示在 JobNimbus 中。

添加一条 流程，要求接待员先收集完整地址，再添加来电者。

限制

  • 搜索 JobNimbus 联系人需要 JSON 搜索筛选器，因此该工具无法查找来电者。回访来电者可能会被重复添加。
  • 工作、任务和备注通过嵌套字段关联联系人，而 webhook 工具无法发送这些字段。因此，联系人的描述会保存通话详情。

如需按邮箱查找来电者并创建与其联系人关联的工作，请通过 Zapier 使用 JobNimbus 的 Find Contact by Email、Create Contact 和 Create Job 操作。

故障排除

问题检查内容
JobNimbus 返回 401 或 403标头值必须是 Bearer 后接完整 API 密钥，而非 Key ID。检查密钥是否已过期。
工作流或状态错误record_type_name 和 status_name 必须与联系人工作流及其某个状态完全匹配。
403 且提示权限消息密钥的 Access Profile 无法创建联系人。请使用具有此权限的配置文件创建新密钥。
联系人没有地址在描述中要求接待员先询问完整地址，再添加来电者。