SuperAPI AI 工具集

telnyx-vercel-sms

编程与开发

查看项目

更新于 11-06 18:30

技能介绍

用途:通过 Vercel Marketplace 的 Telnyx 集成(slug 为 telnyx,产品为 telnyx/phone-number,显示为 SMS Phone Number (US)),为 Vercel 项目添加一个可收发短信的美国电话号码,并完成发送与接收短信的接入。安装该集成会为 Vercel 团队创建 Telnyx 账户,计费方式为在 Vercel 中购买预付额度。

主要能力:提供美国本地号码,可收发 SMS;入站短信与发送回执通过 webhook 推送;集成会向项目注入 TELNYX_API_KEY(仅可发送和读取消息)、TELNYX_PHONE_NUMBER、TELNYX_MESSAGING_PROFILE_ID、TELNYX_MESSAGING_WEBHOOK_URL、TELNYX_PUBLIC_KEY 等环境变量;支持用 Ed25519 公钥校验 webhook 签名。

使用方式(据资料整理):使用最新 Vercel CLI(npm i -g vercel@latest)并登录,在应用目录执行 vercel link --yes,再用 vercel integration discover telnyx --format=json、vercel integration add telnyx/phone-number --help、vercel integration guide telnyx --framework nextjs 查看信息;以 vercel integration add telnyx/phone-number --plan telnyx-prepaid 安装并连接到已链接项目,可选元数据包括 area_code、webhook_url、webhook_failover_url。首次安装会打开浏览器,需真人接受 Telnyx 条款并充值(至少 10 美元)。随后由 Vercel 团队管理员通过 vercel integration open telnyx 完成一次性身份核验(证件照片加自拍,约 3 分钟,人工审核最长 24 小时),通过后分配号码并写入 TELNYX_PHONE_NUMBER。资源未连接时用 vercel integration resource connect <resource-name> [project] --yes 连接;连接后若未设置 webhook_url,入站短信会指向 https://<生产域名>/api/telnyx/inbound,因此入站路由必须位于 app/api/telnyx/inbound/route.ts 并部署到生产。环境变量只对添加后构建的部署生效,连接后和号码分配后都需 vercel deploy --prod;本地用 vercel env pull .env.local 拉取变量。发送短信可调用 https://api.telnyx.com/v2/messages(携带 Bearer 密钥、from、to、text),或在 Next.js 中新增路由处理器;发送路由必须自行加鉴权,to 需为 E.164 格式美国号码,200 仅表示已入队。接收短信需读取原始 req.text() 后校验 telnyx-signature-ed25519 与 telnyx-timestamp(签名内容为 ${timestamp}|${rawBody}),签名错误或时间偏差超过 5 分钟返回 401,须在 2 秒内返回 2xx,跳过已处理的 data.id,并在返回前等待回复发送完成。

适用场景:需要在 Vercel 项目上快速接入美国 SMS 收发能力,例如通知、验证类短信或双向短信应用的起步搭建;模板含可直接参考的 Next.js 示例。

限制:仅美国本地号码,且只能向美国号码发短信,不支持语音、MMS、免费号或短码;每个安装一个预付余额,由其所有号码共享,未使用额度退款需联系 support@telnyx.com;API 密钥仅能发送和读取消息;入站 webhook 按安装而非按项目管理;生产部署若启用 Vercel Deployment Protection,Telnyx 无法访问该路由,生产域名必须公开;每个团队邮箱只能对应一个 Telnyx 账户,不支持关联已有 Telnyx 账户;向美国普通手机发送短信需完成 10DLC 注册(品牌注册 4.50 美元一次性,活动费用提交前显示,审核约 1 至 3 个工作日加运营商约 3 个工作日),在此之前仅能接收短信及向其他 Telnyx 号码发送。删除资源会永久释放号码,卸载会关闭 Telnyx 账户。