01　什么是短信配置

短信配置用于连接机构自己的 SMS 服务商。

机构只需要准备短信服务商提供的相关账户信息，并在 Finger Manager 中完成配置，系统即可通过该服务商发送短信。

常见的短信服务商包括 Twilio、AWS SNS、Vonage、MessageBird、阿里云短信、腾讯云短信、各国家或地区本地运营商，以及其他支持 API 或标准短信接口的服务商。

实际可接入范围以 Finger Manager 当前支持的短信通道为准。

02　为什么使用自己的短信服务

Finger Grid 可以提供平台侧的短信发送能力，但平台短信通常会受到发送额度、地区覆盖及费用规则影响。

机构也可以选择接入自己的短信服务商。

使用自己的短信服务后，机构可以使用自己的短信账户，费用由机构直接与短信服务商结算，可根据业务选择不同国家或地区的线路，自行管理短信额度，并根据服务商能力使用自定义 Sender ID。Finger Grid 不另外收取该短信通道的发送费用。

03　配置短信服务

进入系统设置 → 短信，根据所使用短信服务商的要求填写连接信息。

不同服务商所需字段可能不同，常见包括 Provider、API Key、API Secret、Access Key、Access Secret、Account SID、Auth Token、Sender ID、Sender Number、Messaging Service ID、API Endpoint 和 Region。

具体填写内容应以短信服务商提供的后台信息和 API 文档为准。

04　API Key 与 Secret

多数短信服务商通过 API Credential 验证发送请求。

常见形式包括 API Key + API Secret、Access Key + Access Secret，或 Account SID + Auth Token。

这些信息通常可以在短信服务商的管理后台创建。建议为 Finger Manager 单独创建一组短信发送凭证，不要与其他业务系统共用。

05　Sender ID

Sender ID 是短信接收方看到的发送者标识。

根据国家、运营商及服务商规则，可能显示为企业名称、品牌名称、短号码、长号码、虚拟号码或服务商统一号码。

是否可以自定义 Sender ID，取决于当地电信法规和短信服务商政策。部分国家可能要求提前注册或审核。

06　短信可以用于哪些场景

短信服务配置完成后，可以用于 Finger Grid 中支持短信发送的功能。

例如手机验证码、注册验证、登录验证、找回密码、安全验证、异常登录提醒、账户状态通知、系统通知、用户定向通知、用户分组通知、运营消息和服务提醒。

具体可使用范围以当前启用的产品和系统功能为准。

07　与 Finger Grid 系统短信的区别

机构可以根据实际业务选择平台短信或自有短信通道。

Finger Grid 系统短信无需自行申请短信服务商，配置简单，可以直接使用，但存在发送额度或使用费用，可用国家和地区以平台支持范围为准。

机构自己的短信服务则使用自己的短信服务商账户，自己管理额度及线路，自己承担服务商短信费用，可以根据业务需求选择当地运营商，Finger Grid 不另外收取短信发送费用，更适合大规模或国际化运营。

08　国际短信

不同国家和地区的短信规则存在较大差异。

例如可能涉及 Sender ID 注册、企业实名认证、短信模板审核、营销短信许可、短号码申请、国际短信线路限制、用户退订要求和当地电信法规。

如果机构向多个国家发送短信，建议提前确认所使用短信服务商在目标地区的覆盖情况和合规要求。

09　短信模板

部分短信服务商要求发送前先创建并审核短信模板。

例如登录验证码模板可能会说明验证码有效时间，并提醒用户不要向任何人透露。

如果服务商启用了模板审核机制，则 Finger Manager 发送的短信内容必须符合对应模板规则，否则短信可能发送失败。

10　验证码短信

验证码属于短信系统中最常见的使用场景。

例如注册验证码、登录验证码、手机号码验证、修改密码和高风险操作确认。

对于验证码类短信，建议设置有效时间、发送频率限制、连续请求次数限制，避免在日志中直接记录完整验证码，并对异常发送行为进行风控。

11　发送额度与费用

短信费用通常由目标国家、运营商、短信长度、短信类型、国际或本地线路、Sender ID 类型及服务商定价决定。

如果使用 Finger Grid 提供的短信通道，费用按照平台对应服务规则计算。

如果使用机构自己的短信服务商，则短信费用直接由机构与该服务商结算。

12　短信长度

短信实际计费条数不一定等于用户看到的短信数量。

较长的短信可能被拆分为多条发送和计费，同时不同字符编码也可能影响单条短信允许的字符数量。

因此，在设计短信内容时建议尽量保持简洁，避免不必要的长文本，验证码短信只保留必要信息，营销或长篇内容优先考虑邮件或其他通知方式。

13　测试短信

完成短信服务配置后，建议先发送测试短信。

测试时确认 API 连接是否正常、手机号码格式是否正确、Sender ID 是否正常显示、短信内容是否完整、验证码是否正确、不同国家号码是否能够接收，以及服务商后台是否产生发送记录。

确认正常后再投入正式使用。

14　Organization 独立配置

短信服务以 Organization 为单位独立管理。

不同机构可以分别接入自己的短信服务商，例如 Broker A 使用 Twilio，Broker B 使用 AWS SNS，Broker C 使用当地运营商短信服务。

各 Organization 的账户、Credential、发送额度及短信通道彼此独立。

15　凭证安全

短信服务的 API Key、Secret、Token 等属于敏感信息。

建议使用专用 API Credential，不与其他系统共享凭证，定期更换密钥，设置最小权限，限制后台配置权限，并在凭证泄露后立即撤销并重新生成。

对于正式生产环境，不建议使用个人开发账户作为长期短信发送账户。

16　发送失败

如果短信无法正常发送，可以依次检查 API Key 是否正确、Secret 或 Token 是否有效、短信账户余额是否充足、手机号码格式是否正确、目标国家是否在服务商支持范围内、Sender ID 是否已经审核、短信模板是否已经审核、服务商账户是否存在发送限制，以及是否触发频率限制或风控规则。

Finger Manager 会按照短信服务商返回的结果处理发送状态。

17　权限说明

短信配置属于敏感的系统级配置。

只有拥有对应「系统设置」权限的管理员才能查看或修改短信服务设置。

建议仅向指定系统管理员开放短信配置权限，尤其是涉及 API Key、API Secret、Auth Token、Sender ID、服务商账户信息等敏感配置时，应严格控制访问范围。