饿了么开放平台短信及语音通知服务接入管理
一、前言
基于用户隐私保护，并方便商户快速高质量地对用户进行通知和营销触达，本平台提供了通知短信、营销短信以及通知语音服务。平台入驻的ISV开发者可通过调用相应的API接口来实现对用户的消息触达。这些服务适用于如订单履约、评价提醒、用户关怀、会员营销等场景，帮助商户提升经营能力。
二、产品特色
用户隐私保护背景下实现对用户短信触达的唯一方式
根据平台政策，用户手机号作为用户的隐私信息将受到严格保护，平台也推出了相应的小号保护策略，但在订单完结三个小时候小号将会失效，无法继续进行短信触达，详见文档 隐私信息保护。
饿了么开放平台短信服务功能，可在不触及获取用户隐私信息的方式下，快速高质量完成商户与用户之间的信息触达。
三、应用场景说明
3.1 总体说明
平台提供的消息服务是账户级能力，一次开通即可在个人、企业、平台应用中使用
目前服务仅面向大陆地区；
用户隐私数据如手机号，在满足相关条件下保护性地使用
平台提供以下模块：
短信服务接口
短信服务模板
短信服务购买
短信服务计费
发送记录查询
3.2 使用说明
短信及语音服务开通
资质审核短信服务开通前需完成资质审核、确认并同意《开放平台短信服务协议》方可使用。
流程图
开通短信服务
服务入口：服务商平台 > 管理中心 > 开发者> 短信服务
购买短信
进入短信服务页面，即可查看可用短信数量，数量不足无法发送短信，需要购买短信，如下图：
营短信目前仅支持部分服务商开放。未和平台沟通的服务商，请勿直接购买使用。不支持退款。
点击购买短信即可进入短信购买页：
创建短信模板
发送短信需要事先创建相应模板，可在通知模板管理tab页创建短信模板：
短信模板可以包含变量，变量前后使用#作为前后缀，例如:
您好！#username#
变量表示实际发送短信时，用户希望自定义变化的内容，固定格式如：#name#、#content#等，中间字母应代表变量属性
变量命名规则：首字母必须为英文字母、只支持字母、数字和下划线组成，不能为纯数字，同时不能为email、mobile、id、nick、site等
特别需要关注营销短信的使用规则
模板提交后，将会由运营人员进行审核，审核通过后的模板方可使用；
为防范在短信内容中出现的违反国家法律法规要求的相关内容，运营人员会对相关正在使用的模板进行禁用操作。
3.3短信发送顺序图
基于用户隐私的考虑，短信发送将以商户订单号/手机号作为发送目标，ISV调用短信接口需提前获得相应的订单号/手机号，详见后续流程说明。
3.4 接口说明
详见短信服务接口文档 https://open.shop.ele.me/common/search?keyword=%E7%9F%AD%E4%BF%A1
3.5 注意事项
短信模板
所有短信模板都需要提交审核，审核通过后方可调用模板进行短信发送，点击审核规则查看具体审核标准。
短信最多200字；语音短信不要求签名。具体字数限制如在开发过程中涉及其他因素，将会详细标出。
业务限流
限量规则：同一ISV（服务商），使用同一个短信模板ID，对同一个手机号码发送短信通知，支持50条/日（天的计算方式是是当下时间往后推24小时，例如2018年8月24日：11:00发送一条短信，计算限流方式是2018年8月23日11:00点到8月24日：11:00点，是否满50条）。如您是在发送短信提示业务限流（EXCESS_SMS_SEND_FREQUENCY），建议您根据以上业务调整接口调用时间。
发送支持
支持订单和真实手机号；隐私号仅支持语音；注意是否带签名。
调用权限SCOPE
基于安全性和隐私保护的考虑，作为短信发送目标的订单，必须是与ISV（的应用)有授权关系的商户产生的，在调用短信接口时必须需要传入应用授权访问的access_token;注意订单号需为商户近一年内有效订单。
计费规则
【文字短信】
短信字数＝短信模板内容字数 + 签名字数；
短短信内容长度<=70个字，计费一条；长短信内容长度>70个字，计费条数=长度/67（向上取整）。
在统计短信字数时，小数点、字母、汉字以及其他符号均按照一个字符位进行统计。最终按照实际发送成功的短信条数计费。
【语音通知】
语音长度＝模板内容字数；语音通知里面，标点符号部分读，比如”.“这种的；
通知语音每6s计费，通话时长<=6秒，计费一条；通话时长>6秒，计费条数=通话时长/6（向上取整）；
平台默认播放循环 2 次，隐私号播放循环 3 次；挂机上限 60 秒。
3.6 沙箱环境测试注意事项
沙箱环境测试，不支持实际的短信发送即不会收到短信，只能验证接口是否正常调用，网络是否正常，接口返回成功即可，请勿担心短信是否发送，请悉知！
四、短信服务异常码及异常信息
错误说明解释解决方案
SERVICE_UNAVAILABLE当前服务不可用
INVALID_BUSINESS_ISV无效的商户服务商填写正确的app key
ILLEGAL_ORDER非法订单确保传入的订单号为授权商户在近一年内产生的有效订单
INVALID_SLUG无效的短信模板核对短信模板是否通过审核，且未被禁用
EXCESS_SMS_SEND_LENGTH短信内容超长短信字数超过200字的限制，需要精简内容
EXCESS_SMS_SEND_FREQUENCY超出短信日发送次数当前目标已被限流，请稍后尝试发送
EXCESS_ORDER_ID_AMOUNT订单个数超过阈值
EXCESS_PHONE_AMOUNT手机号个数大于1
BALANCE_INSUFFICIENCY短信余额不足短信余额不足，需要购买短信
VOICE_BALANCE_INSUFFICIENCY语音短信余额不足短信余额不足，需要购买语音
SMS_SEND_EXCEPTION短信发送异常
TEMPLATE_PARAM_NOT_MATCH_TEMPLATE模板参数与模板不能完全匹配检查模板与接口请求参数是否一致
ORDER_QUERY_EXCEPTION获取订单信息异常请重试重新请求
五、发票申请
服务入口：开发平台 > 管理中心 > 财务管理> 发票管理
发票依照充值金额开具，而非按照消耗金额。
