Vonage スポーク

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

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

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

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

スポークバージョン

Vonage スポークv 2.0.0 が最新バージョンです。

サポート対象のバージョン

このスポークは、次の Vonage バージョン用にビルドされていますが、それ以降のバージョンと互換性がある可能性があります。

Message API バージョン v1
Voice API バージョン v1

スポークの要件

Vonage アカウントと Vonage API ダッシュボードへのアドミンアクセス。
API キーと API シークレットの値を記録します。これらの値には、Vonage API ダッシュボードからアクセスできます。詳細については、 Vonage API Developer ドキュメントサイトの「認証」ページを参照してください。
署名シークレットの値を記録して保存します。この値には、Vonage API ダッシュボードの [アカウント設定 (Account Settings)] からアクセスできます。詳細については、 Vonage API Developer ドキュメントサイトの「認証」ページを参照してください。

スポークの依存関係

アプリのインストールで問題が発生した場合は、次の依存プラグインがインストールされていることを確認してください。

ServiceNowIntegrationHub アクションステップ - REST (com.glide.hub.action_step.rest)
ServiceNow 統合ハブランタイム (com.glide.hub.integration.runtime)
Complex Object (com.glide.cobject)
ServiceNow フローデザイナー - 動的入力 (com.glide.hub.dynamic_inputs)

注:

これらのプラグインの一部はライセンス可能な機能であり、スポーク実装の外部で使用する場合は適切なライセンスが必要です。

スポークのサブフロー

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


サブフロー	説明
Vonage SMS Webhook	Vonage からの SMS 要求を処理します。
Vonage 音声 Webhook	Vonage からの音声要求を処理します。
Vonage WhatsApp Webhook	Vonage からの WhatsApp 要求を処理します。

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

スポークのトリガー

Vonage スポークのトリガーを使用して、必要なイベントに登録します。エンドポイントにより、Webhook が ServiceNow インスタンスに接続できるようになります。指定したトリガー条件が満たされた場合にのみ実行されるようにフローを設定できます。サポートされているイベントは次のとおりです。


カテゴリ	トリガー	説明
コール管理	音声呼び出し	Vonage からコールが発信され、番号が鳴っていると、トリガーが開始されます。
	音声回答	Vonage からコールが発信され、コールに応答すると、トリガーが開始されます。
	音声完了	Vonage からコールが発信され、コールが完了すると、トリガーが開始されます。
SMS 管理	SMS 配信済み	Vonage から番号に SMS が送信されると、トリガーが開始されます。
	SMS 失敗	Vonage から SMS が送信され失敗すると、トリガーが開始されます。
	SMS 承認済み	トリガーは、メッセージの配信が受け入れられたが、まだ配信されていない場合に開始されます。

Vonage スポークのトリガーの設定については、「Vonage スポークのトリガーの設定」を参照してください。

スポークのアクション

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


カテゴリ	アクション	説明
アカウント管理	アカウント残高を取得	Vonage アカウントの現在の残高を取得します。
コール管理	DTMF トーンをコールに再生	DTMF (デュアルトーンマルチ周波数) トーンをアクティブなコールに再生します。
	記録を ServiceNow レコードに添付	通話記録をターゲット ServiceNow レコードに添付します。
	発信コールを作成	電話番号への発信コールを作成します。
	NCCO を生成	発信コールの作成アクションで使用される Nexmo Call Control Object (NCCO) をビルドします。
	コネクト NCCO を生成	発信コールを電話番号や WebSocket などのエンドポイントに接続する方法を定義する Nexmo Call Control Object (NCCO) を生成します。
	NCCO 通知を生成	発信コールの通知アクションを定義する Nexmo Call Control Object (NCCO) を生成します。
	転送 NCCO を生成	アクティブなコールの転送方法を定義する Nexmo Call Control Object (NCCO) を生成します。
	コールの詳細を検索	指定されたコールの詳細を取得します。
	コールを検索	指定されたコールの詳細を取得します。
	オーディオをコールに再生	アクティブなコールにオーディオファイルを再生します。
	テキスト読み上げをコールに再生	アクティブなコールにテキスト読み上げを再生します。
	コールへのオーディオ再生を停止	アクティブなコールへのオーディオファイルの再生を停止します。
	コールへのテキスト読み上げを停止	アクティブなコールへのテキスト読み上げを停止します。
	コールを更新	アクティブなコールのステータスを更新します。
番号管理	番号を検索	Vonage アカウントに関連付けられているすべての受信番号を取得します。
RCS 管理注: 以前のバージョンのスポークからアップグレードする場合は、このカテゴリアクションを使用する前に、既存の認証情報レコードに新しい JWT トークンを生成してください。	RCS カードメッセージを送信	指定された電話番号に RCS (リッチコミュニケーションサービス) カードメッセージを送信します。
	RCS メディアメッセージを送信	指定された電話番号に RCS (リッチコミュニケーションサービス) メディアメッセージを送信します。
	RCS テキストメッセージを送信	指定された電話番号に RCS (リッチコミュニケーションサービス) テキストメッセージを送信します。
SMS 管理	SMS 送信	SMS (ショートメッセージサービス) を電話番号に送信します。
WhatsApp 管理注: 以前のバージョンのスポークからアップグレードする場合は、このカテゴリアクションを使用する前に、既存の認証情報レコードに新しい JWT トークンを生成してください。	連絡先を送信	連絡先を 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 スポークの設定。