Vonage スポークの設定

  • リリースバージョン: Washingtondc
  • 更新日 2024年02月01日
  • 読む7読むのに数分

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

    始める前に

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

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

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

    始める前に

    必要なロール：admin

    Vonage開発者アカウントへのアクセス。

    手順

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

    Vonage の接続および資格情報エイリアスの接続レコードの構成

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

    始める前に

    必要なロール：管理者

    手順

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

    Vonage の接続レコードの設定 プライマリエイリアス

    インスタンスがインスタンスに接続し、Vonageインスタンスに対するVonageさまざまなアクションを自動化できるようにするServiceNow接続レコードを構成します。たとえば、アカウントの残高を取得する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. 左側のパネルの [ビルドと管理] で、[アプリケーション] を選択します。[ビルドと管理] の下の [アプリケーション] リンク。
    9. [アプリケーション] ページで、アプリケーションのメニューアイコン ( メニューアイコン) を選択します。マイアプリケーション。
    10. [編集] を選択します。
    11. [メッセージ] 見出しの下で、[受信 URL] フィールドと [ステータス URL] フィールドにコールバック URL を入力します。メッセージ設定。
    12. 左側のパネルで、 [API 設定] を選択します。
    13. [設定] ページの [SMS 設定] 見出しで、[ SMS API] が選択されていることを確認します。
    14. 値を入力します。
      フィールド 値
      配送確認 (DLR) Webhook Webhook コールバック URL
      受信 SMS Webhook Webhook コールバック URL
    15. [変更内容の保存] を選択します。
      アプリケーションの SMS 設定が保存されます。

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

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

    始める前に

    必要なロール：管理者

    手順

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