Vonage スポーク

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

    • ServiceNow インスタンスから Vonage アカウントを使用して、通話、SMS、 WhatsApp による通信を管理します。

    ストアでアプリを要求する

    ServiceNow Store Web サイトにアクセスして利用可能なすべてのアプリを表示し、ストアにリクエストを送信する方法について確認してください。リリースされたすべてのアプリのリリースノート情報については、「ServiceNow Storeバージョン履歴のリリースノート」を参照してください。

    統合ハブサブスクリプション

    このスポークには Integration Hub のサブスクリプションが必要です。詳細については、「法務スケジュール - IntegrationHub の概要」を参照してください。

    スポークバージョン

    Vonage スポーク v1.1.3 が最新バージョンです。

    サポートされているバージョン

    このスポークは、次の Vonage バージョン用に構築されていますが、それ以降のバージョンと互換性がある可能性があります。
    • Message API バージョン v0.1
    • Voice API バージョン v1

    スポークの要件

    スポークの依存関係

    アプリのインストールで問題が発生した場合は、次の依存プラグインがインストールされていることを確認してください。
    • ServiceNowIntegrationHub アクションステップ - REST (com.glide.hub.action_step.rest)
    • ServiceNow IntegrationHub Runtime (com.glide.hub.integration.runtime)
    • Complex Object (com.glide.cobject)
    • ServiceNow Flow Designer - Dynamic Inputs (com.glide.hub.dynamic_inputs)
    注:
    これらのプラグインの一部はライセンス可能な機能であり、スポーク実装の外部で使用する場合は適切なライセンスが必要です。

    スポークのサブフロー

    Vonage スポークでは、Vonage タスクの自動化をデモするサンプルサブフローが提供されます。サンプルサブフローをカスタマイズするには、新しいアプリケーションスコープにコピーします。利用可能なサンプルサブフローは次のとおりです。

    サブフロー 説明
    Vonage SMS Webhook Vonage からの SMS 要求を処理します。
    Vonage 音声 Webhook Vonage からの音声要求を処理します。
    Vonage WhatsApp Webhook Vonage からの WhatsApp 要求を処理します。
    デフォルトのサブフローをカスタマイズするには、サンプルサブフローのコピーを作成し、要件に従ってサブフローをカスタマイズする必要があります。サブフローをカスタマイズするときは、サブフローが無限ループを回避するように構成されていることを確認する必要があります。

    スポークのアクション

    Vonage スポークでは、ServiceNow インスタンスでイベントが発生したとき、Vonage タスクを自動化するアクションが提供されます。使用可能なアクションは次のとおりです。

    カテゴリ アクション 説明
    アカウント管理 アカウント残高を取得 Vonage アカウントの現在の残高を取得します。
    コール管理 DTMF トーンをコールに再生 DTMF (デュアルトーンマルチ周波数) トーンをアクティブなコールに再生します。
    記録を ServiceNow レコードに添付 通話記録をターゲット ServiceNow レコードに添付します。
    発信コールを作成 電話番号への発信コールを作成します。
    NCCO を生成 発信コールの作成アクションで使用される Nexmo Call Control Object (NCCO) を構築します。
    コールの詳細を取得 指定されたコールの詳細を取得します。
    コールを検索 指定されたコールの詳細を取得します。
    オーディオをコールに再生 アクティブなコールにオーディオファイルを再生します。
    テキスト読み上げをコールに再生 アクティブなコールにテキスト読み上げを再生します。
    コールへのオーディオ再生を停止 アクティブなコールへのオーディオファイルの再生を停止します。
    コールへのテキスト読み上げを停止 アクティブなコールへのテキスト読み上げを停止します。
    コールを更新 アクティブなコールのステータスを更新します。
    番号管理 自分の番号を検索 Vonage アカウントに関連付けられているすべての受信番号を取得します。
    SMS 管理 SMS 送信 SMS (ショートメッセージサービス) を電話番号に送信します。
    WhatsApp 管理 連絡先を送信 連絡先を WhatsApp 番号に送信します。
    場所を送信 場所の地理座標を WhatsApp 番号に送信します。
    メディアメッセージを送信 メディアメッセージを WhatsApp 番号に送信します。
    テキストメッセージを送信 テキストメッセージを WhatsApp 番号に送信します。
    テンプレートを使用してテキストメッセージを送信 テンプレートを使用してテキストメッセージを WhatsApp 番号に送信します。

    スポークモジュール

    双方向 Webhook をセットアップして、必須イベントに関する通知を受けることができます。ルーティングポリシーでは、 ServiceNow インスタンスに通知するために満たすべき条件が定義されます。これらの条件は、通知を希望するVonageのイベントに基づいています。条件が満たされると、ルーティングポリシーが関連するサブフローをトリガーし、Vonage タスクを自動化します。デフォルトでは、 Vonage スポークアプリケーションが利用可能で、次のモジュールがあります。
    • Vonage Webhook レジストリ
    • Vonage Webhook ルーティングポリシー
    Vonage Webhook レジストリモジュールを使用してトークンを割り当て、API パスを指定します。コールバック URL を生成し、この URL を Vonage アカウントに入力する必要があります。デフォルトのルーティングポリシーは、Vonage WebHook ルーティングポリシーモジュールで参照として提供されます。これらのルーティングポリシーを要件に応じてカスタマイズします。ルーティングポリシーは、次のフィールドをサポートしています。
    • キーワード
    • コール方向
    • コールのステータス
    • イベントタイプ
    • 送信元
    • SMS ステータス
    • SMS テキスト
    • 宛先
    • WhatsApp メッセージステータス
    • WhatsApp 1 行テキスト
    • 関連フィールドを表示

    接続および資格情報エイリアスの要件

    統合ハブ は、エイリアスを使用して、接続および資格情報を管理します。エイリアスを使用することで、複数の環境を使用する場合に、複数の資格情報と接続情報プロファイルを構成する必要がなくなります。接続または資格情報が変更された場合、接続を使用するどのアクションも更新する必要はありません。詳細については、「Connections and Credentials」を参照してください。

    Vonage スポークで使用できる 2 つの接続と資格情報エイリアス：
    Vonage エイリアス 説明
    VonagePrimary SMS、番号、およびアカウントを管理するアクションに必須です。
    Vonage コールおよび WhatsApp を管理するアクションに必須です。

    スポークの設定については、「 Vonage スポークの設定。