• 环境

• 1.云智信.Net SDK 适用于 .Net Framework 3.5 及以上版本

• 2.要使用云智信.Net SDK，您需要一个注册账号以及交易密钥。注册账号为您在云智信官网上注册的手机号，交易密钥请联系云智信商务获取

• SDK获取

  您可以通过联系商务获取SDK，商务会通过邮件形式发送给您，您也可以在云智信官网下载本SDK。

  您可以通过以下方式安装云智信SDK：

  1.添加DLL引用

  将压缩包解压，获得DLL文件夹下的YzxSdk.dll。在Visual Studio 的 解决方案资源管理器 中选择您的项目，然后右键 项目名称 -> 引用，在弹出的菜单中选择 添加引用，在弹出 添加引用 对话框后，选择 浏览 ，选择之前解压好的dll文件，单击 确定 即可。除SDK dll文件以外，您还需要引用.Net Framework中的System.Web.dll和System.Configuration.dll。

  2.项目引入

  将压缩包解压，获得Src&Demo文件夹下的SDK源码，打开YzxSdk文件夹，找到YzxSdk.csproj文件。在Visual Studio 的界面中，右键 解决方案，在弹出的菜单中单击 添加->现有项目，在弹出的对话框中，选择YzxSdk.csproj文件，单击打开。 右键 您的项目->引用 ，选择 添加引用 在弹出的对话框选择 项目 选项卡后选中刚才打开的项目，单击 确定 即可。

• 开始调用

  完整的示例请参照SDK源码中的Demo项目，以下代码示例展示了调用云智信SDK的3个主要步骤：

  1.创建DefaultTopClient实例并初始化；

  2.创建Api请求并设置参数；

  3.发起请求并处理返回；

                                   using System;
  using YzxSdk;
  using YzxSdk.Request;
  using YzxSdk.Response;
  
  namespace YzxSdkDemo
  {
      internal class Program
      {
          private const string ServerUrl = "http://api.yunzhixin.com:11140"; //服务地址
          private const string Account = "18600000000";                      //注册账户
          private const string TradeKey = "202cb962ac59075b964b07152d234b70";//交易密钥
          private static void Main()
          {
              //创建一个Client，用于发起请求
              ITopClient client = new DefaultTopClient(ServerUrl, Account, TradeKey);
              //构造请求
              SendSingleSmsRequest sendSingleSmsRequest = new SendSingleSmsRequest
              {
                  Mobile="18611111111",
                  Order_Id="Yzx0000001",
                  Tpl_Id="TP000001",
                  Params="code:1234"
              };
              //发起请求，并得到Response
              try
              {
                  SendSingleSmsResponse sendSingleSmsResponse = client.Execute(sendSingleSmsRequest);
                  //获得返回值，并进行相应处理
                  Console.WriteLine($"订单号:{sendSingleSmsResponse.Order_Id}");
                  Console.WriteLine($"返回码:{sendSingleSmsResponse.Return_Code}");
              }
              catch (Exception e)
              {
                  //处理异常
                  Console.WriteLine(e);
              }
          }
      }
  }
  
                               

• 3、短信类

• 3.1 短信内容计算规则？

  短信字数＝短信模板内容字数 + 签名字数
  短信字数≤70个字数，按照70个字数一条短信计算
  短信字数＞70个字数，即为长短信，按照67个字数记为一条短信计算，单个汉字、英文和标点都算1个字。
  

• 3.2 短信的计费模式？

  按照短信发送情况实时扣费，按成功+未知扣费。

• 3.3 短信发送失败，还是会扣费吗？

  接口调用失败及运营商返回失败状态，都不会扣费。

• 3.4 短信发送频率上有什么样的限制？

  短信验证码 ：使用同一个签名，对同一个手机号码发送短信验证码，1条/分钟，5条/小时，10条/天。短信通知： 使用同一个签名和同一个短信模板ID，对同一个手机号码发送短信通知，支持50条/日（指自然日）

• 3.5 测试发短信多少条免费的？

  账号资料认证成功后会自动为您的账号充值1元钱的余额，可用于测试短信的发送，测试发短信价格与正常使用单条价格一致并计入使用量。

• 3.6 短信提供哪些功能?

  目前支持短信下行发送、短信状态报告回执等；
  短信上行功能目前只支持企业用户申请使用,企业用户如需该功能,请联系官网客服协助您办理，上行功能免费,但上行产生的通讯费,由运营商向用户收取。

• 3.7 短信发送成功，但实际未能收到短信是什么原因？

  手机是不是长时间不关机，可以关机重启下
  手机收件箱是不是已满，删除一些看是否可以正常接收
  手机是不是双卡双待的手机，把卡拿出来换一下卡槽
  手机是不是安装了安全软件，安全软件有可能会进行拦截到垃圾信箱里
  如若不行，请您将SIM卡换到其他手机上进行测试。
  

• 3.8 短信发送状态回执哪里查看？

  云智信将主动发送回执信息给您，获取发送状态操作流程，请前往后台查看；
  开发者需开发客户端接收云智信推送的回执消息；

• 3.9 短信三网都可发送吗，能发送海外/港澳台吗？

  支持三网发送，目前海外/港澳台暂不支持。

• 3.10 短信字数最多能发多少个字？

  最大支持发送300个字以内的短信。

• 4、审核类

• 4.1 为什么要审核短信的签名（模板）？

  根据工信部和运营商要求，云智信有义务杜绝垃圾短信的传播，保障用户的权益。

• 4.2 短信签名要求？

  2-16个字符；
  不能是纯数字、纯字母、不含违禁关键词，不能有任何符号（如-.+#）；
  不用添加[ ]符号，短信发送会自带[ ]符号，避免重复，申请时无需添加该符号；
  短信签名建议为用户真实应用名/网站名/公司名，应如实清晰反映内容提供者的名称或者产品，若签名/短信内容侵犯到第三方权益须获得第三方的真实授权，授权委托书等凭证上传管理中心；
  签名内容不能含有违规,违禁关键词如中奖/抽奖/彩票/党政及宗教推广类签名不支持。
  

• 4.3 短信模板要求？

  不能发送营销/贷款/维权/彩票/色情/暴力/借款/中奖/抽奖/党政及宗教类短信，不支持慈善募捐，众筹，金融，理财，投资，房产通知类短信（验证码除外）；
  短信内容不能含有政治敏感字眼和“黄赌毒”等低俗敏感字样，出现违法违规或者损害到相关他人权益的，平台将保留最终追究的权利。
  不支持全变量/组合变量短信模板；请将短信内容的结构具体,细化使用场景；
  短信模板不支持特殊符号如,￥, ★,ヾ(●?▽`●)ノ ^_^&；
  支持TD或T或N进行短信退订回复,其它回复参数不支持；
  模板如需链接请将已ICP备案的网址写于模板非变量内容中便于核实;(短链接不支持拼接地址)；
  变量名称只能填写英文字母或英文数字组合，首位不能为数字，不能纯汉字，纯数字及email,mobile,id,nick,site；
  模板内容含验证码，注册码，校验证请选择验证码模板类型，反之请选择通知类型；
  变量格式应如#code#，其中#符号在变量外面，变量内容不能为空；
  【 】符号在模板内容中任意位置都不能使用，[ ]符号模板内容首尾不能使用，系统均会默认为签名，签名请单独申请，传参需传签名及短信模板ID；
  变量名称不能带有任何符号或空格 ;
  模板内容如侵犯到第三方权益须获得第三方的授权，并将授权委托凭证上传管理中心。
  

• 4.4 短信签名（模板）审核时间？

  短信签名审核时间为1个工作日，审核通过后可立即使用（法定节假日顺延）审核时间（8:30-17:30）；

• 4.5 为什么告诉我不支持此短信内容？

  您需要检查一下您短信内容是否有违禁内容？您的签名没有具体指向性，或者不是您的产品名称等，不规范的签名例如：测试，啦啦啦，验证码，通知，VIP，AH公司，你好，敢死队，CRM，夏天，测试，等此类没有明确产品指向的签名均为不合格签名，建议使用您公司的具体产品名称作为签名内容，或者也可以用公司名称作为签名，如果是个人用户建议用自己姓名作为签名。

• 4.6 个人测试公司的产品为什么需要我授权，一直给我驳回？

  目前我们有很多公司的技术人员都是以个人名义入驻我企业，但是测试的都是公司的产品，因为我们审核人员无法判断您是否是测试企业的员工，所以需要您提供您测试产品公司的授权书，以便测试带公司品牌的短信内容。

• 4.7 子公司入驻我们平台，但是内容发的是母公司的产品是否需要授权？

  首先子公司除非发布的是子公司的产品内容不需要通过授权，如果发布是母公司的产品还是需要母公司进行授权，根据《中华人民共和国公司法》第十四条“子公司具有法人资格，依法独立承担民事责任。”因此母公司、全资子公司、控股子公司在法律上是相对独立的不同机构。

• 4.8 为什么需要我提供使用场景，这个和我短信内容有什么关系？

  对于不清晰的短信内容/签名会需要您提供相应的使用场景，以此判断内容是否合规。

• 4.9 我怎么知道你们短信哪些是能发的哪些是不能发的？

  您在发送前可以参照“审核类——短信签名/模板要求”的内容进行检查一下您的内容是否合规。

隐私协议

• 2、客户隐私协议

• 2.1 隐私制度

  （1）尊重您个人隐私是我司的一项基本原则。所以，我司不会公开或透露您的注册资料及保存在云智信平台服务中的非公开内容，但以下情况除外：

  （a）事先获得您的明确授权

  （b）遵守有关法律规定，包括在国家有关机关查询时，提供您的注册信息、您在网易的网页上发布的信息内容及其发布时间、互联网地址或者域名

  （c）保持维护我司的知识产权和其他重要权利

  （d）在紧急情况下竭力维护您个人和社会大众的隐私安全

  （e）根据本条款相关规定或者我司认为必要的其他情况下。

  （2）您使用云智信平台服务向第三方提供任何收费或免费的服务时，应充分尊重第三方的隐私，不得利用云智信平台服务进行任何侵害第三方隐私的行为，否则要承担法律责任。

• 2.2 不可抗力条款

  我司对不可抗力导致的损失不承担责任。本服务条款所指不可抗力包括：天灾、法律法规或政府指令的变更，因网络服务特性而特有的原因，例如境内外基础电信运营商的故障、光缆等基础设施损坏、计算机或互联网相关技术缺陷、互联网覆盖范围限制、计算机病毒、黑客攻击等因素，及其他合法范围内的不能预见、不能避免并不能克服的客观情况。

• 2.3 服务承诺

  云智信平台服务承诺及服务不可用的补偿标准以云智信平台服务各具体服务项目网页公布的服务等级协议为准。

• 2.4 通知

  所有发给您的通知都可通过电子邮件、常规的信件或在云智信平台网站及各具体项目网页适当位置公告的方式进行传送。云智信平台服务将通过上述方法之一将消息传递给您，告知服务条款的修改、产品或服务变更、或其它重要事情。 为使您及时、全面了解我司提供的各项服务，您同意，我司可以向您发送商业性短信息而无需另行获得您的同意。

• 2.5 内容、商标所有权

  云智信平台服务内容或技术均属于我司（涉及第三方授权的除外），并受中华人民共和国著作权法、商标法、专利法、反不正当竞争法和相应的国际条约以及其他知识产权法律法规的保护。所以，您只能在我司授权下才能使用这些内容，未经我司产品书面同意，您不能为任何营利或非营利性的目的擅自复制、再造这些内容、或创造与内容有关的派生产品、或以转让、许可的方式授权第三方实施、利用和转让上述知识产权。

  我司有权在服务中或经过服务在云智信平台服务中发布宣传信息。同时云智信平台等本文中提及的产品和服务名称有可能为我司或其关联公司的商标，未经我司事先书面同意，您不得以任何方式展示或使用或作其他处理，也不得向他人表明您有权展示、使用、或其他有权处理的行为。

• 2.6 信息储存及相关知识产权

  云智信平台服务对其提供的所有服务将尽力维护其安全性及方便性，但对服务中出现的信息（包括但不限于您发布的信息）删除或储存的操作失败不承担任何责任。另外我司有权判定您的行为是否符合本服务条款的要求，如您违背了本服务条款的规定，我司有权中止或者终止您使用云智信平台服务。

  云智信平台由我司研发。云智信平台的专利、版权、设计等知识产权，以及与云智信平台相关的所有信息内容，包括但不限于文字、图片、档案、资讯、资料、网站架构、页面设计均由我司依法享有知识产权。 我司尊重知识产权并注重保护您享有的各项权利。在云智信平台所含服务中，您可能需要通过发表评论等各种方式向云智信平台提供内容。在此情况下，您仍然享有此等内容的完整知识产权。您在提供内容时将授予我司一项全球性的免费许可，允许我司使用、传播、复制、修改、再许可、翻译、创建衍生作品、出版及展示此等内容，但上述授权内容不包括您的业务数据和声明保留知识产权的内容。

• 2.7 保密

  您和云智信平台对于因使用云智信平台服务而了解或接触到的对方的商业秘密及其他机密和信息，服务和协议内容及您使用云智信平台过程中产生的相关信息及往来文件（以下统称“保密信息”）均应保守秘密；非经书面同意，不得向第三方泄露、给予或转让该保密信息。本保密条款不因本协议的终止而终止。

• 2.8 法律

  本条款适用中华人民共和国的法律，并且排除一切冲突法规定的适用。如出现纠纷，您和我司一致同意将纠纷交由山东省烟台市莱山区人民法院以诉讼方式解决。

• 2.9 其他

  以上条款自本平台发布之日（即2017年7月1日）起实施，您注册账号之前，已仔细阅读并充分理解，并构成您和我司之间的共识，您愿意遵照以上条款内容执行并承担相关责任。我司不行使、未能及时行使或者未充分行使本条款或者按照法律规定所享有的权利，不应被视为放弃该权利，也不影响我司在将来行使该权利。 如云智信平台服务各具体服务项目网页基于具体服务项目提供服务的情况发布的服务规则与本服务条款不一致的，以具体服务项目的服务规则为准；具体服务项目的规则没有约定的，以本条款为准。