工作流触发器

工作流触发器

触发器是将启动工作流的事件。 每个工作流必须以触发器开始，并且只能有一个触发器。 所有触发器都是由条件定义的。 只有在满足所有条件时，触发器才会触发并启动工作流。

通过选择触发器并进行相应配置开始创建您的工作流。

重要：不支持基于时间或计划的触发器，例如在下午6:30、每天的固定时间或特定日期触发工作流。

以下是可用触发器的列表：

在指定触发器后，继续进行 步骤配置。 选择任意可用的步骤。

高级设置

每个触发器设置的底部都有一个高级设置切换按钮，用于指定每个联系人触发一次（手动触发器除外）。 这限制了联系人重复此工作流程，因此他们只能经历一次工作流程。

当切换开关处于开启状态时，先前已加入此工作流的任何联系人都不会触发工作流，即使发生时条件设置为关闭。

触发器的配置

每个工作流都必须以触发器开始，并且只能有一个触发器。 当满足触发条件时，工作流将在触发联系人上按顺序执行。

触发器：对话已开启

当与联系人的对话开始并且所有触发条件都满足时启动工作流。

配置

此工作流的触发条件仅限于源，它标识对话是如何开启的。 如果没有添加条件，则只要打开对话，工作流就会触发，无论来源如何。

来源如下：

对于每个源，最多允许 10 个条件，使用 AND 或 OR 逻辑运算符。 每个条件都需要有自己的来源、运算符和值。

触发变量

对话打开触发器的所有触发变量都反映与对话相关的信息，例如对话中第一条传入的消息。 了解更多关于 会话开启触发器的触发变量 的信息。

触发器：对话已关闭

向对话结束触发器添加条件是可选的。 如果没有添加条件，则只要关闭对话，工作流就会触发，无论来源如何。

当与联系人的对话结束且所有触发条件都满足时启动工作流。

配置

已关闭对话有两种可能的触发条件：来源，用于标识谁关闭了对话；类别，用于标识对话的分类。

如果以下来源关闭对话，则会触发此工作流程：

通过合并联系人结束的对话不会触发工作流。

如果与指定类别相关的对话关闭，也会触发此工作流。 这些类别在 工作区设置 > 对话 中管理。 在工作流中，它们将作为下拉菜单中的选项出现。

对于每个来源和类别，最多允许 10 个条件，使用 AND 或 OR 逻辑运算符。 每个条件都需要有自己的来源、运算符和值。

触发变量

对话结束触发器的所有触发变量都反映与对话相关的信息，例如对话解决时间、首次响应时间和对话的结案摘要。 了解更多关于 会话关闭触发器的触发变量 的信息。

触发器：联系人标签已更新

当向联系人添加或从联系人中删除指定的标签时启动工作流。

配置

要配置此工作流，请选择一个将充当触发器的操作。 选项是当向联系人添加标签时或当从联系人中删除标签时。

接下来，选择将作为工作流启动所需满足的条件的标签。

使用标签或自定义字段导入联系人不会自动触发工作流。 导入后要激活工作流，需要执行辅助操作。 有关导入后启动工作流的更多信息，请参阅我们的开发人员 API 或集成工具（如 Make/Zapier）。

触发器：联系字段已更新

当指定的联系人字段更新时启动工作流。

配置

任何联系人或自定义字段都可以配置为此工作流的触发器。 选择将作为此触发器条件的联系人字段。 对此字段的任何更新都将启动工作流。

使用标签或自定义字段导入联系人不会自动触发工作流。 导入后要激活工作流，需要执行辅助操作。 有关导入后启动工作流的更多信息，请参阅我们的开发人员 API 或集成工具（如 Make/Zapier）。

触发器：快捷方式

从 Inbox 模块中的快捷菜单启动选定的工作流程。

工作原理

快捷方式是指使用触发器“快捷方式”创建的工作流。 此功能允许用户启动具有快捷方式作为触发器的工作流，而无需离开 Inbox 模块。

在 Inbox 模块中，单击消息编写器工具栏上的快捷方式图标。 这将打开快捷方式菜单，其中显示工作区中发布的所有快捷方式。 选择所需的快捷方式来启动其工作流程。

如果工作区中没有创建和发布快捷方式，则快捷方式图标将被禁用。

如果您不希望代理发起快捷方式，请在 工作区用户设置下的高级限制设置 中禁用它。

配置

您可以使用单独的图标、名称和描述来配置快捷方式。 当快捷方式菜单打开时，将显示这些内容，以便您轻松识别和选择所需的快捷方式。

快捷表单

在快捷方式触发器的配置抽屉中，您可以选择创建快捷方式表单。 只要触发快捷方式，表单就会打开。 仅当用户填写完表格后，工作流程才会启动。

快捷方式表单可以自定义表单字段来输入数据或注释。 填写的值可以保存为变量并在工作流中使用。

要添加表单字段：

1. 单击 + 添加表单字段 按钮。

2. 命名表单字段。 例如订单 ID、退款原因。

3. 选择字段类型。 可用的字段类型有：

• 文本

• 列表（下拉列表）

• 复选框

• 数字

• 日期

• 时间

• 电话号码

• 电子邮件

• URL

4. 为该字段命名变量。

5. 在工作流步骤中使用输出变量。 了解更多关于 输出变量的信息。

6. 通过将 Required 开关切换为 ON，根据需要设置表单字段。 这使得代理必须填写数据或评论。

触发器：传入 Webhook

当第三方应用程序发生特定事件并通过 HTTP 请求发送信息时，启动工作流。

此触发器适用于 高级计划及以上。

配置

一旦选择此触发器，将为您每个工作流自动生成一个唯一的 webhook URL。 您将向此 URL 发送 HTTP POST 请求以最终触发工作流。

然后，您需要在有效负载中提供与所选联系人标识符类型匹配的值的 JSON 路径/引用。 例如，如果有效负载为 `{"email":"user@example.com"}` 且标识符类型为 Email，则输入 `$.email`。

主要有三种联系人识别类型（我们如何识别联系人）：

• 联系人 ID

• 电子邮件

• 电话号码

您还可以将参数存储在传入的 webhook 负载中，作为变量，以便根据您的使用情况在工作流的其他步骤中使用它们。

要求：

• JSON Key 字段必须包含要使用的值的 JSON 路径/引用，且必须以负载根节点的 `$` 开头。 例如，对于 `{"contactID":123}`，请输入 `$.contactID`，而不是 `contactID`。

• 相同的 JSON 键不能保存两次；它必须是一个定义值（不是对象或数组）。

• JSON 键的最大字符限制为 500。

您将通过将 JSON 路径映射到一个变量来完成该过程。变量在文本中必须是唯一的，并且最大字符限制为 30。 最多允许 10 个变量。 请注意，只能保存 JSON 主体。

示例

如何使用 JSON 路径为不同负载格式填写 JSON Key 字段：

{   
    "name": "杰森",   
    "zip\_codes": "12345",   
    "phone": "123123"   
}

要将电话号码保存在上述 JSON 正文中，请使用 $.phone 作为 JSON 键。

{   
    "custom\_fields": {   
        "firstName": "约翰",   
        "lastName": "Doe",   
        "locale": "en\_GB",   
        "timezone": "5",   
        "gender": "男",   
        "phone": "123123",   
        "email": "zy@respond.io",   
        "customerid": "1"  
    },   
    "created\_at": 1575618542  
}

要将电话号码保存在上述 JSON 正文中，请使用 $.custom_fields.phone。

{  
        "data": {  
            "id":"1776025372480910",  
            "contacts" : \[  
                {  
                    "firstName":"John",  
                    "lastName":"Doe",  
		    "locale": "en\_GB"  
                },  
                {  
                    "firstName":"Jane",  
                    "lastName":"Doe",  
		    "locale": "en\_GB"  
                }    
	    \]  
        }  
    }

要将名字 'Jane' 保存在上述 JSON 正文中，请使用 $.data.contacts[1].firstName。

触发器：Meta 点击聊天广告

当点击 Facebook 广告或收到与广告相关的消息时启动工作流。

配置

选择此触发器后，连接您的 Facebook 帐户以进行配置。

连接到 Facebook 后，选择您希望触发器链接到的广告帐户和相关广告。

这里只能选择在广告管理器中创建和管理的广告。 如果您在 Meta 应用程序内创建了广告，例如 Meta Business Suite 或 Instagram，它们将不会在此处列出以供选择。

广告选择

选择 所有广告 以应用于 所选广告帐户中的所有当前和未来广告。

• 要启用此功能，请从新分段控制按钮中选择 “所有广告” 选项。

• 选择此选项后，工作流将自动触发所选广告帐户中管理的所有广告，包括将来添加的任何广告。

如果您希望定位特定广告，请选择 “选定广告” 选项从下拉菜单中手动选择广告。

触发变量

当触发 Meta 点击聊天广告时，respond.io 会从广告中检索 元数据 并将其存储在 触发变量 中。 这些变量对于个性化消息、路由线索和将活动数据传递给外部工具非常有用。

可用变量：

注意： 这些变量可能会根据从 Meta 收到的元数据返回 null。 它们仅在广告触发后的工作流执行期间可用。

如何使用

通过使用美元符号 $ 引用，在工作流步骤中使用任何变量。 例如:

• 发送个性化消息：嗨！ 感谢您点击我们的 $clicktochat.ad_name 广告！

• 将广告系列名称添加到 Google 表格

• 根据广告系列或广告组分支工作流

触发器：TikTok 消息广告

当点击 TikTok 广告或收到与广告相关的消息时启动工作流。

配置

选择此触发器后，在集成中连接您的 TikTok 广告帐户进行配置。

连接到 TikTok 后，选择您希望触发器链接到的广告帐户和相关广告。

这里只能选择在 TikTok 广告管理器中创建和管理的广告。

广告选择

选择 所有广告 以应用于 所选广告帐户中的所有当前和未来广告。

• 要启用此功能，请从新分段控制按钮中选择 “所有广告” 选项。

• 选择此选项后，工作流将自动触发所选广告帐户中管理的所有广告，包括将来添加的任何广告。

如果您希望针对特定广告投放，请选择“已选广告”选项，然后分别为每个目标选择广告：TikTok Messaging Ads (Messenger)、TikTok Messaging Ads (WhatsApp)和TikTok Messaging Ads (TikTok DM)。

触发变量

当 TikTok 广告互动触发工作流时，respond.io 会检索有关广告的 元数据 并将其存储在 触发变量 中。 这些变量可在整个工作流中用于个性化、路由逻辑以及与外部工具（例如 Google 表格）的集成。

可用变量：

注意：并非所有变量都适用于每次广告互动。 如果 TikTok 未提供该信息，这些变量可以返回 null。

如何使用

在任何工作流步骤中，通过在变量名前加美元符号 $ 来引用这些变量。 例如:

• 添加标签：$tiktokmessagingad.ad_campaign_name

• 更新自定义字段

• 通过 HTTP 请求或 Google 表格将元数据传递给外部应用程序

触发器：手动触发器

手动触发器无法单独工作。 它只能通过触发另一个工作流步骤或 AI Agent 触发工作流操作来运行。

了解有关 触发另一个工作流步骤 和 AI Agent 触发工作流操作 的更多信息。

如果您将两个或多个工作流连接在一起并使用触发另一个工作流步骤，则可以在连接到原始工作流的工作流中使用手动触发器。 这意味着连接的工作流仅在联系人通过触发另一个工作流步骤进入工作流时生效。

如果某个工作流仅由 AI Agent 触发，建议使用手动触发器作为触发方式。

配置

假设工作流 A 是使用手动触发器创建的，并且它连接到工作流 B。工作流 A 仅在工作流 B 发布时触发，且联系人将通过触发另一个工作流步骤进入工作流 A。

触发器：生命周期已更新

生命周期更新触发器会在每次联系人生命周期阶段变化时启动工作流。 这使您能够根据联系人在销售阶段的进展自动执行操作，例如潜在客户资格认定、跟进或客户保留工作。

配置

在设置中启用生命周期

确保在您的工作区设置中启用了生命周期功能。 如果未启用生命周期，您需要在配置此触发器之前将其开启。

选择生命周期阶段

在选择此触发器后，选择将启动工作流的生命周期阶段。

• 所有阶段：只要联系人的阶段更新，无论具体阶段如何，便会触发工作流。

• 特定阶段：仅当联系人的阶段更新到一个或多个选择的阶段时才会触发工作流。 您可以根据需要选择一个或多个阶段。

配置高级设置（可选）

• 清除时触发：可选，启用此设置以在联系人的生命周期阶段被清除时触发工作流，不留任何分配的阶段。

• 每个联系人触发一次：启用后，确保每个联系人仅触发一次工作流，即使他们重新进入选定的阶段。

使用我们的 Google Sheets 模板 捕获关键数据并通过更新生命周期步骤跟踪转化率。

触发器：通话结束

当通话结束且所有触发条件满足时，启动工作流。 此触发器适用于呼入和呼出通话。

配置

您可以在触发器级别使用两种条件类型来筛选何时触发工作流。

通话事件

按通话结果筛选：

通话渠道

按通话发生的渠道筛选。 从已连接且支持通话的渠道中选择一个或多个。

如果未添加任何条件，则只要任何通话结束，无论结果或渠道如何，工作流都会触发。

触发变量

当“通话结束”触发器触发时，以下变量可用于分支条件和后续步骤：

注意：通话逐字稿不可作为此触发器的工作流变量使用。