跳到内容

在 Journey 中使用 Webhook 响应数据

当您映射 Webhook 响应中的值时,Pushwoosh 会将它们存储为变量,您可以在 Journey 的后续步骤中使用这些变量,就像使用Event 属性一样。

使用“更新用户资料”将 Webhook 值保存为 Tag

Anchor link to

Webhook 可以从外部系统(例如 CRM 用户 ID 或订阅状态)返回数据,而这些数据 Pushwoosh 尚未存储在用户资料中。更新用户资料 会将映射的值保存为 Tags,以便您可以在细分动态内容和后续的 Journey 步骤中使用它们。

示例:将 CRM 用户 ID 保存为 Tag

Anchor link to

新用户在您的应用中注册后,Journey 会在您的 CRM 中创建一个匹配的记录。将返回的 CRM 用户 ID 保存为 Tag,可以让您稍后(例如从另一个 Journey 或后续的 Webhook 调用中)引用或更新同一个 CRM 记录,而不是在用户每次重新进入 Journey 时都创建一个重复的记录。

Journey 流程: 基于触发器进入 → Webhook → 更新用户资料 → 退出

  1. 创建一个 Journey,在 SignUp 事件上使用基于触发器进入
  2. 在进入步骤后添加一个 Webhook 元素。为其命名(例如 Create user in CRM),并将请求 URL 设置为您的 CRM 创建用户端点。
  3. 响应映射中,将路径设置为响应中的 ID 字段(例如 data.user.id),并将属性设置为 crm_user_id
Webhook 响应映射,路径为 data.user.id,属性为 crm_user_id
  1. Webhook 步骤后添加一个更新用户资料元素。

  2. 动态 Tag 值中,点击 + 动态值。在 Tag 中,选择存储 CRM ID 的 Tag(如果需要,请提前创建)。在 Event 中,通过您给定的名称(Create user in CRM)选择 Webhook 步骤。在动态值中,选择 crm_user_id

动态 Tag 值,Tag 为 CRM ID,Event 为 Webhook 步骤,动态值为 crm_user_id
  1. 在分支的末尾添加退出
在“更新用户资料”步骤后以“退出”结束的 Journey 分支

使用“时间延迟”根据 Webhook 值安排延迟

Anchor link to

访问日期、续订截止日期和交付窗口通常存在于外部预订或计费系统中。在 Webhook 从 API 响应中映射日期后,时间延迟 可以暂停 Journey 直到那一刻,例如在预约前 2 天,以便下一条消息能准时发出。

示例:根据响应中的日期安排提醒

Anchor link to

用户在您的应用中预约。Journey 从您的预订系统中获取访问日期,并在访问前 2 天发送推送提醒。

  1. 创建一个 Journey,在 AppointmentBooked 事件上使用基于触发器进入
  2. 在进入步骤后添加一个 Webhook 元素。为其命名(例如 Get appointment details),并将请求 URL 设置为您的预订系统 API。
  3. 响应映射中,将路径设置为响应中的日期字段(例如 appointment.date),并将属性设置为 visit_date
Webhook 步骤,响应映射为 appointment.date 到 visit_date
  1. Webhook 步骤后添加一个时间延迟元素。选择基于用户/事件数据,将从…获取日期设置为 Event,将 Event 设置为您给定的名称(Get appointment details)的 Webhook 步骤,将事件值设置为 visit_date,并将延迟设置为之前 2
时间延迟配置为从 Webhook 的 visit_date 开始,偏移量为“之前 2 天”
  1. 如果用户可以在访问前不到 2 天预订,请在时间延迟元素上启用如果日期在过去或日期为空则拆分为分支。这将创建两个分支,过去将来。请参阅当日期在过去或为空时拆分分支
  2. 添加一个包含您的提醒消息的 Push 步骤。如果启用了拆分,请在两个分支中都添加此 Push过去(立即发送)和将来(在时间延迟之后)。
  3. 在每个分支的末尾添加退出
时间延迟拆分为“过去”和“将来”分支,每个分支都有 Push 和退出步骤

注意事项

Anchor link to
  • 路径语法: 使用点分隔的路径(例如 data.user.id)。不支持通配符和筛选器。有关详细信息,请参阅 Webhook 响应映射
  • 响应大小: 大于 64 KB 的响应不会被处理以进行映射。
  • 测试: 在实时 Journey 中使用映射值之前,请在 Webhook 元素中运行测试 Webhook