常见问题


用户在使用云片过程中常见问题总结


短信办理类


短信使用时间有期限吗?


没有。长期有效,不会过期!


短信如何充值?能否使用银行转账或汇款?


您可以登录后台点击首页右上角的“充值”按钮进行在线充值;支持银行转账汇款,线下转账后可进入账户【财务】--【线下充值】提交充值凭证。


你们可以开发票吗?


可以开票,数电发票和数电增值税发票都可以开。可自助申请,每月25号之前,提交后3-5个工作日开出,可在后台自助下载;每月25-30号为公司内部结算日不再开具所有类型发票,申请的发票次月初处理,请合理安排时间。


短信使用类


短信能测试吗?


可以,注册账户后,我们将免费赠送 10 条测试短信。如果您已有账户,登录后选择国内短信--测试 菜单进行测试。


可以同时发多个手机吗?


可以,相同内容一次最多提交 1000 个号码。


三网(移动、联通和电信)都可以发吗?


是的。三网都支持,全国号码都可以发。同时我们还支持国际短信,详见:国际短信产品介绍


什么是短信签名?


短信签名是加在短信的开头,由【】加上您的公司名称或店铺名称的标识符,例如:【云片网络】。 根据电信基础运营商的规定,每条短信前必须附加短信签名,否则将无法正常发送。


发送时间段有限制吗?


没有限制。实际使用时,请以不打扰用户正常作息时间为前提。


无法通过审核的原因是什么?


云片网络有完善的文字过滤系统及人工审核流程,如果您的内容含有敏感词或者内容比较低俗,将无法通过审核。若有疑问,请联系客服。


发送后没收到是什么原因?


首先确认一下,短信发送是否返回成功。如果返回失败,请按具体返回的失败代码和出错提示排查;
如果返回成功,请检查:


  • 手机是否处于关机或欠费停机状态,可以拨打手机号码确认;
  • 请检查手机信号是否正常,必要时重启一下手机;
  • 是否被短信屏蔽软件拦截,检查是否在屏蔽的短信列表中;
  • 通过接口查询短信接受状态和错误代码。


为什么会重复收到短信?


  • 检查您的程序是否重复提交的问题;
  • 极端情况下,由于手机端未正确返回确认信号给运营商,造成运营商认为手机没有接受成功, 尝试重试发送。请重启手机解决,必要的时候,取出手机卡,插入接受正常的手机接受完短信再插回原来的手机。


哪些情况手机号会进入防骚扰名单?


  • 之前投诉过运营商,如打过 10086、10010 或 10000 投诉的,可能会被运营商加入防骚扰名单;
  • 有过退订历史,如回复过含有 T、TD、退订或取消等代表拒绝接收短信的指令。


手机号进防骚扰名单了,怎么破?


  1. 国内短信—短信记录—号码显示接收失败原因为防骚扰名单,您可以在后台短信记录页面搜索要解除的号码,然后点击接收失败按钮,根据提示进行解除。
    ps:申请专用通道,最大程度的避免命中防骚扰名单。
  2. 请求记录—失败请求记录内的防骚扰名单可以联系客服确认如何解除,需要您提供账户 ID(注册账户或 apikey 前 8 位)+ 要解除防骚扰名单的手机号;
  3. 如果是验证码短信,可以使用云片的语音验证码服务,在客户收不到短信时,引导客户通过语音播放的方式完成验证。


什么是短信轰炸?短信炸弹?


短信轰炸、短信炸弹,是指通过恶意程序,利用从各个网站上找到的动态短 URL (比如验证码发送的 URL)和 前端输入的被攻击者手机号码,发送 HTTP 请求,每次请求给用户发送一个动态的短信(比如验证码短信)。 最终的效果,就是朝许多无关的手机用户,发送很多验证码短信。导致手机用户被骚扰。


图片验证码为什么能防范短信轰炸?


恶意攻击者采用恶意工具,调用“动态验证码短信获取”接口进行动态短信发送, 究其原因是攻击者可以自动对接口进行大量调用。


采用图片验证码可有效防止恶意工具的自动化调用,即当用户进行“动态验证码短信发送” 操作前, 弹出图片验证码,要求用户输入验证码后,服务器端再发送动态短信到 用户手机上,该方法可有效解决被利用实施炸弹攻击的问题。


安全的图片验证码必须满足: 生成过程安全:图片验证码必须在服务器端进行产生与校验; 使用过程安全:单次有效,且以用户的验证请求为准; 验证码自身安全:不易被识别工具识别,能有效防止暴力破解。


遇到轰炸以后有什么处理建议?


  • 碰到轰炸,首先要:确认轰炸/攻击来源,判断是哪个注册入口遭到攻击
  • 基础防范措施:
    • 增加手机号有效性监测,过滤无效号码
    • 在注册页面添加一个参数,保存在 session 中随机验证,发短信前验证下请求是否是是由注册页面发起的
    • 同一个号码单位时间内发送次数限制
    • 同 IP 请求次数判断与限制
    • 同设备请求次数判断与限制
    • 建议使用 https,防止传输明文数据被分析
  • 对请求的增加效验机制:
    • PC 端,微信端图片验证码,程序前后端需进行效验,并且满足“填错或不填图片验证码,不允许用户获取短信验证码”的逻辑。建议添加滑块验证等较高级的验证方式。
    • 对请求增加其他效验机制,例如 APP 端增加版本号效验等等。
    • 在登录页面增加账号检验等功能。
  • 限制用户请求来源:
    • 微信端、APP 端的注册入口,需要对来自 PC 端的请求做限制和过滤,主要是大多数恶意程序都是来自 PC 端的。


是否支持发送海外的手机号?


可以,了解详情请见 国际短信


专用通道类


专用通道跟普通通道有什么区别?


专用通道接收速度更快更稳定,验证码 5 秒以内,稳定性和速度更有保障。


怎么申请专用通道?


申请专用通道进入您的云片账户,左下角【设置】--【高级用户设置】


高级用户申请有什么要求?


  1. 企业认证,注册时间需满 30 日,且有相关稳定下发记录,若下发不稳定,暂不支持升高级
  2. 后台仅验证码模板,暂不支持升高级
  3. 历史审核申请的模板需合规,若根据最新标准不支持,需根据现有标准修改/ 删除之后再申请
  4. 后台的验证码模板网址不可填写“开发中”(防止轰炸风险),需修改之后再进行申请,如不方便修改可联系客服进行核实
  5. 特殊行业:金融/区块链/代理公司等敏感行业不支持申请高级用户(包含个人开发的产品)


专用通道申请收费吗?短信费用怎么算?


申请专用通道不收费,具体短信费用按照充值套餐来收费。


申请专用通道需要多久?会发短信通知吗?


专用通道需要向运营商申请,材料完整大约需要 2 个工作日左右,请耐心等待。另专用通道申请状态,会有系统短信通知。


技术开发类


用接口发短信怎么发?


我们为你准备的详细的使用文档,猛戳这里:开发引导


提交短信的频率有限制吗?


没有限制。如果想更快的提交短信,可以使用多线程提交。


为什么返回 HTTP Status 400 Bad Request?


在调用单条发送、指定模板单发等接口时,如因手机号码格式错误、短信频率限制等原因导致接口请求失败时,http_status_code 会返回 400 Bad Request,可以捕获下异常的 responseBody, 内部 json 对象的 code、msg、detail 字段及对应云片的返回码、错误信息等。另外,400错误基本在用户后台的请求记录中可以查询到。


为什么返回 HTTP Status 405 - Method Not Allowed?


API 不支持当前的访问方法。某些 API 只支持 POST 方法的,使用 GET 方式访问就会提示该错误。具体访问方式请参考对应的 API 下方访问方式说明


为什么返回 HTTP Status 406 Not acceptable?


需要设置请求的 HTTP 头信息为:


Accept:application/json;charset=utf-8;
Content-Type:application/x-www-form-urlencoded;charset=utf-8;


请参考:调用说明


为什么返回 HTTP Status 415 Unsupported Media Type?


同上


手机号格式不正确?


  • 手机号是有效
  • 手机号前后是否有空格
  • 手机号前面是否有特殊字符
  • 处理方法:
    • 国内短信 先 trim ,再 int 类型转换下
    • 国际短信 "+"号需要 urlencode 处理


报 SSL certificate error: unable to get local issuer certificate 错误怎么办?


  • 下载证书(https://curl.haxx.se/docs/caextract.html)。
  • 把它放在某处。在我的例子中,这是 C:\WAMP 目录(如果您使用的是 WAMP 64 位,则是 c:\WAMP64)
  • 使 PHP Apache 和 mod ssl _在 php.ini 中
  • 在 PHP.ini 文件中将这些行添加到证书中:
    • curl.cainfo="C:/wamp/cacert.pem" openssl.cafile="C:/wamp/cacert.pem"
  • Restart Wamp services


报 java.net.UnknownHostException: sms.yunpian.com: unknown error 错误怎么办?


未知的名称或服务用户发短信服务有时会报这个错误,解决办法:


  • 在 Android 项目中的 AndroidManifest.xml 中添加访问网络的权限:;
  • 访问网站已经倒闭/关闭或者不存在,可以在浏览器中验证一下;
  • 无法解析该域名,可以将域名对应的 ip 写入到 hosts 文件中保存。
  • UnknownHostException 异常是指 DNS 解析不了,就是解析不了网址
    • ping yunpian.com
    • 再 telnet 一下 443 80 端口


请求超时 time out


服务器在国内提供下出口 ip 执行 mtr sms.yuanpian.com 和 ping sms.yunpian.com 并把截图提供给客服


云片支持手机号通过.csv 文件导入吗?


  • 如果想用国内短信 - 短信群发功能,导入的 excel 文件格式需要是.xlsx 的
  • 如果通过 API 接口发短信,mobile 参数内容想从 csv 文件中导入,需要用户写代码,通过相关的函数方法实现


语音验证码使用类


语音验证码短信是否需要模板?


语音验证码目前采用固定模板,暂时不支持自定义模板


语音验证码短信的默认显示号码是什么?


默认情况下不需要考虑号码问题,为保证全国范围的呼通率,云片会自动选择最佳的线路,透传的主叫号码也会相应变化。


语音验证码短信是否可以透传自定义的号码?


支持透传自定义的号码,但因运营商对透传号码的限制,会影响您的接听率,所以不建议使用透传号码。 具体请联系客服


语音验证码短信是否支持 TTS?


暂时不支持


国际短信使用类


国际短信什么价格?


不同国家/地区的短信价格不同,点此去查看


国际短信如何充值?能否使用银行转账或汇款?


与短信相同,您可以登录后台进行自助充值,结算货币为人民币;


国际短信怎收费?支持套餐么?


国际短信按金额充值,发送短信按照各个地区短信单价进行扣费,不折算为短信条数;国际短信套餐后续会推出;


国际短信支持哪些国家、地区?


目前我们的国际短信支持 215+国家/地区,咨询客服是否支持您需要发送的国家;


国际短信怎么发送?


国际短信在发送前需要先提交模板,审核通过后发出;


注意:提交模板后请主动联系客服报备短信发往的国家及内容中将会使用到的语言类别,避免乱码等问题


开通国际短信后是否会对国内短信产生影响?


是的,开通国际短信后您的账户将会变成按照金额计费,即扣费单位变成「元」,而非「条」, 国内国外短信以及语音都会按照金额进行扣费,现有账户中未使用的短信条数将会给您转成对应的金额。