---
title: "Webhooks"
description: "入站 webhook 让另一个系统代表员工提交表单。Webhooks 视图列出每个 webhook 及其端点；打开一个查看它的密钥状态和日志。"
sidebar:
  label: 概览
  order: 0
area: settings
feature: webhooks
appPath: /settings/general/webhooks
lastVerified: 2026-11-15
version: "2026-11-10"
audience: admin
related:
  - settings/webhooks/create-a-webhook-secret
  - flows/forms
  - notices
intercom:
  - id: "16858360"
    title: Create a Webhook (Pyn 2)
    url: https://intercom.help/pyn/en/articles/16858360-create-a-webhook-pyn-2
    note: draws on
translation:
  source: settings/webhooks/index.mdx
  sourceSha: dd1218d30155660a0b00aca101164f1e7fc0f495
---

入站 webhook 是另一个系统向其发送 JSON 的地址。每个 webhook 属于一个表单：到达的负载成为该表单的一次提交，归属于负载所指定的员工，而这次提交可以触发自动化流程。Webhook 在表单上创建，在它的 **Webhook** 侧面板中；Settings 把它们全部列在一个地方。

![Settings > General > Webhooks lists every inbound webhook created on a form.](https://support.pyn.ai/media/settings/webhooks/settings-webhooks-list.png)

## Webhook 的工作方式

- 端点是 `POST /api/webhook/<webhook id>`，带有请求头 `Authorization: Bearer <secret>` 和一个 JSON 正文。面板显示要发送的 **URL** 和 **Header**：“Post a JSON body here, with the secret as a bearer token.”
- 正文用 `subject_id` 指定员工，答案放在 `fields` 下。表单的 **Subject** 设置说明这个 id 来自哪个源系统，例如 BambooHR 员工 id。
- 每次调用一经接受就以 `202` 应答；**History** 标签页记录每个负载的最终结果。条目带有一个代码，例如 `submitted`、`unknown-subject`、`missing-fields`、`invalid-fields`、`ambiguous-fields` 或 `already-submitted`。
- 发送一个 `Idempotency-Key` 请求头让重试变得安全：同一个键的重复请求会再次以 `202` 应答，但不会被第二次处理。
- Pyn 无法接收的负载会在[通知](https://support.pyn.ai/zh-cn/notices/)中发出一条通知；调用方重复同一个错误只会更新一条通知，而不是发出许多条。管理员也可以收到电子邮件；见[设置通知电子邮件](https://support.pyn.ai/zh-cn/settings/notifications/)。
- Webhook 在拥有密钥之前不接受任何内容，已归档的 webhook 停止接受负载。

## 你可以在这里做什么

- [创建或替换 webhook 密钥](https://support.pyn.ai/zh-cn/settings/webhooks/create-a-webhook-secret/)
- 从 webhook 的面板重命名它：编辑 **Title**，然后按 Enter 或点击其他位置保存
- 查看负载的 **History**，并从表单的 Webhook 侧面板把整个日志导出为 CSV
- 从 webhook 的 **...** 菜单归档它

## 在应用中的位置

在 Pyn 中打开 `/settings/general/webhooks`，或打开主导航中的 **Settings**，然后选择 **General** 下的 **Webhooks**。要创建 webhook，在[表单](https://support.pyn.ai/zh-cn/flows/forms/)中打开该表单，选择侧栏中的 **Settings**，然后选择 **Add Webhook**。

## 相关

- [创建或替换 webhook 密钥](https://support.pyn.ai/zh-cn/settings/webhooks/create-a-webhook-secret/)，在第一个负载到达之前。
- [表单](https://support.pyn.ai/zh-cn/flows/forms/)，创建 webhook 并选择它的主体。
- [通知](https://support.pyn.ai/zh-cn/notices/)，了解 Pyn 无法接收的负载。
