外部アプリケーションでイベントが発生した際にアクションをトリガーするために、Listener を設定します。 この例では、ユーザーが Zendesk プラットフォームでチケットを作成した際に、Microsoft 365 Outlookメールボックスへメールを送信するListenerトリガーを持つTask Botを作成する方法を示します。

トリガーは Zendesk プラットフォーム内のすべてのイベントをリッスンします。 ユーザーがプラットフォームでチケットを作成すると、トリガーがその後の自動化ワークフローを開始し、チケットの詳細を含むメールを設定された Microsoft 365 Outlook メールボックスに送信します。

前提条件

以下の前提条件を満たしていることを確認してください:
  • オートメーション用のリスナー URL です。 リスナー URL の作成方法の詳細については、Listener のウェブトリガー用リスナー URL を作成しています を参照してください。
  • Zendesk プラットフォームのチケットを作成、更新、削除するための管理者権限。
  • Listener トリガーに記載されているリスナーのトリガー要件。
  • TriggerData という名前のレコード変数です。
  • Microsoft 365 Outlook 用のアクティブな OAuth 接続。
  • Microsoft 365 Outlook のユーザー名を含む資格情報変数です。

手順

  1. Zendesk プラットフォームで Webhook を作成するには、次の手順を実行します。
    1. Zendesk ポータルにログイン
    2. 管理センター > アプリと統合 > Webhooksに移動し、次にWebhooksを作成をクリックします。
    3. 該当するフィールドに以下を入力してください。
      1. 接続方法を選択： Zendesk イベント を選択し、イベントタイプのドロップダウンリストから すべてのチケットイベント を選択します。
      2. 名前: Webhook の適切な名前を入力してください。
      3. エンドポイント URL： Control Roomで作成したリスナー URL を追加してください。
      4. 認証: API キー を選択します。
      5. ヘッダー名： ticket-headerを入力してください。
      6. 値: ヘッダーに適切な値を入力してください。
      Webhook の作成方法の詳細については、Creating webhooks in Zendeskを参照してください。
  2. Control Room で Task Bot を作成するには、以下の手順を実行してください。
    1. 左側のペインで オートメーション をクリックします。
    2. 作成 > タスク Bot をクリックします。
      タスク Bot を作成ウィザードが表示されます。
    3. 名前 フィールドにBotの適切な名前を入力します。
      システムは、デフォルトで、すべての Bot を <\Bots> フォルダーに保存します。
    4. オプション: 説明 フィールドに Bot の説明を追加してください。
    5. オプション: 選択をクリックし、Bot を別のフォルダーに保存するための指示に従ってください。
    6. 作成と編集 をクリックします。
      Bot が作成され、タスク Bot の編集が表示されます。
  3. Listenerウェブトリガーを追加および設定するには、以下の手順を実行します。
    1. トリガー > ユニバーサルウェブトリガーをクリックし、その後リスナーをダブルクリックまたはドラッグしてトリガーセクションにウェブトリガーを追加します。
    2. リスナー ドロップダウンリストから生成されたリスナー URL を選択します。
      システムは生成された URL をURLフィールドに自動入力します。
    3. 追加を認証ヘッダーでクリックして、ヘッダーモーダルを開きます。
    4. 名称に認証ヘッダー名を入力してください。
    5. 不確実な文字列 を選択し、値 にヘッダーの値を入力します。
      あるいは、Credential Vault に値を資格情報として保存し、認証情報 オプションを使用してその値を選択することができます。
    6. 追加をクリックして認証ヘッダーを追加します。
    7. 署名方式ドロップダウンから検証なしを選択します。
    8. レスポンス ドロップダウンから TriggerData を選択します。
      TriggerData 変数は、Zendesk からの受信レスポンスペイロードを保存します。 チケットイベントの応答ペイロードに関する詳細は、Zendesk ticket events payloads を参照してください。
  4. Microsoft 365 Outlook 接続 アクションを追加して設定するには、次の手順に従います。
    1. アクション > Microsoft 365 Outlookをクリックし、その後接続をダブルクリックまたはドラッグしてアクションをアクションセクションに追加します。
    2. Azure GlobalをAzure Cloudで選択してください。
      お使いのMicrosoft 365 OutlookがMicrosoft 365政府版に含まれている場合は、Azure US GCC Highを選択してください。
    3. OAuth2 認証モード で Control Room 管理 を選択します。
    4. ピック をクリックし、OAuth 接続を選択 モーダルの指示に従って、Microsoft 365 Outlook 用の OAuth 接続を選択してください。
    5. クリック 変数 > 値を挿入 を選択し、プロンプトに従って Microsoft 365 Outlook ユーザー名の認証情報を選択してください。
    6. オプション: 適切なセッション名を Microsoft 365 Outlook セッションの作成 に入力します。
      システムはデフォルトでMicrosoft365OutlookSessionをセッション名として設定します。
  5. Microsoft 365 Outlook の 送信 アクションを追加して設定するには、次の手順を実行します。
    1. アクション > Microsoft 365 Outlookをクリックし、その後送信をダブルクリックまたはドラッグしてアクションをアクションセクションに追加します。
    2. 接続アクションの設定時に入力したセッション名を入力してください。
      デフォルト名をそのまま使用すると、システムは Microsoft365OutlookSession を Microsoft 365 Outlook session として自動入力します。
    3. Microsoft 365 Outlook のメール ID を入力して、ファイルの詳細を To に転送する必要があります。
    4. 件名に$TriggerData{"detail.subject"}$を入力してください。
      detail.subject キーには、Zendesk チケットの件名がその値として含まれています。
    5. メール本文タイプでHTML コードを選択し、$TriggerData{"detail.description"}$を入力してください。
      detail.descriptionキーには、Zendesk チケットの説明がその値として含まれています。
  6. 保存 をクリックして、設定を保存します。
実行 > トリガー付きで実行をクリックすると、システムがトリガーを有効化し、トリガーは Zendesk プラットフォーム上のチケッティングイベントの監視を開始します。 ユーザーがチケットを作成すると、トリガーがその後のMicrosoft 365 Outlookアクションを実行します。 Microsoft 365 Outlook のメールボックスは、チケットの件名をメールの件名として、チケットの説明をメールの本文として受信します。