IBM Cloud Docs
SMS との統合

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 は、あなたが設定したメッセージングウェブフックを使用して、テキストメッセージ本文を含む POST リクエストをアシスタントに送信します。 アシスタントからの各レスポンスはTwilioまたは IntelePeer に送り返され、顧客に送信されるSMSメッセージに変換される。 レスポンスはSMSプロバイダーのAPIに送られ、処理される。 API アクセス資格情報として機能する SMS プロバイダーの認証トークン情報を指定します。

SMS プロバイダーの統合をセットアップするには、以下のセクションを参照してください。

顧客との対話中に音声とテキストを切り替えるには、アシスタントで電話とテキストの両方のメッセージング統合を有効にします。 統合は、同じサードパーティ・サービス・プロバイダーを使用する必要はない。 詳しくは、電話との統合を参照してください。

開始前に

Twilio をアシスタントに統合するには、少なくとも開発者役割が必要です。 詳しくは、 Twilio の役割の違いを参照してください。

テキスト・メッセージング用の電話番号がない場合は、SMS with Twilio アカウントをセットアップして電話番号を取得します。

TwilioとSMSの統合

  1. Twilio Web サイトにアクセスします。

  2. アカウントを作成します。 この統合に無料トライアル・アカウントを使用することはできません。

  3. サイドバーの 「開発」 タブで、 「電話番号」 をクリックします。 「電話番号 (Phone Numbers)」 が存在しない場合は、上部の検索バーに移動して「電話番号 (Phone Numbers)」を検索し、 「番号の購入 (Buy a number)」 を選択します。

  4. 指示に従って番号を購入する。 コンソールからTwilioの電話番号を検索し、購入する方法。

    Twilio の電話番号を取得すると、音声、SMS、MMS が自動的にサポートされます。 新しい電話番号がアクティブな番号として表示されます。

後でもう一度参照できるように、この Twilio の Web ページを Web ブラウザー・タブで開いたままにしておきます。 「電話番号 (Phone Numbers)」 をサイドバーにピン留めすることもできます。

統合のセットアップ

統合をセットアップするには、次の手順を実行します。

  1. **「統合」**ページに移動します。それには、左側のメニューにある統合アイコン (統合アイコン) をクリックします。

  2. SMS タイルの Addをクリックする。

  3. TwilioタイルでSMSをクリックします。

  4. 「確認」 をクリックします。

  5. Twilio サイトで左上のメニューにあるアカウント名をクリックして、アカウント・ダッシュボードに移動します。

    以下の値をコピーして一時的に保管し、次のステップで SMS with Twilio 統合セットアップ・ページに貼り付けることができるようにします。

    • Account SID (アカウント SID)
    • Auth token (認証トークン)

  6. SMS with Twilio 統合セットアップ・ページに戻ります。 **「次へ」**をクリックして、SMS with Twilio 統合セットアップのステップ 1 に進みます。

  7. アカウント SID 情報を入力します。 **「次へ」**をクリックして、SMS with Twilio 統合セットアップのステップ 2 に進みます。

  8. 認証トークン情報を入力します。 **「次へ」**をクリックして、SMS with Twilio 統合セットアップのステップ 3 に進みます。

  9. オプション: Twilio アカウントが SMS 統合に使用する電話番号を入力します。 Webhook URI はメッセージの転送に使用されますが、このオプション・フィールドに電話番号を追加すると、その電話番号を後で簡単に参照できます。 **「次へ」**をクリックして、SMS with Twilio 統合セットアップのステップ 4 に進みます。

  10. **「Webhook URI」**フィールドから値をコピーします。

    この URI を Twilio の Webhook 構成に追加します。 複数の電話番号をサポートする場合は、電話番号ごとに個別に Web フックに URI を追加する必要があります。

  11. Twilio アカウントの Web ページに移動します。 サイドバーの [開発] タブから、 [電話番号] > [管理] > [アクティブな番号] をクリックします。

  12. アクティブな番号 ページで、いずれかの電話番号をクリックします。

  13. 「メッセージング」セクションまでスクロールし、「Webhook」 フィールドを見つけます。このフィールドは、メッセージの着信時の処理を定義します。

    **「Webhook URI」**フィールドからコピーした値をそこに貼り付けます。

  14. 複数の電話番号をサポートする場合は、使用する電話番号ごとに前のステップを繰り返します。

  15. 保存 をクリックします。

  16. サイドバーの [開発] タブから、[ メッセージング] > [設定] > [ジオ許可] をクリックします。 メッセージング が存在しない場合は、上部の検索バーに移動し、「メッセージング」を検索して、 「SMS 地理的権限 (SMS Geographic Permissions)」 を選択します。

  17. **「メッセージング地理的許可 (Messaging geographic permissions)」**ページで、Twilio 番号をテキスト化できる電話番号の国別コードを選択します。 デフォルトでは、Twilio 番号をテキスト化するための国別コードは許可されていません。

  18. SMS with Twilio 統合セットアップ・ページに戻ります。 **「完了 (Finish)」**をクリックします。

IntelePeer によるSMS との統合

テキストメッセージの電話番号をお持ちでない場合は、 SMS with IntelePeer アカウントを設定し、電話番号を取得してください。

  1. IntelePeer Web サイトにアクセスします。

  2. アカウントを作成するか、無料トライアルを開始します。

    IntelePeer 電話番号を取得すると、音声と SMS がサポートされます。 この番号が SMS に対して自動的に有効にならない場合は、手動で有効にする必要があります。 新しい電話番号がアクティブな番号として表示されます。 大気メッセージングのクイック・スタート・ガイド を参照してください。

開始前に

IntelePeer をアシスタントに統合するには、 create、 read、 update、 delete のアクセスタイプで「SMS」サービスが必要です。 詳しくは、「 カスタマー・ポータルでのユーザーの管理」を参照してください。

統合のセットアップ

統合をセットアップするには、次の手順を実行します。

  1. **「統合」**ページに移動します。それには、左側のメニューにある統合アイコン (統合アイコン) をクリックします。

  2. SMS タイルの Addをクリックする。

  3. 「SMS with IntelePeer」 タイルを選択します。

  4. 「確認」 をクリックします。

  5. IntelePeer 大気 サイトから、 「API 認証トークン (API Authentication Token)」 の値をコピーして一時的に保管します。これにより、今後のステップで SMS with IntelePeer 統合セットアップページにその値を貼り付けることができます。

  6. IntelePeer カスタマー・ポータル ・サイトの 「マイ・アプリケーション」 セクションで、 「SMS API Management を選択します。 「SMS 管理 (SMS Management)」 タイトル・バーで、歯車アイコンをクリックします。ここで、SMS の 「シークレットの入力 (Secret Input)」 を設定します。 秘密入力は、Web サーバー Webhook が、 IntelePeerから発信されたものではないインバウンド SMS POST 要求を処理しないようにするために使用されます。 ここで 「シークレットの入力 (Secret Input)」 の値を設定します。今後のステップでは、 SMS with IntelePeer 統合セットアップ・ページでこの値を使用する必要があるためです。

  7. SMS with IntelePeer の統合設定ページに戻る。 次へ]をクリックして、 IntelePeer との SMS 連携セットアップのステップ 1 に進みます。

  8. アカウントシークレットの情報を入力してください。 次へ]をクリックして、 IntelePeer との SMS 連携設定のステップ 2 に進みます。

  9. 認証トークン情報を入力します。 次へ]をクリックして、 SMSと IntelePeer の統合セットアップのステップ3に進みます。

  10. オプション ： IntelePeer アカウントが SMS 統合に使用する電話番号を入力します。 Webhook URI はメッセージの転送に使用されますが、このオプション・フィールドに電話番号を追加すると、その電話番号を後で簡単に参照できます。 次へ]をクリックして、 SMSと IntelePeer の統合セットアップのステップ4に進みます。

  11. **「Webhook URI」**フィールドから値をコピーします。

    このURIを IntelePeer のウェブフック設定に追加する。 複数の電話番号をサポートする場合は、電話番号ごとに個別に Web フックに URI を追加する必要があります。

  12. IntelePeer カスタマー・ポータル のサイトに移動し、 「My Applications」 セクションで 「SMS API Management を選択します。

  13. SMS 用に有効化する電話番号に移動します。 数値の横にある 「有効/無効」 放射状ボタンを切り替えて、 *「有効」*に設定します。 SMS 用に電話番号がアクティブ化されるまで数分かかる場合があります。

  14. 電話番号が SMS に対して有効になると、その番号の横に Webhook アイコンが表示されます。

    **「Webhook URI」**フィールドからコピーした値をそこに貼り付けます。

  15. 保存 をクリックします。

  16. 複数の電話番号をサポートする場合は、使用する電話番号ごとに前のステップを繰り返します。

セキュリティー上の理由から、認証フィールドは初期セットアップ後にビューから削除されます。 認証に必要なフィールドが変更された場合は、関連フィールドのすべての項目に入力し、再度検証する必要があります。

Bring Your Own Provider (BYOP) SMSとの統合

統合の設定

BYOP SMS の統合を設定するには、以下の手順に従います：

  1. 統合アイコンをクリックして、 統合ページに移動します。
    ( 統合アイコン )をクリックしてください。

  2. SMS タイルの Addをクリックする。

  3. Bring Your Own SMS Provider オプションを選択します。

  4. 「確認」 をクリックします。

  5. API URL フィールドに、送信 SMS メッセージの送信に使用するエンドポイントを入力します。

  6. Verification Tokenをコピーし、安全に保管してください。
    このトークンは、 watsonx Assistant に SMS メッセージを送信する際に必要です。 次へ をクリックします。

  7. (オプション） SMS統合に使用する電話番号を入力し、［ 次へ］をクリックします。

  8. Webhook URIの値をコピーします。
    このURIを使用して、 watsonx Assistant にSMSメッセージを送信する。

  9. 保存 をクリックします。

SMS 拡張構成オプション

詳細オプションタブは、 SMS 統合を設定した後に利用できます。 **「拡張オプション」**タブをクリックして、メッセージング動作に対して以下のカスタマイズを任意に行います。

  • インバウンド・メッセージから会話を開始する (Initiate conversation from inbound messages): 電話統合の会話が進行中の状態で送信されるメッセージのみを許可し、電話通話以外でアシスタントとのメッセージ交換を開始することを顧客に許可しないようにメッセージング・サポートを制限する場合は、このオプションを無効にします。
  • デフォルトの失敗メッセージ (Default failure message): SMS 接続が失敗した場合に顧客に送信するメッセージを追加します。
  • ベース URL (Base URL): この URL は、使用する SMS サービスの REST API エンドポイントです。

メッセージング用にアクションを最適化

最高の顧客体験のために、 SMS 統合の機能を念頭に置いて行動を設計してください：

  • テキスト応答に HTML 要素を含めないでください。

  • SMS 統合では、 connect_to_agent 応答タイプで開始されたチャット転送はサポートされません。

  • 画像、音声、動画 の各応答タイプでは、メディアを含むメッセージを送信できます。 タイトルと説明が添付ファイルとともに送信されます。 エンド・ユーザーのキャリアとデバイスによっては、これらのメッセージが正常に受信されない場合があることに注意してください。 Twilio でサポートされるコンテンツ・タイプのリストについては、 Twilio: Accepted Content Types for Mediaを参照してください。

    これらのレスポンス・タイプについて詳しくは、 レスポンス・タイプのリファレンス を参照してください。

多種多様なプラットフォームにデプロイするアシスタントに対して同じアクションを使用する場合は、統合タイプごとにカスタム応答を追加できます。 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 統合に移行するには、以下のステップを完了します：

  1. 以下のいずれかを実行します。

    • Voice Agent with Watson サービスインスタンスが Twilio または IntelePeer, 以外の SMS サービスプロバイダを使用している場合、引き続き使用することはできません。 まずTwilioまたは IntelePeer でSMSアカウントを作成する必要があります。 始める前に-Twilio または 始める前に- IntelePeer の手順を完了して、アカウントを作成します。 次に、統合をセットアップします。

    • Voice Agent with Watson サービス・インスタンスが Twilio または IntelePeer を SMS プロバイダーとして使用している場合は、 「統合のセットアップ-Twilio」 または 「統合のセットアップ- IntelePeer」 に直接移動できます。