與 SMS 整合
IBM Cloud
停用通知:IntelePeer 免費電話號碼服務為 watsonx Assistant 自 2025 年 7 月 31 日起,IntelePeer 免費電話號碼服務將終止,watsonx Assistant。 此日期之後,使用此服務的電話號碼不再連接,使用者無法撥打或接聽電話。 為了確保持續服務,請將您的電話號碼遷移至 Twilio 或其他電話服務供應商。 更新您的電話號碼,並在 watsonx Assistant 中調整您的整合設定。 如需過渡協助,請透過 https://www.ibm.com/mysupport/ 聯絡支援人員。
新增文字簡訊整合,讓您的助理可以與客戶交換訊息。
「簡訊服務 (SMS)」支援純文字訊息。 SMS 通常會將文字訊息長度限制為 160 個字元。 「多媒體傳訊服務 (MMS)」支援傳送長度超過 160 個字元的影像和文字訊息。 當您建立具有 Twilio 的電話號碼時,系統會自動包含 MMS 訊息支援。 IntelePeer MMS 訊息支援尚無法使用。
客戶傳送簡訊至您的託管電話號碼。 Twilio 和 IntelePeer 使用您設定的訊息 webhook,將包含文字訊息正文的 POST 請求傳送給您的助理。 來自助理的每個回應都會傳回 Twilio 或 IntelePeer,轉換為向外 SMS 訊息,並發送給客戶。 回應會傳送到 SMS 供應商的 API 進行處理。 您提供 SMS 提供者的鑑別記號資訊,作為您的 API 存取認證。
請參閱下列各節,以設定 SMS 提供者的整合:
若要在客戶互動期間切換語音和文字,請同時啟用助理中的電話和文字訊息整合功能。 整合不需要使用相同的第三方服務供應商。 如需相關資訊,請參閱與電話整合。
開始之前
若要整合 Twilio 與助理,您必須至少具有「開發人員」角色。 如需相關資訊,請參閱 Twilio 的角色差異。
如果您沒有簡訊電話號碼,請設定 SMS with Twilio 帳戶並取得電話號碼。
將 SMS 與 Twilio 整合
-
移至 Twilio 網站。
-
建立一個帳戶。 免費試用帳戶無法用於此整合。
-
從資訊看板中的 開發 標籤,按一下 電話號碼。 如果 電話號碼 不存在,請跳至頂端的「搜尋列」並搜尋「電話號碼」,然後選取 購買號碼。
-
依照指示購買號碼。 如何從控制台搜尋和購買 Twilio 電話號碼。
當您取得 Twilio 電話號碼時,該電話號碼會自動支援語音、SMS 和 MMS。 您的新電話號碼會被列為作用中號碼。
在 Web 瀏覽器標籤中保持開啟 Twilio 網頁,以供您稍後再次進行參照。 您也可以將 電話號碼 釘選至資訊看板。
設定整合
若要設定整合,請完成下列步驟:
-
按一下左功能表中的整合圖示 (
),以移至 整合 頁面。
-
按一下 SMS 磚上的 新增。
-
按一下 SMS with Twilio 磁磚。
-
請按一下確認。
-
從 Twilio 網站,按一下左上方功能表中的帳戶名稱,以移至帳戶儀表板。
複製下列值並暫時儲存,以便在接下來的步驟中貼入 SMS 與 Twilio 整合設定頁面。
- 帳戶 SID
- 鑑別記號
-
回到 SMS with Twilio 整合設定頁面。 按 下一步,以跳至 SMS with Twilio 整合設定的步驟 1。
-
輸入您的帳戶 SID 資訊。 按 下一步,以跳至 SMS with Twilio 整合設定的步驟 2。
-
輸入 鑑別記號 資訊。 按 下一步,以跳至 SMS with Twilio 整合設定的步驟 3。
-
選用: 輸入 Twilio 帳戶用於 SMS 整合的電話號碼。 Webhook URI 是用來傳送訊息,但如果您在此選用欄位中新增電話號碼,則稍後可以輕鬆地參照它。 按 下一步,以跳至 SMS with Twilio 整合設定的步驟 4。
-
複製 Webhook URI 欄位的值。
您將此 URI 新增至 Twilio 中的 Webhook 配置。 如果您想要支援多個電話號碼,則必須針對每一個電話號碼分別將 URI 新增至 Webhook。
-
移至 Twilio 帳戶網頁。 從資訊看板中的 開發 標籤,按一下 電話號碼> 管理> 作用中號碼。
-
從「作用中號碼」頁面中,按一下其中一個電話號碼。
-
捲動至訊息部分,然後尋找 Webhook 欄位,該欄位定義當有訊息傳入時該如何處理。
將您從 Webhook URI 欄位複製的值貼進去。
-
如果您想要支援多個電話號碼,請針對您要使用的每一個電話號碼重複前一個步驟。
-
按一下儲存。
-
從資訊看板中的 開發 標籤,按一下 傳訊> 設定> 地理許可權。 如果 傳訊 不存在,請移至頂端的「搜尋列」並搜尋「傳訊」,然後選取 SMS 地理許可權。
-
從「傳訊地理許可權」頁面中,選取可以為 Twilio 號碼提供文字的電話號碼的國碼。 依預設,不容許國碼為您的 Twilio 號碼提供文字。
-
回到 SMS with Twilio 整合設定頁面。 按一下完成。
使用 IntelePeer 整合 SMS
如果您沒有簡訊電話號碼,請設定 SMS with IntelePeer 帳戶並取得電話號碼。
-
移至 IntelePeer 網站。
-
建立帳戶,或開始免費試用。
當您取得 IntelePeer 電話號碼時,它支援語音及 SMS。 如果未自動啟用 SMS 的號碼,您將需要手動啟用它。 您的新電話號碼會被列為作用中號碼。 請參閱 Atmosphere Messaging Quick Start Guide
開始之前
要將 IntelePeer 與您的助理整合,您需要「SMS」服務,且存取類型為 create
, read
, update
,和 delete
。 如需相關資訊,請參閱 在客戶入口網站中管理使用者。
設定整合
若要設定整合,請完成下列步驟:
-
按一下左功能表中的整合圖示 (
),以移至 整合 頁面。
-
按一下 SMS 磚上的 新增。
-
選取 SMS with IntelePeer 磚。
-
請按一下確認。
-
從 IntelePeer Atmosphere 網站中,複製 API 鑑別記號 值並暫時儲存它,以便您可以在接下來的步驟中將它貼至 SMS with IntelePeer 整合設定頁面。
-
從 IntelePeer 客戶入口網站 網站的 我的應用程式 區段下,選取 SMS API Management。 在 SMS 管理 標題列中,按一下齒輪圖示,您將在這裡設定 SMS 密鑰輸入。 「密鑰輸入」用來防止您的 Web 伺服器 Webhook 處理任何未源自 IntelePeer的入埠 SMS POST 要求。 在這裡設定 密鑰輸入 值,並記住它,因為您將需要在接下來的步驟中使用 SMS with IntelePeer 整合設定頁面中的值。
-
回到 SMS with IntelePeer 整合設定頁面。 按 下一步,以跳至 SMS with IntelePeer 整合設定的步驟 1。
-
輸入您的帳戶保密資訊。 按 下一步,以跳至 SMS with IntelePeer 整合設定的步驟 2。
-
輸入 鑑別記號 資訊。 按 下一步,以跳至 SMS with IntelePeer 整合設定的步驟 3。
-
可選:輸入 IntelePeer 帳戶用於 SMS 整合的電話號碼。 Webhook URI 是用來傳送訊息,但如果您在此選用欄位中新增電話號碼,則稍後可以輕鬆地參照它。 按一下下一步,進入 SMS 與 IntelePeer 整合設定的步驟 4。
-
複製 Webhook URI 欄位的值。
您將此 URI 新增至 IntelePeer中的 Webhook 配置。 如果您想要支援多個電話號碼,則必須針對每一個電話號碼分別將 URI 新增至 Webhook。
-
移至 IntelePeer 客戶入口網站 網站,在「我的應用程式」區段下,選取 SMS API Management。
-
跳至您要針對 SMS 啟用的電話號碼。 切換數字旁邊的 已啟用/已停用 放射狀按鈕,並將它設為 已啟用。 可能需要幾分鐘,才能啟動 SMS 的電話號碼。
-
一旦啟用 SMS 的電話號碼,您會在號碼旁看到 Webhook 圖示。
將您從 Webhook URI 欄位複製的值貼進去。
-
按一下儲存。
-
如果您想要支援多個電話號碼,請針對您要使用的每一個電話號碼重複前一個步驟。
基於安全理由,在起始設定之後,會從視圖中移除鑑別欄位。 如果變更鑑別所需的欄位,則必須重新填寫並驗證相關欄位中的所有項目。
與自攜供應商 (BYOP) SMS 整合
設定整合
要設定 BYOP SMS 整合,請遵循以下步驟:
-
按一下整合圖示進入整合頁面
(左邊功能表中的)。
-
按一下 SMS 磁磚上的 [ 新增 ]。
-
選擇「自備 SMS 供應商」選項。
-
請按一下確認。
-
在 API URL 欄位中,輸入用於傳送外寄 SMS 訊息的端點。
-
複製驗證令牌並妥善保存。
當您傳送 SMS 訊息到 watsonx Assistant 時,您需要這個令牌。 按下一步。 -
(可選) 輸入要用於 SMS 整合的電話號碼,然後按一下下一步。
-
複製 Webhook URI 值。
使用此 URI 將 SMS 訊息傳送至 watsonx Assistant。 -
按一下儲存。
SMS 進階配置選項
在您設定 SMS 整合之後,可以使用 進階選項 標籤。 按一下進階選項索引標籤,對訊息傳送行為進行下列任何自訂:
- 從入埠訊息起始交談:如果您要限制傳訊支援,僅容許在進行中電話整合交談環境定義中傳送的訊息,而且不容許客戶在通話外部啟動與助理的訊息交換,則請停用此選項。
- 預設失敗訊息:如果 SMS 連線失敗,則請新增要傳送給客戶的訊息。
- 基本 URL:此 URL 是您正在使用的 SMS 服務的 REST API 端點。
優化訊息傳送的動作
為了獲得最佳的客戶體驗,請在設計您的動作時考慮 SMS 整合的功能:
-
不要在文字回應中包含 HTML 元素。
-
SMS 整合不支援以 connect_to_agent 回應類型起始的會談轉接。
-
影像、音訊、視訊 回應類型容許傳送包含媒體的訊息。 隨附件一起傳送標題和說明。 請注意,視一般使用者的載波和裝置而定,這些訊息可能無法順利接收。 如需 Twilio 支援的內容類型清單,請參閱 Twilio: 接受的媒體內容類型。
如需這些回應類型的相關資訊,請參閱 回應類型參照。
如果您要對部署到許多不同平台的助手使用相同的動作,請針對整合類型新增自訂回應。 您可以新增條件回應,告訴助理僅在使用 SMS 整合時才顯示回應。
如需參考文件,請參閱 SMS 整合參照。
疑難排解
尋找您在使用整合時可能遇到之問題的解決方案。
- 如果您收到 禁止 訊息,則表示無法驗證您在配置整合時指定的電話號碼。 請確定號碼完全符合 SMS 電話號碼。
從 Voice Agent with Watson 移轉
如果您已在 IBM Cloud 中建立 IBM® Voice Agent with Watson 服務實例,讓客戶能夠與助理交換文字訊息,請改用 SMS 整合。
SMS 整合提供與助理更緊密的整合,並視需要支援任意數目的電話號碼。 不過,整合目前不支援下列功能:
- 啟動僅限 SMS 與送出文字的互動
- 配置備份位置
- 檢閱使用情形摘要頁面。 請改用 IBM Log Analysis。
若要從 Voice Agent with Watson 移轉至 watsonx Assistant SMS 整合,請完成下列步驟:
-
執行下列其中一項作業:
-
如果您的Voice Agent with Watson服務實例使用 Twilio 或IntelePeer,您將無法繼續使用它。 您必須先建立具有 Twilio 或 IntelePeer 的 SMS 帳戶。 完成 開始之前-Twilio 或 開始之前- IntelePeer 步驟以建立帳戶。 接下來,設定整合。
-
如果 Voice Agent with Watson 服務實例使用 Twilio 或 IntelePeer 作為其 SMS 提供者,您可以直接移至 設定整合-Twilio 或 設定整合- IntelePeer。
-