---
sourceDocument: Yokohama データと自動化
sourceDocumentLink: https://servicenow-prod.fluidtopics.net/r/ja-JP/yokohama/integrate-applications

 Release :

    - yokohama

ft:locale :

    - ja-JP

ft:publication_title :

    - Yokohama データと自動化

ft:clusterId :

    - crint

bundleId :

    - crint

workflow :

    - Creator


---

# Vonage スポークの設定

# Vonage スポークの設定 {#ariaid-title1}

* リリースバージョン: Yokohama
* 
* 更新日 2025年01月30日
* 
* ![](https://www.servicenow.com/docs/portal-asset/ico-clock) 所要時間：8分

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

## 始める前に

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

## Vonage 開発者インスタンスの構成 {#ariaid-title2}

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

### 始める前に

必要なロール：アドミン

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

### 手順

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

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

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

### 始める前に

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

### 手順

1. 移動先 すべてプロセスの自動化フローデザイナー.
2. \[接続\] を選択します。
3. \[すべての接続を検索\] フィールドに「<kbd class="ph userinput">Vonage</kbd>」と入力します。
4. Vonage カードで、\[詳細を表示\] を選択します。
5. \[構成\] を選択します。
6. フォームに入力します。  
   {#configure-connection-record-for-vonage-alias__table_vpl_zd3_5yb__entry__2}

   | フィールド | 説明 |
   |-|-|
   | 接続名 | 接続レコードのデフォルトの読み取り専用名です。接続レコードにカスタム名を付けるには、\[接続を追加\] を選択し、接続レコードを作成します。 |
   | 接続 URL | Vonage API に接続するための URL。 |
   | Message API バージョン | 接続レコードが Vonage インスタンスの SMS 機能の使用を要求する API のバージョン。 |
   | Voice API バージョン | 接続レコードが Vonage インスタンスの Voice 機能の使用を要求する API のバージョン。 |
   | 認証情報名 | 認証情報レコードの名前。更新可能な Vonage 認証情報のデフォルト名。 |
   | アプリケーション名 | Vonage 開発者アカウントの \[設定\] ページに入力したアカウントの名前。 |
   | API キー | Vonage 開発者インスタンスで取得した API キー。 |
   | API シークレット | Vonage 開発者インスタンスで取得した API シークレット。 |
   | 署名シークレット | Vonage 開発者インスタンスで取得した署名シークレットキー。 |
   [表 : 1. 接続を作成]

   {#configure-connection-record-for-vonage-alias__table_vpl_zd3_5yb}
7. \[接続を作成\] を選択します。

## Vonage プライマリエイリアスに対する接続レコードを構成する {#ariaid-title4}

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

### 始める前に

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

### 手順

1. 移動先 すべてプロセスの自動化フローデザイナー.
2. \[接続\] を選択します。
3. \[すべての接続を検索\] フィールドに「<kbd class="ph userinput">Vonage</kbd>」と入力します。
4. VonagePrimary カードで、\[詳細を表示\] を選択します。
5. \[構成\] を選択します。
6. フォームに入力します。  
   {#configure-connection-record-for-vonage-primary-alias__table_vpl_zd3_5yb__entry__2}

   | フィールド | 説明 |
   |-|-|
   | 接続名 | 接続レコードのデフォルトの読み取り専用名です。接続レコードにカスタム名を付けるには、\[接続を追加\] を選択し、接続レコードを作成します。 |
   | 接続 URL | Vonage API に接続するための URL。「<https://rest.nexmo.com>」を入力します。 |
   | API キー | Vonage 開発者インスタンスで取得した API キー。 |
   | API シークレット | Vonage 開発者インスタンスで取得した API シークレット。 |
   [表 : 2. 接続を作成]

   {#configure-connection-record-for-vonage-primary-alias__table_vpl_zd3_5yb}
7. \[接続を作成\] を選択します。
{#configure-connection-record-for-vonage-primary-alias__steps_hft_jxd_vyb}

## Vonage からデータを受信する Webhook を作成する {#ariaid-title5}

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

### 始める前に

必要なロール：admin

### 手順

1. 移動先 すべてVonage スポークVonage Webhook レジストリ.
2. \[新規\] を選択します。
3. フォーム上で、以下のフィールドに記入します。  
   {#create-sms-webhook__table_smp_4jf_pmb__entry__2}

   | フィールド | 説明 |
   |-|-|
   | 名前 | Webhook レコードを一意に識別する名前を入力します。 |
   | 説明 | Webhook レコードの説明を入力します。 |
   | イベントタイプ | Webhook が設定されているイベントのタイプを入力します。\[SMS\] を選択します。 |
   | 秘密キー | Webhook 要求を認証するための秘密キーを入力します。カスタムの秘密キーを入力します。 |
   [表 : 3. Vonage Webhook レジストリフォーム]

   {#create-sms-webhook__table_smp_4jf_pmb}
4. フォームヘッダーを右クリックし、\[保存\] を選択します。
5. \[コールバック URL\] を選択します。  
   Webhook コールバック URL が表示されます。
6. Webhook コールバック URL をコピーして記録します。
7. <https://developer.vonage.com/en/home> にログインします。
8. 左側のパネルの \[ビルド \& 管理 (Build \& Manage)\]で、\[アプリケーション\] を選択します。
9. \[アプリケーション\] ページで、アプリケーションのメニューアイコン (![メニューアイコン]()) を選択します。
10. \[編集\] を選択します。
11. \[メッセージ\] 見出しの下で、\[受信 URL\] フィールドと \[ステータス URL\] フィールドにコールバック URL を入力します。
12. 左側のパネルで、\[API 設定 (API Settings)\] を選択します。
13. \[設定\] ページの \[SMS 設定\] 見出しで、\[SMS API\] が選択されていることを確認します。
14. 値を入力します。  
    {#create-sms-webhook__table_r5h_wkf_pmb__entry__2}

    | フィールド | 値 |
    |-|-|
    | 配送受領書 (DLR) Webhook (Delivery receipts (DLR) webhooks) | Webhook コールバック URL |
    | 受信 SMS Webhook (Inbound SMS webhooks) | Webhook コールバック URL |
    [ ]

    {#create-sms-webhook__table_r5h_wkf_pmb}
15. \[変更内容を保存\] を選択します。  
    アプリケーションの SMS 設定が保存されます。

## Webhook とルーティングポリシーをカスタマイズする {#ariaid-title6}

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

### 始める前に

必要なロール：アドミン

### 手順

1. 移動先 すべてフローデザイナーデザイナー.
2. \[サブフロー\] をクリックします。
3. 必要なデフォルトのサブフローのコピーを作成します。
4. 要件に応じてサブフローをカスタマイズし、公開します。  
   サブフローを作成および使用する方法の詳細については「[サブフローのビルド](https://www.servicenow.com/docs/access?context=subflows&version=yokohama&pubname=yokohama-build-workflows&ft:locale=en-US)」を、またデフォルトのルーティングポリシーおよびサブフローがサポートするフィールドについては、「[Vonage スポーク](https://servicenow-prod.fluidtopics.net/Qh7ecKnbyE0cTPkU4TIObg "ServiceNow インスタンスから Vonage アカウントを使用して、通話、SMS、 WhatsApp による通信を管理します。")」を参照してください。
5. 移動先 Vonage スポークVonage Webhook ルーティングポリシー.
6. \[新規\] をクリックします。
7. フォームで、フィールドに入力します。  
   {#cust-routing-vonage__table_awj_xgv_z3b__entry__2}

   | フィールド | 説明 |
   |-|-|
   | ラベル | ルーティングポリシーを識別する一意のラベルです。 |
   | デフォルトの回答 | この回答がデフォルトの回答かどうかを指定するオプションです。デフォルトの回答は、条件が満たされない場合に適用されます。 1. \[ルックアップ\] アイコン (![ルックアップアイコン]()) をクリックします。 2. ドキュメントリストから必要なサブフローを選択します。 注: \[テーブル名\] が<kbd class="ph userinput">フロー [sys_hub_flow]</kbd> であることを確認します。 {#cust-routing-vonage__ol_sdf_ftb_1jb} |
   | 条件 | Vonage で必要なイベントが発生したときに満たされる条件。サポートされている Vonage フィールドは次のとおりです。 * キーワード * コール方向 * コールのステータス * イベントタイプ * 開始 * SMS ステータス * SMS テキスト * 終了 * WhatsApp メッセージステータス * WhatsApp 1 行テキスト * 関連フィールドを表示 {#cust-routing-vonage__ul_yks_qpf_pmb} |
   | 回答 | 指定された条件が満たされるとトリガーされるサブフローです。 |
   [表 : 4. 意思決定フォーム]

   {#cust-routing-vonage__table_awj_xgv_z3b}
8. \[送信\] をクリックします。  
   注:  
   これらのルーティングポリシーは意思決定テーブルに保存されます。ユーザーは、これらのテーブルのデータを直接更新または変更しないように注意してください。
{#cust-routing-vonage__steps_vjr_z4f_pmb}