测试短信发送

更新时间:
复制 MD 格式

如果您希望体验短信发送或您的应用还未上线,可以通过短信服务的快速学习与测试,使用控制台或调用API接口,快速发送测试短信。

使用须知

  • 仅国内短信支持发送测试短信。

  • 仅支持给已授权的手机号码发送测试短信,同一个阿里云账号最多授权(在控制台绑定)5个测试手机号码。

  • 测试短信受短信发送总量发送频率等限制,请合理配置,以免影响测试体验。

  • 如您使用含有变量的自定义短信模板发送测试短信,请按照真实业务环境传参,传入不符合变量规范或与实际业务偏差较大的参数值容易导致短信被拦截。

  • 发送测试短信是计费的,因此发送前请确保您的套餐包余量或账户余额充足。如果有短信套餐包先扣除套餐包,超出套餐包额度后按量计费,扣除账户余额。更多详情,请参见计费概述

准备工作

发送测试前您需提交短信资质、签名和模板申请,并等待审核通过及签名实名制报备完成。

  1. 申请资质:登录控制台国内消息-资质管理页面,完成资质申请。资质材料说明 | 操作说明

  2. 申请签名:登录控制台国内消息-签名管理页面。审核规范 | 签名实名制报备 | 操作说明

  3. 申请模板:登录控制台国内消息-模板管理页面。审核规范 | 操作说明

操作步骤

  1. 完成阿里云账号注册实名认证,并开通短信服务

  2. 登录短信服务控制台快速学习与测试页面。

  3. 发送测试区域,选择API发送测试控制台发送测试

  4. 请为接收测试短信的手机号码授权:单击绑定测试手机号码,输入接收测试短信的手机号码和获取的验证码。

    说明
    • 仅支持给已授权(已绑定)的手机号码发送测试短信。

    • 手机号码取消授权(取消绑定):在控制台直接删除手机号码即可。

API发送测试

  1. 选择【自定义】签名/模板并选择已审核通过的签名模板

  1. 单击调用API发送短信,跳转到OpenAPI门户页面,左侧参数列会自动识别参数信息,请确认参数是否正确。

    • 请检查服务地址的填写,确认是否选择国内区域,如:华东1-杭州

    • TemplateParam参数值为JSON格式,正确示例:{"code":"1234"}

  2. 单击发起调用,将通过该平台直接调用发送接口发送测试短信。

  1. 在右侧调用结果页,查看接口调用结果。

常见 API 参数错误排查

发起 API 调用后如遇发送失败,请逐项核查以下参数:

参数

常见错误

排查方法

SignName(签名)

填写的签名名称包含空格或多余字符,或与代码配置不一致

填写已审核通过的签名全称,不得包含任何空格或特殊字符,并确保与代码中配置的名称完全一致

TemplateCode(模板 CODE)

填写了错误的模板 CODE

模板管理页面复制正确的模板 CODE 填入;模板与签名可自由组合,无需与模板详情中的关联签名一致

TemplateParam(模板变量)

变量值不符合模板定义(如验证码模板传入非纯数字),或参数格式非 JSON

变量值须符合模板定义规范:验证码模板传 4~6 位纯数字,通知类模板按变量长度及字符类型限制传值;参数格式必须为 JSON,正确示例:{"code":"1234"}

常见错误码参考:TemplateParam.Illegal(变量格式不合规)、isv.SIGN_NAME_ILLEGAL(签名名称有误)。如遇上述错误,请优先核查对应参数的传值是否符合规范。

控制台发送测试

  1. 根据页面提示填写以下信息。

    • 产品类型:选择发送国内短信

    • 签名:选择已审核通过的签名。

    • 模板:选择已审核通过的模板。

    • 接收号码:输入已授权(已绑定)的测试手机号码。

  2. 单击发送短信

查询发送详情

您可以通过以下方式查询短信发送详情:

后续步骤

当您完成短信服务的测试与学习,了解短信服务使用流程后,可以根据下述步骤,开始将短信服务部署到生产环境中。

  • 少量多次测试发送(签名报备验证 / 通道激活):签名审核通过后,状态为"已报备待验证",需通过真实发送短信来动态验证通道可用性并触发补充报备(三网测试)。若不主动发送,报备进程将十分缓慢,影响正式发送成功率。

    执行建议

    • 覆盖移动、联通、电信三网手机号,每天每个运营商发送 10~20 条以上。

    • 持续进行 5~7 个工作日。

    • 支持向同一批号码重复发送,但需注意发送频率,避免触发流控。

    上线标准:无需等待控制台中签名报备状态发生变更。只要实际发送成功率稳定、符合业务预期,即可将短信服务投入生产环境使用。

  • 使用群发助手发送短信:请登录控制台国内消息-群发助手页面,操作详情请参见群发短信

  • 使用API接口发送短信:API接口请参见发送短信批量发送短信