---
title: "计划每次变更都发送签名 Webhook"
description: "任务一经创建、完成或移动，即可收到签名的 HTTPS 事件，范围可以是单个项目，也可以是整个工作区。"
url: https://planitude.app/zh/integrations/webhooks
language: zh-Hans
---

# 计划每次变更都发送签名 Webhook

任务一经创建、完成或移动，即可收到签名的 HTTPS 事件，范围可以是单个项目，也可以是整个工作区。

可用 · 免费，所有账户均包含 · 自动化与开发者

## 用于自定义自动化的 Webhook 和 REST API

对于没有现成集成的场景：一有变化就发送带签名的事件，并提供读写计划的 API。

### 适用场景

- 将 Planitude 连接到内部系统、ERP 或数据仓库。
- 任务一完成或移动就触发自动化。
- 从其他工具创建项目和任务，无需手动重复录入。

### 数据如何流动

**从 Planitude 到 你的系统**

- 每次变更，无论来自网页应用、API、MCP 还是导入 → 带签名的事件

**双向**

- 项目、任务、分配和依赖关系 ↔ 通过 REST API 读写

## 三步完成连接

1. **创建 API 密钥**: 在“个人资料 → API 密钥”中创建只读或读写密钥，可限定到某个工作区并设置到期日期。
2. **注册 Webhook**: 针对单个项目或整个工作区，从 14 种事件中选择：任务的创建、完成或移动，依赖关系，基准计划，评论等。
3. **接收与调用**: 验证每个事件的 HMAC-SHA256 签名，并调用以 OpenAPI 3.1 文档化的 REST API。

## 要求

- **方案**: 免费。所有 Planitude 账户都包含全部集成。
- **谁可以连接**: 每位用户使用自己的 API 密钥。项目 Webhook：所有者或编辑者；工作区 Webhook：所有者或管理员。
- **所需条件**: 一个用于接收 Webhook 的公开 HTTPS 端点；使用 API 时，需要在“个人资料 → API 密钥”中创建的密钥。

## 注意事项

- Zapier、Make 和 n8n 即将推出，并将使用同一套 API 和 Webhook。
- 密钥和已连接的应用不能删除项目或任务：删除只能在网页应用中进行。

## 指南与文档

- [Webhook：事件、签名和重试](https://planitude.app/zh/developers#webhooks): 事件目录、HMAC-SHA256 签名验证以及带重试的投递。
- [REST API：快速入门与参考](https://planitude.app/zh/developers#quickstart): API 密钥认证、速率限制、分页和 OpenAPI 3.1 参考。
- [值得与 Planitude 连接的工具：集成指南](https://planitude.app/zh/blog/planitude-integrations-guide): Planitude 的集成：Jira、Azure DevOps、Slack、Teams、日历，通过 MCP 连接 ChatGPT、Claude 和 Gemini，API 与 Webhook，.mpp 和 .xer 文件。如何选择。

## 关于 Webhook 的常见问题

### 如何确认 Webhook 确实来自 Planitude？

每个请求都带有一个包含时间戳和请求体 HMAC-SHA256 签名的请求头：使用 Webhook 密钥重新计算签名，并拒绝过旧的请求。开发者文档提供了现成的示例。

### 通过 API 的集成可以删除项目吗？

不可以。API 密钥和已连接的应用可以读取，并在拥有写入权限时创建和更新，但删除项目和任务只能在 Web 应用中进行。

### 集成需要付费吗？

不需要。所有集成都包含在免费的 Planitude 中。你只需要拥有另一款工具的账号（例如 Jira、Slack 或 Microsoft 365），并遵守其条款。

## 相关集成

- [REST API](https://planitude.app/zh/integrations/api): 读写项目和任务；附 OpenAPI 3.1 参考文档。
- [Zapier](https://planitude.app/zh/integrations/zapier): 面向数千款应用的触发器和操作。
- [Make](https://planitude.app/zh/integrations/make): 使用 Planitude 模块和即时触发器的场景。
- [n8n](https://planitude.app/zh/integrations/n8n): 社区节点，也适用于自托管的 n8n。

## 将 Webhook 连接到 Planitude

免费注册，打开项目，在 ⋯ 菜单中选择“集成”。只需两分钟。

[免费注册](https://planitude.app/zh/signup)

*文中提及的商标（Jira, Azure DevOps, Slack, Microsoft Teams, Microsoft Outlook, Microsoft PowerPoint, Microsoft Project, Visual Studio Code, Google Calendar, Gemini, Apple Calendar, ChatGPT, Codex, Claude, Cursor, Zapier, Make, n8n, Primavera）归其各自所有者所有；Planitude 与其无关联，也未获得其认可。*