在Linear中设置Webhook需管理员或有“管理集成”权限者操作：进入Workspace settings→Integrations→Add integration→选择Webhook，填写HTTPS Payload URL、勾选Events、建议填Secret，保存后点击Test webhook验证成功即启用。
在Linear中设置Webhook，是为了让团队协作系统在任务状态变更、工单创建或评论更新等关键事件发生时，自动向你指定的服务器地址推送实时通知。
确认账户权限与工作区范围
只有工作区（Workspace）的管理员或拥有“管理集成”权限的成员，才能为整个工作区配置Webhook。普通成员无法看到“Integrations”设置入口，也无权添加或编辑Webhook。
登录Linear后，点击左下角头像→选择“Settings & members”→切换到“Workspace settings”选项卡→在左侧菜单中找到并点击“Integrations”。【必须在此页面操作，个人设置页或项目页均不可见Webhook入口】
创建新Webhook
在“Integrations”页面顶部，点击“+ Add integration”按钮。
从弹出列表中，直接搜索并选择“Webhook”（注意不是“GitHub”或“Slack”等其他集成）。
系统将跳转至Webhook配置表单，此时需填写三项必填内容：
-
Payload URL：你自己的接收服务地址，例如
https://your-server.com/linear-webhook。该地址必须支持HTTPS且可被Linear公网访问；HTTP地址会被拒绝保存。 -
Events：勾选你关心的触发事件。常用组合包括：
• Issue created / updated / archived
• Comment added
• Cycle updated（适用于按周期管理的团队）
• Team or project membership changed（慎选，可能产生大量通知） -
Secret（可选但强烈建议）：输入一个高熵随机字符串（如用
openssl rand -base64 32生成），用于后续校验请求真实性。Linear会在每个请求头中附带X-Linear-Signature-256签名，不填则无法验证来源合法性。
测试与启用
填写完毕后，点击右下角“Save integration”按钮。
保存成功后，页面会立即显示“Test webhook”按钮——点击它，Linear将向你填写的Payload URL发送一条模拟的issue.created事件。
如果你的服务已就绪，应能在日志中捕获到该请求，并返回HTTP 200响应；若返回4xx/5xx或超时，按钮旁会显示红色错误提示，此时请检查服务器连通性、SSL证书有效性及路由是否匹配/linear-webhook路径。
测试通过后，Webhook即自动启用，无需额外开关操作。
