# Jellyseerr / Overseerr 接入 Server酱：求片请求与可用状态推送到微信（2026 教程）

> 通过 Webhook 将 Jellyseerr/Overseerr 的求片请求、批准及影片可用通知推送到微信，自定义 JSON 模板直连 Server酱 API。

- 网页版：https://sct.ftqq.com/docs/integrations/jellyseerr/
- 更新日期：2026-07-17

# Jellyseerr / Overseerr + Server酱：求片与可用状态推送到微信

> 效果：当有新的求片请求、请求被批准或影片可用时，自动推送到微信

## 前置条件

- 获取 Server酱 SendKey（[30 秒获取教程](https://sct.ftqq.com/docs/getting-started/sendkey/)）
- 拥有 Jellyseerr 或 Overseerr 的管理员权限

## 配置步骤

在 Jellyseerr / Overseerr 的通知设置中，通过自定义 Webhook 直连 Server酱 API。

1. **填写 Webhook URL**

   进入 Settings → Notifications → Webhook，在 Webhook URL 中填入对应版本的 API 地址：

   - Server酱：`https://sctapi.ftqq.com/你的SENDKEY.send`
   - Server酱³：`https://你的UID.push.ft07.com/send/你的SENDKEY.send`（UID 为 SendKey 中 `sctp` 与 `t` 之间的数字）

2. **配置 JSON Payload 模板**

   在 JSON Payload 模板框中填入以下内容，将 Jellyseerr/Overseerr 内置变量映射为 Server酱 所需参数：

   ```json
   {
     "title": "{{subject}}",
     "desp": "{{message}}"
   }
   ```

3. **启用通知事件**

   勾选需要推送的通知类型（具体类型以应用内实际显示为准），保存设置即可。

## 完整示例

在终端中使用以下命令测试 API 连通性，确认 SendKey 有效且微信能收到推送：

```bash
curl -X POST "https://sctapi.ftqq.com/你的SENDKEY.send" \
  -H "Content-Type: application/json" \
  -d '{"title":"测试求片通知","desp":"这是一条测试消息"}'
```

## 常见问题

**消息没有收到怎么办？**

检查 Webhook URL 中的 SendKey 是否正确，确认对应的通知事件已在设置中勾选。如仍无法解决，请查看[常见问题与排查](https://sct.ftqq.com/docs/getting-started/faq/)。

**每天可以发送多少条通知？**

免费版每日可发送 5 条，每分钟上限 50 条；订阅会员目前特价最低 3 元/月，一天最多可发 1000 条（[价格详情](https://sct.ftqq.com/subscribe)）。

**可以推送到企业微信、钉钉或飞书吗？**

可以，在 Server酱 后台配置对应的消息通道即可，详见[通道对比](https://sct.ftqq.com/docs/getting-started/channels/)。

**Server酱³ 的 UID 怎么获取？**

UID 即 SendKey 中 `sctp` 与 `t` 之间的数字，从您的 SendKey 中提取即可。

## 相关集成

- [青龙面板任务通知](https://sct.ftqq.com/docs/integrations/qinglong/)
- [Uptime Kuma 宕机告警](https://sct.ftqq.com/docs/integrations/uptime-kuma/)
- [Python 脚本推送](https://sct.ftqq.com/docs/integrations/python/)


## 懒人方案：把这段话复制给你的 AI 助手

把下面这段文字原样粘贴给 Claude Code、Cursor 或任何 AI 编程助手，它就会替你完成 Server酱 的接入：

```text
请帮我把 Server酱 微信通知接入到我当前的项目/工具中：
1. API：POST https://sctapi.ftqq.com/{SendKey}.send，参数 title（必填，不能含换行）、desp（正文，支持 Markdown，可选）；成功时返回 JSON 的 code 为 0。
2. 如果我的 SendKey 以 sctp 开头，则改用 https://{uid}.push.ft07.com/send/{SendKey}.send，uid 是 SendKey 中 sctp 与 t 之间的数字。
3. SendKey 从环境变量 SERVERCHAN_SENDKEY 读取；如果没有，提醒我到 https://sct.ftqq.com 免费获取（每天 5 条额度）。
4. 安全要求：不要把 SendKey 硬编码进代码、不要打印到日志、不要提交到 git。
5. 频率约定：任务结束发 1 条结果摘要即可，批量任务合并成一条，不要每步都推。
请根据我当前的项目和场景直接写好代码/配置并验证。
```