Plivoスポークの Webhook を設定

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

    • ServiceNowコールバック URL を使用して、Plivoアカウントを登録する Webhook を構成します。

    始める前に

    • 統合ハブ サブスクリプションの要求
    • Plivo スポークの有効化
    • 必要なロール：sn_plivo_spoke.Plivo_Admin および decision_table_admin

    ServiceNowにPlivoWebhook を登録

    ServiceNowインスタンスにPlivoWebhook を登録して、Plivoで特定のイベントが発生したときにServiceNowアプリに通知します。

    始める前に

    必要なロール：sn_plivo_spoke.Plivo_Admin および decision_table_admin

    手順

    1. 移動先 すべて > Plivo スポーク > Plivo Webhook レジストリ.
    2. [新規] をクリックします。
    3. フォームのフィールドに入力します。
      表 : 1. Plivo Webhook レジストリフォーム
      フィールド 説明
      名前 レコードを一意に識別する名前です。たとえば、Plivo webhook を入力します。
      説明 レコードの説明です。
      パス PlivoWebhook パスです。デフォルトでは、このパスは api/sn_plivo_spoke/plivo_webhook_handler/wh_entry に設定されています。
    4. フォームヘッダーを右クリックし、 [保存] をクリックします。
    5. [コールバック URL] をクリックします。
      Webhook コールバック URL が表示されます。
    6. Webhook コールバック URL をコピーして記録します。

    タスクの結果

    PlivoWebhook がServiceNowインスタンスに登録されます。

    Plivo でのコールバック URL の追加

    Webhook を作成するには、 Plivo アカウントに Webhook コールバック URL を指定します。

    始める前に

    必要なロール：sn_plivo_spoke.Plivo_Admin および decision_table_admin

    手順

    1. Plivoコンソールにログインします。
    2. 要件に従って、Plivoコンソールでアプリケーションを作成します。
      Plivoコンソールでのアプリケーションの作成に関する詳細については、Plivo ドキュメントの「最初の発信を行う」ページの「アプリケーションを作成する」セクションを参照してください。PlivoAPI を使用したアプリケーションの作成と更新の詳細については、Plivo アプリケーションのドキュメントを参照することもできます。
    3. [メッセージ URL] と [回答 URL] に Webhook コールバック URL を入力し、要件に従ってアプリケーションを構成します。

    タスクの結果

    コールバック URL がPlivoアカウントに追加されます。要件に応じてルーティングポリシーとサブフローを作成できます。新しいルーティングポリシーとサブフローの作成の詳細については、「ルーティングポリシーを作成し、Webhook をカスタマイズ」を参照してください。

    ルーティングポリシーを作成し、Webhook をカスタマイズ

    要件に応じて、Webhook ルーティングポリシーとサブフローを作成します。

    始める前に

    必要なロール：sn_plivo_spoke.Plivo_Admin および decision_table_admin

    このタスクについて

    Plivo WebHook ルーティングポリシーモジュールのルーティングポリシーはサブフローをトリガーし、Plivoアカウントで特定のイベントが発生するとServiceNowインスタンスに通知します。ルーティングポリシーとサブフローがサポートするフィールドの詳細については、「Plivo スポーク」を参照してください。

    手順

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

    タスクの結果

    ルーティングポリシーとサブフローが作成されます。