使用 SMS Gateway 來設置 MMS 傳訊

SMS Gateway 可以與 Voice Gateway (VGW)、Watson Assistant (WA) 或服務編排引擎 (SOE) 之間往來傳送或接收影像。

「多媒體傳訊服務 (MMS)」是一種透過文字簡訊通道來傳送多媒體(例如:影像)的標準方式。只要使用者有使用 Twilio Programmable SMS 來設置一或多個電話號碼,就可以透過 SMS Gateway 來傳送及接收 MMS 訊息。Twilio 會強制限制 MMS 訊息的大小、數量和內容類型。目前,Twilio 完整支援 .jpeg.gif.png 影像格式,並接受其他的 MIME 內容類型。使用者最多可在單一訊息要求中包含 10 個影像,但是訊息大小總計不得超過 5 MB。只有美國和加拿大的電話號碼,才支援透過 SMS Gateway 進行 MMS 傳訊。

出埠 MMS 支援

當服務編排引擎或 Watson Assistant 傳送 MMS 訊息給使用者時(帶有或不帶有 SMS 文字訊息),會將一或多個可公開存取的媒體 URL 傳送給 Twilio。Twilio 不支援非公用 URL。

利用 SMS Gateway 從 SOE 或 Watson Assistant 啟用 MMS

SOE 或 WA新增了 smsActSendMedia 動作指令,其中含有 mediaURL 參數。如需相關資訊,請參閱 SMS Gateway 的 API

利用管道要求來啟用 MMS

Watson Assistant 中所配置的 SOE 或 WA 更新了現有的 vgwActSendSMS 動作,而在這個動作中新增了 mediaURL 參數。如需相關資訊,請參閱 Voice Gateway API 中的動作標籤和狀態變數

現有的 REST 管道 API 已更新,而具有一個選用的 smsMediaURL 要求變數。smsMediaURL 要求變數會指定要在 MMS 訊息中傳送的可公開存取媒體 URL。如需相關資訊,請參閱使用 REST API 來控制 SMS 階段作業

入埠 MMS 支援

當 SMS Gateway 收到來自 SMS 提供者的 MMS 要求時,會在要求環境定義中新增 smsMedia 狀態變數。接著,SMS Gateway 會將該要求直接傳送給 WA 或 SOE,或者透過管道要求,將它傳達給 Voice Gateway。若有啟用 Voice Gateway,它會在環境定義中新增 vgwSMSMedia 狀態變數,並傳送要求給 WA 或 SOE。如需相關資訊,請參閱 SMS Gateway 的 APIVoice Gateway API 中的動作標籤和狀態變數

下列範例顯示來自「SMS 提供者」的 MMS 訊息要求環境定義,其中含有兩個影像 URL。SMS Gateway 會針對每一個 URL,各新增 smsMedia 狀態變數和 mediaContentType 參數。然後它會將要求傳送給 SOE 或 WA,或透過「管道要求」傳送給 VGW。

"smsMedia":[
{"mediaURL":"https://api.twilio.com/2010-04-01/Accounts/ACxxxxxxxxxxxxxxxcac7a6f05427c4bff3/Messages/MM7d78f699365a682f2441cd45496cb3d9/Media/ME61e988e5132dac150axxxxxfaea4a364",  
"mediaContentType":"image/jpeg"},
{"mediaURL":"https://api.twilio.com/2010-04-01/Accounts/ACxxxxxxxxxxxxxxxcac7a6f05427c4bff3/Messages/MM7d78f699365a682f2441cd45496cb3d9/Media/MEaaf3424e479605cbdxxxxx7360cf6ede",   
"mediaContentType":"image/jpeg"}
]

疑難排解

如果您使用 Twilio 透過 SMS Gateway 來傳送或接收 MMS 訊息,會將媒體儲存在您的 Twilio 帳戶中。如果想進一步瞭解管理影像,以及如何刪除它們,請造訪「Twilio 媒體資源」頁面

如果順利將 MMS 要求傳送給 SMS 提供者,但卻未能送抵使用者,請檢查該要求相關聯之 MMS 提供者帳戶(例如 Twilio)中的錯誤日誌。

一些常見錯誤

Twilio 帳戶最多能夠在 MMS 訊息中傳送 10 個媒體 URL。如果 MMS 訊息所包含的 URL 超過 10 個,則會產生錯誤,如下列範例所示。


Error = {\"code\": 21623, \"message\": \"The number of media URLs 13 exceeds the max allowed (10)\", \"more_info\": \"https://www.twilio.com/docs/errors/21623\"

Twilio 只完整支援 .jpeg.gif.png 影像格式,不過,可能接受其他的內容類型。如果 MMS 訊息包含無法接受的內容類型,會發生下列錯誤。

Error
     12300 Twilio is unable to process the Content-Type of the provided URL. Please see the <a href="/docs/api/twiml/">Twilio Markup XML Documentation</a> for more information on valid Content-Types.

如需內容類型的相關資訊,請參閱 Twilio 的可接受的媒體內容類型