【云小課】應用平臺第23課 短信發送失敗別慌張，小課給你來幫忙

消息&短信 （Message&SMS）是華為云攜手全球多家優質運營商和渠道，為企業用戶提供的通信服務。具有極速穩定、海量并發、易操作、易管理等優勢。企業用戶通過調用API或使用群發助手，即可發送驗證碼、通知和會員推廣類短信。

首先，在我們正確創建短信應用、申請短信簽名和模板以后，發送短信的流程如下圖所示。（如果您是還沒有創建短信應用的新用戶，請參考國內短信使用全流程。）

在發送短信的過程中，我們可能會遇到以下兩種情況：

API調用失敗：

通過調用API發送短信時，當短信平臺返回了攜帶API錯誤碼的響應信息，即接口調用失敗。請根據返回的API錯誤碼（“status”或“code”），參考API錯誤碼處理。

短信發送失敗：

當接口調用成功，或使用群發助手發送短信時，如果短信的發送結果為“失敗”，請根據對應的狀態碼（狀態回執錯誤碼），參考狀態回執錯誤碼處理。

這里小課為您總結了導致短信發送失敗的一些常見原因，通過識別短信錯誤碼，幫助您高效應對短信發送失敗的問題。

模板變量校驗失敗

當返回API錯誤碼為“E200028”時，表示模板變量校驗失敗，請檢查您的API參數是否填寫正確。相關參考文檔：模板和變量規范、發送短信API。

API錯誤碼

失敗原因

處理建議

E200028

API參數填寫錯誤

請檢查請求攜帶的“templateParas”參數值，對照“templateId”指定的模板，核對模板變量個數是否正確，變量長度是否小于模板變量定義的長度。

若“templateId”指定的模板為無變量模板，則請求無需攜帶“templateParas”參數；若攜帶了該參數，請置空。

當時間變量需要同時指定日期和時間時，請檢查模板中是否將日期和時間配置為兩個變量，一個變量傳入日期，另一個變量傳入時間。不要將日期和時間合成一個變量。

請檢查“其他”類型的變量賦值是否包含“.”或“。”字符，建議剔除后重試。如果變量取值為IP地址，請重新申請模板，并設置變量屬性為“金額”。

例如：

模板內容為：您的驗證碼為：，請盡快完成驗證。祝您生活愉快！

注：模板中有一個變量，變量屬性為“其他號碼”，最大長度以8個字符為例。

正確示例：

templateParas='["12345"]'; //發送短信API

templateParas=["12345678"]; //發送分批短信API

錯誤示例：

templateParas='["123","456"]'; //發送短信API，變量個數不正確

templateParas='["123456789"]'; //發送短信API，變量長度不正確

templateParas='["1a2b.3c"]'; //發送短信API，變量內容類型不正確

說明：

在申請短信模板時，需要選擇適合的變量屬性。當變量屬性選擇為“其他”類型時，默認的變量長度為1-20。運營人員在審核模板時，會根據您的變量用途做出適當的變量長度調整，如果您的變量長度較長需要擴展變量長度，請詳細備注您的變量樣例和用途說明，以便運營人員在審核模板時設定適合的變量長度。

簽名通道校驗失敗

當返回狀態碼為“E200020”時，表示短信簽名通道校驗失敗，需要檢查API參數中的簽名通道對應的簽名與模板ID對應的簽名是否一致，同時檢查簽名內容是否規范。請參考簽名規范。

狀態碼

失敗原因

處理建議

E200020

發送短信攜帶簽名和通道簽名不匹配。

簽名不規范。

請檢查from參數傳遞的通道號對應的簽名和templateId參數（短信模板ID）對應的簽名是否一致。如果是通用模板（所屬簽名為通用簽名），則必須攜帶簽名名稱（signature參數）。

將簽名中的標點符號去掉后重試。

禁用關鍵字攔截

當返回狀態碼為“SC:0006”時，表示短信因包含禁用關鍵字被攔截。請參考模板和變量規范。

狀態碼

失敗原因

處理建議

SC:0006

短信內容不合規，觸發安全管控攔截。

請檢查短信內容是否包含敏感詞，修改模板變量內容后重試。

短信發送超頻

當返回“SC:0010”等以下狀態碼時，表示短信發送超頻。點擊了解短信發送頻率限制。

狀態碼

失敗原因

處理建議

SC:0010

短信發送頻率過高，觸發安全管控攔截。

請控制短信發送頻率，分時段分批次發送短信。

出現超頻限制24小時后會自動解除，請待超頻限制解除之后再嘗試發送。

FYLIMIT

MILIMIT

一分鐘內單個號碼發送了太多短信。

等待一分鐘后再給該號碼發送短信；

LIMIT

當日給單個號碼發送的短信已經達到了下發限制。

等到第二天再給該號碼發送短信；

BEYONDN

說明：

如果發生短信發送超頻限制，建議減少發送次數。如果有業務需求，可以聯系華為云客服溝通解除下發限制。

同類的狀態碼還有：CA:1000，CS.0012，GL:0000，MD:9419，MAXFREQ等

號碼黑名單

當返回“BLACK”、“MBBLACK”等以下狀態碼時，表示號碼黑名單。

狀態碼

失敗原因

處理建議

BLACK

手機號碼位于黑名單中，可能是該號碼回復過退訂信息或者該號碼用戶向工信部投訴過。

如確認該手機需要接收短信，請聯系華為云客服解除黑名單。

TDBLACK

TSBLACK

MBBLACK

SC:0005

投訴黑名單。接收號碼狀態特殊，觸發安全管控攔截。

請從接收號碼列表中剔除特殊號碼后重試。

SC:0003

黑名單攔截。接收號碼狀態特殊，觸發安全管控攔截。

請提供號碼信息，聯系華為云客服申請解除黑名單。

說明：

不同平臺、供應商或運營商會返回不同的黑名單攔截狀態碼，建議聯系華為云客服申請解除黑名單。

同類的狀態碼還有：-10，KA:0023，CM:8003，DB:0144，MA:0027，MK:100D，DB:0141，MX:0011，MX:0005，SW:0009，DB:9006，SUPERWD等

手機終端問題

當通過狀態回執錯誤碼查詢后，提示為手機終端問題（如手機關機、停機、信號差等）時，建議您核實手機終端是否處于正常狀態。

以上，是小課為大家帶來的本次內容，還有更多短信問題，請戳常見短信問題

云小課

版權聲明：本文內容由網絡用戶投稿，版權歸原作者所有，本站不擁有其著作權，亦不承擔相應法律責任。如果您發現本站中有涉嫌抄襲或描述失實的內容，請聯系我們jiasou666@gmail.com 處理，核實后本網站將在24小時內刪除侵權內容。

版權聲明：本文內容由網絡用戶投稿，版權歸原作者所有，本站不擁有其著作權，亦不承擔相應法律責任。如果您發現本站中有涉嫌抄襲或描述失實的內容，請聯系我們jiasou666@gmail.com 處理，核實后本網站將在24小時內刪除侵權內容。