Vonage スポークの設定

  • リリースバージョン: Australia
  • 更新日 2026年03月12日
  • 所要時間：8分

    • ServiceNow インスタンスを Vonage インスタンスと統合して、それらの間の通信を有効にします。この統合により、ServiceNow インスタンスは Vonage インスタンスに対するアクションを自動化できると同時に、Vonage インスタンスはペイロードを ServiceNow インスタンスに送信できます。

    始める前に

    • 統合ハブサブスクリプションを要求します。
    • ServiceNow インスタンスの Vonage スポークプラグインをアクティブ化します。
    • 必要なロール：admin
    • Vonage 開発者インスタンスアカウント。

    Vonage 開発者インスタンスの構成

    API キー、シークレット、署名シークレットなどの重要な認証情報を生成して、Vonage 開発者インスタンスを設定します。ServiceNow インスタンスは、接続レコードでこれらの認証情報を使用して Vonage 開発者インスタンスに接続します。

    始める前に

    必要なロール：admin

    Vonage 開発者アカウントにアクセスします。

    手順

    1. https://developer.vonage.com/en/home にログインします。
    2. Vonage[開発者センター (Developer Center)] ページで、[自分のダッシュボード (My dashboard)] を選択します。[自分のダッシュボード (My dashboard)] ページ。
    3. [Vonage API ダッシュボード (Vonage API Dashboard)] ページで、デフォルトの API キーと API シークレットを使用するか、またはカスタム API キーと API シークレットを作成します。
      1. デフォルトの API キーと API シークレットを使用するには、デフォルトの API キーと API シークレットの値をコピーします。API キーと API シークレットの [コピー] ボタン。
      2. カスタム API キーと API シークレットを生成するには、左側のパネルで [API 設定 (API Settings)] を選択します。API 設定のリンク。
      3. [追加の API キーを要求する (Request more API keys)] を選択します。
      4. フォームに入力して送信します。
      5. [シークレットを新規作成 (Create new secret)] を選択します。
      6. [シークレットの新規追加 (Add a new secret)] ウィンドウで、カスタムシークレットを入力します。
      7. [保存] を選択します。
    4. [署名シークレット (Signature secret)] フィールドから、署名シークレットをコピーします。

    Vonage 接続および資格情報エイリアスに対する接続レコードを構成する

    ServiceNow インスタンスが Vonage インスタンスに接続し、Vonage インスタンスに対するさまざまなアクションを自動化できるようにする接続レコードを構成します。たとえば、Vonage 口座の残高を取得する ワークフロースタジオ のフローを作成します。

    始める前に

    必要なロール：admin
    注:
    [Vonage スポーク] スコープ内にいることを確認します。

    手順

    1. 移動先 すべて > プロセス自動化 > フローデザイナー.
    2. [接続] を選択します。
    3. [すべての接続を検索] フィールドに「Vonage」と入力します。[すべての接続を検索] フィールド。
    4. Vonage カードで、[詳細を表示] を選択します。
    5. [構成] を選択します。
    6. フォームに入力します。
      表 : 1. 接続を作成
      フィールド 説明
      接続名 接続レコードのデフォルトの読み取り専用名です。接続レコードにカスタム名を付けるには、[接続を追加] を選択し、接続レコードを作成します。
      接続 URL Vonage API に接続するための URL。
      Message API バージョン 接続レコードが Vonage インスタンスの SMS 機能の使用を要求する API のバージョン。
      Voice API バージョン 接続レコードが Vonage インスタンスの Voice 機能の使用を要求する API のバージョン。
      認証情報名 認証情報レコードの名前。更新可能な Vonage 認証情報のデフォルト名。
      アプリケーション名 Vonage 開発者アカウントの [設定] ページに入力したアカウントの名前。Vonage インスタンスのアカウント名フィールド。
      API キー Vonage 開発者インスタンスで取得した API キー。
      API シークレット Vonage 開発者インスタンスで取得した API シークレット。
      署名シークレット Vonage 開発者インスタンスで取得した署名シークレットキー。
    7. [接続を作成] を選択します。

    Vonage プライマリエイリアスに対する接続レコードを構成する

    ServiceNow インスタンスが Vonage インスタンスに接続し、Vonage インスタンスに対するさまざまなアクションを自動化できるようにする接続レコードを構成します。たとえば、Vonage 口座の残高を取得する ワークフロースタジオ のフローを作成します。

    始める前に

    必要なロール：admin
    注:
    [Vonage スポーク] スコープ内にいることを確認します。

    手順

    1. 移動先 すべて > プロセス自動化 > フローデザイナー.
    2. [接続] を選択します。
    3. [すべての接続を検索] フィールドに「Vonage」と入力します。[すべての接続を検索] フィールド。
    4. VonagePrimary カードで、[詳細を表示] を選択します。
    5. [構成] を選択します。
    6. フォームに入力します。
      表 : 2. 接続を作成
      フィールド 説明
      接続名 接続レコードのデフォルトの読み取り専用名です。接続レコードにカスタム名を付けるには、[接続を追加] を選択し、接続レコードを作成します。
      接続 URL Vonage API に接続するための URL。「https://rest.nexmo.com」を入力します。
      API キー Vonage 開発者インスタンスで取得した API キー。
      API シークレット Vonage 開発者インスタンスで取得した API シークレット。
    7. [接続を作成] を選択します。

    Vonage からデータを受信する Webhook を作成する

    SMS 用の Webhook を設定して、Vonage API プラットフォームが ServiceNow インスタンスにデータを送信できるようにします。たとえば、ServiceNow インスタンスのフローが呼び出しの詳細の API 要求を Vonage API に送信したにもかかわらず、その要求が最初に失敗した場合、Webhook は Vonage API が後でデータを送信するようにします。

    始める前に

    必要なロール：admin

    手順

    1. 移動先 すべて > Vonage スポーク > Vonage Webhook レジストリ.
    2. [新規] を選択します。
    3. フォーム上で、以下のフィールドに記入します。
      表 : 3. Vonage Webhook レジストリフォーム
      フィールド 説明
      名前 Webhook レコードを一意に識別する名前を入力します。
      説明 Webhook レコードの説明を入力します。
      イベントタイプ Webhook が設定されているイベントのタイプを入力します。[SMS] を選択します。
      秘密キー Webhook 要求を認証するための秘密キーを入力します。カスタムの秘密キーを入力します。
    4. フォームヘッダーを右クリックし、[保存] を選択します。
    5. [コールバック URL] を選択します。
      Webhook コールバック URL が表示されます。
    6. Webhook コールバック URL をコピーして記録します。
    7. https://developer.vonage.com/en/home にログインします。
    8. 左側のパネルの [ビルド & 管理 (Build & Manage)]で、[アプリケーション] を選択します。[ビルド & 管理 (Build & Manage)] の下の [アプリケーション] リンク。
    9. [アプリケーション] ページで、アプリケーションのメニューアイコン (メニューアイコン) を選択します。自分のアプリケーション。
    10. [編集] を選択します。
    11. [メッセージ] 見出しの下で、[受信 URL] フィールドと [ステータス URL] フィールドにコールバック URL を入力します。メッセージ設定。
    12. 左側のパネルで、[API 設定 (API Settings)] を選択します。
    13. [設定] ページの [SMS 設定] 見出しで、[SMS API] が選択されていることを確認します。
    14. 値を入力します。
      フィールド 値
      配送受領書 (DLR) Webhook (Delivery receipts (DLR) webhooks) Webhook コールバック URL
      受信 SMS Webhook (Inbound SMS webhooks) Webhook コールバック URL
    15. [変更内容を保存] を選択します。
      アプリケーションの SMS 設定が保存されます。

    Webhook とルーティングポリシーをカスタマイズする

    要件に応じて、Webhook ルーティングポリシーとサブフローをカスタマイズします。

    始める前に

    必要なロール：admin

    手順

    1. 移動先 すべて > フローデザイナー > デザイナー.
    2. [サブフロー] をクリックします。
    3. 必要なデフォルトのサブフローのコピーを作成します。
    4. 要件に応じてサブフローをカスタマイズし、公開します。
      サブフローを作成および使用する方法の詳細については「サブフローのビルド」を、またデフォルトのルーティングポリシーおよびサブフローがサポートするフィールドについては、「Vonage スポーク」を参照してください。
    5. 移動先 Vonage スポーク > Vonage Webhook ルーティングポリシー.
    6. [New] をクリックします。
    7. フォームのフィールドに入力します。
      表 : 4. 意思決定フォーム
      フィールド 説明
      ラベル ルーティングポリシーを識別する一意のラベルです。
      デフォルトの回答 この回答がデフォルトの回答かどうかを指定するオプションです。デフォルトの回答は、条件が満たされない場合に適用されます。
      1. [ルックアップ] アイコン (ルックアップアイコン) をクリックします。
      2. ドキュメントリストから必要なサブフローを選択します。
        注:
        [テーブル名] がフロー [sys_hub_flow] であることを確認します。
      条件 Vonage で必要なイベントが発生したときに満たされる条件。サポートされている Vonage フィールドは次のとおりです。
      • キーワード
      • コール方向
      • コールのステータス
      • イベントタイプ
      • 送信元
      • SMS ステータス
      • SMS テキスト
      • 宛先
      • WhatsApp メッセージステータス
      • WhatsApp 1 行テキスト
      • 関連フィールドを表示
      回答 指定された条件が満たされるとトリガーされるサブフローです。
    8. [送信] をクリックします。
      注:
      これらのルーティングポリシーは意思決定テーブルに保存されます。ユーザーは、これらのテーブルのデータを直接更新または変更しないように注意してください。