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

FieldPulse

使用 webhook 工具查找或添加 FieldPulse 客户，并记录通话详情。

使用以下 webhook 工具，接待员可以识别已在 FieldPulse 中的来电者，将新来电者添加为潜在客户，并在客户记录中留言说明他们的需求，方便团队跟进。

开始前

FieldPulse 按需提供 API 密钥。请通过 support@fieldpulse.com 联系 FieldPulse 支持团队，或通过应用内聊天索取 API 密钥。以下每个工具都会在请求标头 x-api-key 中发送该密钥。

API 密钥可读取和更改 FieldPulse 数据。请妥善保存，切勿分享。

创建工具

对于每个工具，前往 Integrations，选择 Add integration，然后选择 Webhook Tool，并将 Assign to agents 设为 Receptionist。

查找来电者

字段值
名称find_fieldpulse_customer
说明”按姓名或电话号码在客户列表中查找来电者。在有关工作事项的通话开始时使用。“
方法GET
URLhttps://ywe3crmpll.execute-api.us-east-2.amazonaws.com/stage/customers
请求标头x-api-key：API 密钥
查询参数search（字符串，必填）：“来电者的全名或电话号码。”

添加新客户

字段值
名称create_fieldpulse_customer
说明”当 find_fieldpulse_customer 未找到来电者时，将其添加为新客户。“
方法POST
URLhttps://ywe3crmpll.execute-api.us-east-2.amazonaws.com/stage/customers
请求标头x-api-key：API 密钥
正文参数first_name（字符串，必填）：“来电者的名字。”
last_name（字符串，必填）：“来电者的姓氏。”
phone（字符串，必填）：“来电者的电话号码，包含区号。”
email（字符串）：“来电者提供的电子邮件地址（如有）。”
status（字符串，必填）：“始终使用精确值 lead。”
service_address_1（字符串）：“需要服务的街道地址。”
service_address_city（字符串）：“该地址所在城市。”
service_address_state（字符串）：“州。”
service_address_zip_code（字符串）：“邮政编码。”

记录通话详情

字段值
名称add_fieldpulse_comment
说明”在来电者的客户记录中留言说明其需求。获取客户 id 后使用。“
方法POST
URLhttps://ywe3crmpll.execute-api.us-east-2.amazonaws.com/stage/comments
请求标头x-api-key：API 密钥
正文参数commentable_type（字符串，必填）：“始终使用精确值 customer。”
commentable_id（数字，必填）：“客户的 id，来自 find_fieldpulse_customer 或 create_fieldpulse_customer。”
text（字符串，必填）：“来电者的需求、可服务时间以及联系方式。”

在每个工具上选择 Enable，然后以需要维修的新来电者身份测试接待员。该客户会作为潜在客户出现在 FieldPulse 中，并附有接待员的留言。

为新工作添加流程：查找来电者， 未找到则添加，然后记录通话详情。

限制

  • 工作任务需要 FieldPulse 账户中的任务类型、状态和账单详情，因此接待员不会创建任务。团队可将潜在客户转为任务。
  • 接待员无法查看技术人员的可用时间或预约时间。
  • Webhook 工具无法发送列表，因此这些工具无法为客户添加标签或自定义字段。

故障排除

问题检查项
FieldPulse 返回 401标头必须命名为 x-api-key，且包含有效密钥。
FieldPulse 返回 400查看响应中的错误列表。status 必须精确为 lead，且电话号码必须有效。
找不到已知来电者FieldPulse 会按已存储的信息匹配。请尝试来电者姓名和电话号码。
未添加留言commentable_id 必须是现有客户的 id。检查是否先运行了查找或创建工具。
FieldPulse 返回 429已达到 FieldPulse 的请求限制。请稍后重试。