如何把 iPhone 短信转发到 Webhook

更新于

由 Fwrd 直接发送

你自己的 HTTPS 端点

把选定的 iPhone 信息发送到你掌控的 HTTPS 端点。

这个转发目标如何工作

只要该转发目标在 Fwrd 中处于启用状态,Fwrd 就会通过 HTTPS 把每条符合条件的短信从 iPhone 直接发送到这个转发目标。

把 iPhone 短信转发到 Webhook:概览与常见问题

开始之前

  • 一个你拥有或获授权使用的 HTTPS 端点
  • 端点接受 JSON POST,并以 2xx 状态码响应
  • 在接收信息的 iPhone 上安装 Fwrd
本指南使用的配置:HTTPS 端点 URL

设置转发目标

9 个步骤

这些步骤中用到的 Fwrd 设置流程需要 iOS 27。在 iOS 26 上,请按“自己动手创建”下的步骤添加该转发目标(Webhook)。

  1. 接受 Fwrd 的请求

    Fwrd 发送一个 POST 请求,JSON 正文里把原始短信文字放了两次,分别在 content 字段和 text 字段,所以读取其中任何一个的服务都能拿到。如果你在 Fwrd 的“设置”中打开“附上发件人”,并在快捷指令里为 Fwrd 的动作选取“发件人”,正文里还会有 sender 字段。以任意 2xx 状态码响应,即视为已送达。重定向会被拒绝,所以请提供最终地址。

    {"content": "Your message", "text": "Your message"}
  2. 忽略重复的重试

    如果请求失败,Fwrd 可能会再试一次。同一条信息的每次尝试都带有相同的 Idempotency-Key 请求头,所以你的端点可以丢弃重复的请求。

  3. 保密你的 URL

    Fwrd 不会添加身份验证请求头。如果你的端点需要密钥,请把它放进 URL 里。Fwrd 会把整个地址存在 iPhone 的钥匙串中。

  4. 在 Fwrd 的设置流程中选取 Webhook

    在 iPhone 上,打开 Fwrd,在介绍页的最后轻点“设置转发”。当它询问短信要发到哪里时,选取 Webhook。

  5. 把 URL 粘贴到 Fwrd 中

    把整个 HTTPS 地址粘贴到“Webhook URL”,然后继续。

    “Webhook URL” ← 你的 HTTPS 端点
  6. 添加现成的快捷指令

    选择要转发的短信。轻点“获取快捷指令”。在“快捷指令”中,轻点“添加快捷指令”,然后轻点左上角的“◀ Fwrd”。

  7. 将它打开

    轻点“打开快捷指令”。在“快捷指令”中,轻点“编辑”,再轻点“我收到符合以下条件的信息时”后面的 ›(不是 ×),然后打开“自动化”。

  8. 允许第一次运行

    Fwrd 会用一条示例短信运行一次这个快捷指令,这会算作一条转发。第一次运行时,“快捷指令”会询问两次:先轻点“允许”,再轻点“始终允许”。

  9. 一切就绪

    这就完成了。符合条件的新短信现在会自动发送到你的端点,无论 iPhone 是否处于锁屏状态。iPhone 重新启动后,解锁一次,转发就会继续。

自己动手创建

在 iOS 26 上,或想自己动手创建自动化时,请改按下面的步骤操作。 如果 Fwrd 已经在向别处转发,保存 Webhook 后就到此为止:你的自动化会发送到每个已启用的转发目标。

观看设置过程

在 iOS 27 上,Fwrd 和“快捷指令”中的每一步操作,用时不到一分钟。可在任意一步暂停,或在下方选择一步直接跳转。

在装有 Fwrd 1.1 的 iOS 27 上演示。地址和号码均为示例。

  1. 在 Fwrd 中添加 Webhook

    在 iPhone 上,打开 Fwrd,轻点屏幕底部的 +,然后选取 Webhook。你可以重命名它,以便区分各个转发目标。

  2. 把 URL 粘贴到 Fwrd 中

    把整个 HTTPS 地址粘贴到“配置”栏。

    “配置” ← 你的 HTTPS 端点
  3. 保存,并保持转发目标已启用

    轻点“发送测试信息”,然后轻点右上角的 ✓ 保存。如果 iOS 提示保存密码,轻点“以后”:Fwrd 已把它存在 iPhone 的钥匙串里。保持“启用转发目标”打开。未启用的转发目标仍保存在 iPhone 上,但信息到达时会被跳过。

    “启用转发目标” ← 打开
  4. 创建“信息”自动化

    在接收短信的 iPhone 上,打开“快捷指令”。在 iOS 27 上,前往“资料库”>“自动化”并轻点 +。如果看到“描述快捷指令”,请轻点“编辑”。轻点“自动化”,然后选取“信息”,并把“发件人”改为“信息”。键入你的短信里含有的一个词,比如 code 或 verification:按信息内容匹配能捕获短号码和你的联系人之外的发件人,而“发件人”做不到。然后轻点触发条件旁的箭头,检查“运行前确认”是否关闭。在 ⓘ 下的“隐私”中,检查“锁定时允许运行”是否打开。在 iOS 26 上,轻点“自动化”,再轻点 +,然后选取“信息”,并选取“立即运行”。

    “信息 包含” ← 你的词 · “运行前确认” ← 关闭 · “锁定时允许运行” ← 打开
    已用箭头展开的触发条件步骤:“自动化”处于打开状态,“运行前确认”处于关闭状态
  5. 添加 Fwrd 的“转发信息到所有目标”动作

    搜索“转发”,把 Fwrd 的“转发信息到所有目标”添加到触发条件下方。轻点其中的“信息”,轻点“选择变量”,然后选取“输入快捷指令的信息”;快捷指令会在顶部添加一个“从 … 接收 …”块,这没问题。轻点返回即可保存。在 iOS 26 上,先轻点“创建新快捷指令”,再添加这个动作:它的“信息”会自动填入“输入快捷指令的信息”。轻点“完成”。

    “信息” = “输入快捷指令的信息”
    Fwrd 的动作,显示为“Forward Shortcut Input to all destinations”,顶部添加了“从 … 接收 …”块
  6. 一切就绪

    这就完成了。符合条件的新短信现在会自动发送到你的端点,无论 iPhone 是否处于锁屏状态。iPhone 重新启动后,解锁一次,转发就会继续。

“快捷指令”的屏幕在 iOS 26 和 iOS 27 之间有所不同。自动化指南两个版本都会逐步讲解。

如果信息没有送达

Fwrd 会把这次尝试标为“失败”
你的端点必须在 15 秒内以 2xx 状态码响应。Fwrd 不会跟随重定向,所以请使用最终地址。
同一条信息收到了两次
请求失败或超时时,Fwrd 会重试。请丢弃 Idempotency-Key 已经见过的请求。
内容和我预想的不一样
Fwrd 发送的 JSON 包含 content 和 text 两个字段,两者都是原样的短信文字。没有时间戳,也没有标题。只有当你在 Fwrd 的“设置”中打开“附上发件人”,并在快捷指令里为 Fwrd 的动作选取“发件人”时,才会添加 sender 字段。

适用于每个转发目标的问题,比如短信始终不触发自动化,都在疑难解答指南里。

常见问题

须知

请让接收短信的 iPhone 保持开机并联网。重新启动后,解锁一次,转发就会继续。每次转发都会列在 Fwrd 的“活动”里。