PinRide 短信提醒开通指南（给 Terry 的新手版）
价格核对时间：2026-10-10（美东时间）。来源：Twilio 官网美国短信价格页（页面写着“价格截至 2026 年 8 月”）、Twilio 10DLC 官方说明及其帮助文档。价格会变，开通前请再看一眼官网。
一、先说结论（30 秒看懂）
- 推荐 Twilio：全球最常用、文档最多、按条付费、没有月度合同。PinRide 网站已经写好了 Twilio 的对接代码，你只需要拿到 3 样东西填进去：Account SID、Auth Token、发信号码（或 Messaging Service SID）。
- 美国手机号发短信，必须做 A2P 10DLC 登记（运营商要求，防垃圾短信），否则短信会被拦截或加收费用。
- 预算（小流量，每月几百到一千条）：一次性约 $20，之后每月约 $3–5 + 每条约 1.2–1.3 美分。
- 不想做 10DLC 的话，可以用 Toll-Free（800/888 等免费号）+ 免费号验证，审核几天到两周。
二、费用明细（Twilio，美国）
| 项目 | 价格 |
|---|---|
| 本地号码（10 位长号码） | 约 $1.15 / 月 |
| 每条短信（160 个英文字符为 1 段；中文约 70 字为 1 段） | $0.0083 / 段 |
| 运营商附加费（每段） | AT&T $0.0035；T-Mobile $0.0045；Verizon 约 $0.0045–0.005；其他约 $0.004 |
| 发送失败处理费 | $0.001 / 条（只对失败的） |
| 10DLC 品牌登记（个人 Sole Proprietor 或小流量企业） | $4.50 一次性 |
| 10DLC 品牌登记（标准企业，含审核） | $46 一次性 |
| 10DLC 活动（Campaign）审核 | $15 一次性 |
| 活动月费 | 小流量混合 $1.50/月；个人 $2/月；标准 $10/月 |
举例：每月 1000 条中文提醒（每条 1 段）≈ 1000 × (0.0083 + 0.0045) ≈ $12.8/月，加号码 $1.15 + 活动 $1.5–2 ≈ 每月 $15–16。第一个月再加一次性 $19.50。
三、选哪种登记方式？
| 你的情况 | 选择 |
|---|---|
| 有美国公司/EIN（税号） | Low-Volume Standard Brand（小流量标准品牌，$4.50）+ Low-Volume Mixed 活动（$1.50/月） |
| 没有 EIN，是个人，有美国或加拿大地址和手机号 | Sole Proprietor（个人，$4.50，每天最多约 1000 条到 T-Mobile） |
| 不想做 10DLC | 买 Toll-Free 号码并提交 Toll-Free Verification（免费审核） |
PinRide 是公益互助平台；如果以后注册了非营利组织（501(c)(3)），可申请慈善类活动（$3/月）。
四、一步一步开通 Twilio
- 注册账号：打开 https://www.twilio.com/try-twilio ，用邮箱注册，验证邮箱和手机号（中国 +86 手机号也可以收验证码）。
- 试用账号：注册后是试用模式，有少量免费额度，只能发给你自己验证过的手机号，短信前面会带“Sent from your Twilio trial account”。先用它测试。
- 升级付费：Console 右上角 → Upgrade，绑定 Visa/Mastercard 等国际信用卡，先充值 $20 即可。
- 买号码：Console → Phone Numbers → Buy a number → 国家选 United States，勾选 SMS → 选一个号码（例如 413 开头的麻省号码）→ Buy。
- 做 A2P 10DLC 登记：Console → Messaging → Regulatory Compliance（或 Trust Hub）→ A2P 10DLC：
- 填品牌资料：公司名/个人姓名、EIN（如有）、地址、网站 https://pinride.org 、联系邮箱电话。
- 创建 Campaign：用途选 “Account Notifications” 或 “Low Volume Mixed”；描述写清楚：“PinRide 用户在网站设置里主动开启短信后，接收行程留言和私信提醒。”
- 示例短信：
[PinRide] 您的行程 Amherst → Boston 有新留言 https://pinride.org/?ride=... - 用户同意方式（Opt-in）：“用户登录后在‘通知设置’中勾选短信提醒并填写手机号”；退订方式：回复 STOP。
- 审核一般几天到 2–3 周。
- 建 Messaging Service（推荐）：Console → Messaging → Services → Create，把买的号码加进去，把 Campaign 关联上。记下 Messaging Service SID（MG 开头）。
- 拿到密钥：Console 首页（Account Info）可以看到 Account SID（AC 开头）和 Auth Token（点眼睛图标显示）。Auth Token 等于密码，不要发微信群、不要截图外传。
五、填进 PinRide 网站
文件位置（服务器 214）：/var/www/pinride-11/backend/.env，改这几行：
SMS_ENABLED=true
SMS_PROVIDER=twilio
TWILIO_ACCOUNT_SID=AC开头的那串
TWILIO_AUTH_TOKEN=你的Auth Token
TWILIO_MESSAGING_SERVICE_SID=MG开头的那串 # 推荐；或者填下面一行
TWILIO_FROM=+14135550123 # 只有不用 Messaging Service 时才填
改完执行：sudo systemctl restart pinride11
不会改？ 把这些信息用安全方式交给技术助手（例如 1Password/Bitwarden 分享链接、或当面），不要直接贴在聊天群里，由助手帮你填写并重启。
六、测试
- 登录 https://11.pinride.us → 点右上角 🔔 → “设置” → 打开“短信提醒”，填自己的手机号（+1 开头），保存。
- 用另一个账号给你发一条私信，或在你发布的行程下留言。
- 手机应在几秒内收到
[PinRide] ...短信。没收到就看 Twilio Console → Monitor → Logs → Messaging 的错误码（例如 30034 = 号码未完成 10DLC 登记）。
七、在中国的用户怎么用 Twilio
- 可以在中国注册和登录 Twilio，Console 网页有时较慢，可耐心等待或换网络。
- 付款需要国际信用卡（Visa/Mastercard/银联双币卡一般可以）。
- Sole Proprietor 个人登记要求美国或加拿大的地址和手机号；没有的话需要用美国公司（EIN）走 Low-Volume Standard，或用 Toll-Free 号码验证。
- 收信方是美国手机号就按美国价格计费；发给中国 +86 手机号价格不同（且国内运营商要求签名报备，到达率不稳定），发国内手机建议用阿里云/腾讯云。
八、其他选择
| 服务商 | 适合 | 说明 |
|---|---|---|
| Vonage（原 Nexmo） | 美国/国际 | 价格和 Twilio 接近，也要 10DLC；PinRide 已支持（SMS_PROVIDER=vonage，填 VONAGE_API_KEY / VONAGE_API_SECRET / VONAGE_FROM） |
| Plivo | 美国/国际，想省一点 | 单价常比 Twilio 略低，也要 10DLC；可通过通用 HTTP 网关或后续加适配 |
| AWS SNS / AWS End User Messaging | 已有 AWS 账号 | 便宜，但控制台复杂，同样要登记 10DLC 或 Toll-Free |
| 阿里云短信 | 发中国大陆手机号 | 需要企业资质（营业执照）、短信签名审核、模板审核；网站若在国内服务器还需 ICP 备案 |
| 腾讯云短信 | 发中国大陆手机号 | 同上：企业/个人认证、签名与模板审核 |
九、常见问题
- 短信是中文会不会更贵？ 中文按 70 字一段，超过就分段计费；提醒内容尽量简短。
- 用户怎么退订？ 回复 STOP 即可（Twilio 自动处理）；也可在网站“通知设置”关闭短信。
- 会不会乱发？ 网站只给主动开启短信并填写手机号的用户发；总开关
SMS_ENABLED=false一关就全部停止。 - 一个月最多花多少钱？ 可以在 Twilio Console → Billing 设置用量提醒（Usage Triggers），超过金额自动发邮件提醒。
- 邮件提醒呢？ 邮件比短信便宜得多（基本免费），需要另外配置 SMTP（推荐 Resend、Brevo，或 Google Workspace 的 founders@pinride.ai）。