> ## Documentation Index
> Fetch the complete documentation index at: https://help.teable.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# 连接器收到事件时

> 当已连接的第三方应用发生事件时运行工作流

<Note>云端版本所有方案可用；私有部署版本需要商业版及以上方案，并由部署方开启连接器事件。</Note>

把 GitHub、Gmail、Slack 这类已连接应用中发生的事情作为工作流的起点，例如收到新邮件、仓库有新 Issue、频道有新消息。事件由应用直接送到 Teable，不需要自己搭建 Webhook 地址，也不需要定时去查。

## 用 AI 创建

打开表格右侧边栏的 AI 对话，描述你的需求。

AI 会为你处理一切：选择合适的触发器，映射相关字段，自动设置所有操作。

只需描述一次目标，工作流即刻就绪，无需手动配置。

**示例：** *"GitHub 仓库有新 Issue 时，在任务表里建一条记录"*

## 如何设置

<Steps>
  <Step title="选择触发器">
    新建工作流，触发器选择 **当连接器收到事件时**。
  </Step>

  <Step title="选择应用和事件">
    在 **应用** 中选择要监听的应用，再在 **事件** 中选择具体事件。事件列表里每一项都有一句说明和标记，标记的含义见下文。
  </Step>

  <Step title="选择账号">
    在 **账号** 中选择用哪个已连接账号接收事件。还没连接过这个应用时，在同一个下拉里连接一次，连接完成后会自动授权给当前工作流。
  </Step>

  <Step title="填写参数">
    按事件的要求填写 **参数**，例如具体的仓库、频道或标签。带 \* 的为必填，填完点击 **保存**。
  </Step>

  <Step title="启用">
    添加后续操作，然后开启工作流。订阅在工作流启用时才建立，草稿状态不会收到事件。
  </Step>
</Steps>

更换应用或事件时，后面的步骤会被清空，引用原事件的变量也不再可用，需要重新配置。

## 事件标记

| 标记               | 含义                               |
| ---------------- | -------------------------------- |
| **即时**           | 应用主动推送，事件发生后很快送达                 |
| **轮询 · 可能延迟数分钟** | Teable 定期去应用查询，对时效要求高的流程不要依赖这类事件 |
| **触发频繁**         | 这个事件在实际使用中触发次数很多，每次触发都计入自动化运行次数  |
| **已废弃**          | 应用已废弃此事件，之后可能不再推送，请改选其他事件        |

## 触发后可用的数据

事件原文放在 **event** 变量里，后续步骤通过 **+** 插入。配置完成时变量里还没有 event，需要先收到一个真实事件：点击 **测试触发器**，面板显示 **等待事件中**，这时到应用里做一次会触发该事件的操作。轮询类事件可能要等几分钟。

收到的事件会作为示例数据留在触发器上，后续步骤即可引用它的字段。不想继续等待时点击 **停止等待**；等待约 30 分钟仍未收到，面板会显示 **已停止等待，未收到事件**。

## 连接断开时

账号授权被撤销、已连接账号被移除、应用停止了这个订阅（凭据过期或订阅不健康），或者订阅创建失败时，触发器会停止接收事件。工作流的开关不会被关闭，但在恢复之前不会再产生新的运行。

Teable 会给最后修改这个工作流的成员发送通知，触发器面板顶部也会显示 **已断开，请重新授权该应用或重新选择账号**。按情况恢复：

* 在 **设置** → **集成** 中对同一个账号点击 **重新连接**，订阅会自动重建。
* 改用别的账号时，回到触发器重新选择 **账号** 并保存。
* 订阅创建失败时，检查参数后重新保存即可重试。

## 复制或导入之后

凭据不随工作流复制。复制工作流、导入或复制项目之后，触发器上会出现 **账号未授权**，需要重新选择一个自己的账号并保存，工作流才能重新订阅。

## 相关文档

* [凭据与集成](/zh/basic/credential)
* [例行任务](/zh/basic/ai/routine)