Plivo スポーク

  • リリースバージョン: Xanadu
  • 更新日 2024年08月01日
  • 所要時間：6分

    • ServiceNowインスタンスからPlivoプラットフォームを使用して、顧客との通信を有効にします。

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

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

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

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

    スポークバージョン

    Plivo スポークは v1.0.4 が最新バージョンです。

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

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

    スポークの要件

    • Plivoコンソールへのアドミンアクセス
    • [AUTH ID] および [AUTH トークン] これらの値は、Plivoアカウントのダッシュボードで見つけることができます。詳細については、Plivo ドキュメントの「認証」を参照してください。

    スポークの依存関係

    アプリのインストールで問題が発生した場合は、次の依存プラグインがインストールされていることを確認してください。
    • ServiceNow 統合ハブランタイム (com.glide.hub.integration.runtime)
    • ServiceNow 統合ハブアクションステップ：REST (com.glide.hub.action_step.rest)
    • 複合オブジェクト (com.glide.cobject)
    • ServiceNow 統合ハブアクションテンプレート：データストリーム (com.glide.hub.action_type.datastream)
    注:
    これらのプラグインの一部はライセンス可能な機能であり、スポーク実装の外部で使用する場合は適切なライセンスが必要です。

    スポークのサブフロー

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

    サブフロー 説明
    Plivo コールハンドラー Plivoアカウントに関連付けられたコールを管理します。
    Plivo SMS ハンドラー Plivoアカウントに関連付けられた SMS を管理します。

    サブフローをカスタマイズするときは、サブフローが無限ループを回避するように構成されていることを確認する必要があります。

    注:
    • スポークサブフローを使用するように Webhook を設定する必要があります。Webhook の設定と構成の詳細については、「Plivoスポークの Webhook を設定 」を参照してください。
    • デフォルトで、サンプルサブフローはユーザーとして実行されます。サブフローは、システムとして実行するように設定できます。

    スポークのアクション

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

    カテゴリ アクション 説明
    アプリケーション管理 アプリケーションの作成 アプリケーションを作成します。
    アプリケーションを削除 アプリケーションを削除します。
    アプリケーションを取得 アプリケーションの詳細を取得します。
    アプリケーションを検索 すべてのアプリケーション ID のリストを取得します。
    アプリケーションを更新 アプリケーションの詳細を更新します。
    コール管理 コールを取得 コールのコール詳細レコード (CDR) を取得します。
    コールを終了 進行中のコールを終了するか、キューに入れられた発信コールをキャンセルします。
    コールを検索 指定されたコールの詳細を取得します。
    通話を行う 発信コールを開始します。
    コールの記録を開始 進行中の発信コールの記録を開始します。
    コールの記録を停止 指定されたコール UUID の進行中のすべての記録を停止します。
    会議の管理 会議を取得 会議の詳細を取得します。
    会議を終了 アカウントで進行中のすべての会議を終了します。
    メンバーを切断 会議のメンバーを切断します。
    メンバーを除外 会議のメンバーを切断します。
    会議を検索 アカウントで進行中のすべての会議のリストを取得します。
    メンバーをミュート 会議のメンバーをミュートします。
    メンバーのミュート状態を解除 会議のメンバーのミュート状態を解除します。
    SMS 管理 メッセージを取得 指定されたメッセージの詳細を取得します。
    メッセージを検索 メッセージの詳細を取得します。
    SMS を一括送信 複数の番号に SMS を送信します。
    SMS を送信 指定された番号に SMS を送信します。

    スポークモジュール

    Webhook は、必須イベントに関する通知を受けるように設定できます。ルーティングポリシーでは、ServiceNowインスタンスに通知するために満たすべき条件が定義されます。これらの条件は、通知を希望するPlivoのイベントに基づいています。条件が満たされると、ルーティングポリシーが関連するサブフローをトリガーし、 Plivoタスクを自動化します。

    Webhook には別途セットアップが必要で、スポークアクションを使用しないで単独で使用できます。Plivo Spoke は Plivo Spoke アプリケーションをインスタンスに追加し、これらのモジュールを含みます。
    モジュール 説明
    Plivo Webhook レジストリ ServiceNowでPlivoWebhook を作成し表示します。
    Plivo Webhook ルーティングポリシー ServiceNowでPlivoWebhook のルーティングポリシーを作成し表示します。要件に応じてルーティングポリシーの条件をカスタマイズすることもできます。

    Plivo Webhook レジストリモジュールを使用して、PlivoWebhook を登録します。コールバック URL を生成し、この URL を Plivo アカウントに入力する必要があります。

    ルーティングポリシーとサブフローは次の Plivo フィールドをサポートしています。
    • キーワード
    • コールイベント
    • 発信者名
    • イベントタイプ
    • SMS テキスト
    • 宛先番号
    • 関連フィールドを表示

    Plivo WebHook ルーティングポリシーモジュールでルーティングポリシーを作成し、要件に従って条件を指定します。Webhook の設定と構成の詳細については、「Plivoスポークの Webhook を設定 」を参照してください。

    スポークユーザーロール

    Plivo Spoke では、Plivo アドミン (sn_plivo_spoke.Plivo_Admin) ロールが提供されます。

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

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

    スポークの設定については、「 Plivo Spoke を設定。