SMS 整合參照
將動作指令新增至訊息 context 物件，以管理與透過電話提交 SMS 訊息來與您助理互動之客戶的交談流程。
了解SMS整合使用的支援的命令和保留的上下文變數。
支援的指令
每一個動作各包含一個 command 內容，後面接著選用的 parameter 內容，用來為需要參數的指令定義這些參數。 SMS整合支援下表中所述的命令。
| 動作指令 | 說明 | 參數 |
|---|---|---|
terminateSession |
結束現行 SMS 階段作業。 使用此指令，確定後續文字訊息會啟動新的助理層次階段作業，而此階段作業不會保留現行階段作業中的任何環境定義值。 | 無 |
smsActSendMedia |
啟用 MMS 傳訊。 | mediaURL：指定要傳送給使用者之可公開存取媒體 URL 的 JSON 陣列。 |
smsActSetDisambiguationConfig |
配置如何處理澄清清單中所顯示的選項。 | prefixText：要在每個選項之前包含的文字。 例如，Press %s for，其中 %s 代表對應於清單選項的號碼；這會在執行時期取代為實際號碼。 |
smsActSetOptionsConfig |
配置如何處理選項回應類型。 | prefixText：要在每個選項之前包含的文字。 例如，Press %s for，其中 %s 代表對應於清單選項的號碼；這會在執行時期取代為實際號碼。 |
保留的環境定義變數
下表描述了在SMS整合上下文中具有特殊意義的上下文變數。 它們不應該用於記載使用之外的任何目的。
表 2 描述了您的操作設定的上下文變數。 表 3 描述了您可以透過SMS整合設定的上下文變數。
表 2. 您的動作所設定的環境定義變數
| 環境定義變數名稱 | 期望值 | 說明 |
|---|---|---|
smsConversationResponseTimeout |
時間（毫秒） | 整合等待接收操作回應的時間（以毫秒為單位）。 如果超過時間限制，整合將嘗試再次聯繫該操作。 如果仍無法連到服務，則 SMS 回應失敗。 |
表 3. 由整合設定的上下文變數
| 環境定義變數名稱 | 說明 |
|---|---|
smsTenantPhoneNumber |
使用者正在傳訊的整合租戶電話號碼。 |
smsUserPhoneNumber |
與整合交換訊息之使用者的電話號碼。 |
smsUserData |
要逐項傳遞至服務編排引擎或 watsonx Assistant 服務的 JSON 格式資料。 僅當從整合租戶啟動階段作業並透過 REST API 傳送資料時，才會傳送此變數。 |
smsSessionTimeoutCount |
階段作業逾時值。 只有在透過 REST API 定義逾時值時，才會傳送此變數。 |
smsError |
當整合無法傳送 SMS 訊息時，此變數會包含所發生錯誤的詳細資料。 |
smsSessionID |
相關「SMS 閘道」階段作業的廣域唯一識別碼 (GUID)。 |
smsMedia |
arraylist 的 mediaURL 和對應的 mediaContentType。 在每一回交談結束時，會清除這個環境定義變數。 |