自身へのメンションがあったら(トリガー)

このピースでできること

  • Chatworkで自分宛てのメンションが含まれるメッセージが送信されたときに、ワークフローを開始します。
 

Chatwork の接続方法

workrun と Chatwork を接続するには、Chatwork の OAuth クライアント(クライアントID ・ クライアントシークレット) が必要です。

ステップ 1:workrun のリダイレクト URL を確認する

  1. workrun で Chatwork のアクション/トリガーをフローに追加します。
  1. 「接続を選択」の横にある 「+ 新しい接続」 をクリックします。
  1. 接続画面に表示される 「リダイレクト URL」 をコピーしておきます。

ステップ 2:Chatwork で OAuth クライアントを作成する

  1. OAuthクライアント作成画面 にアクセスします。
  1. 以下のように入力します:
      • クライアントタイプ: を選択
      • リダイレクト URI: ステップ 1 でコピーした URL を貼り付け
      • スコープ: 以下をすべてチェック
  1. 登録後、表示された クライアントID と クライアントシークレット をコピーします。

ステップ 3:workrun に接続を追加する

  1. ステップ 1 の接続画面に戻り、クライアントID と クライアントシークレット をそれぞれ貼り付けます。
  1. 「接続」 をクリックすると、Chatwork の認証画面が開きます。
  1. Chatwork にログインし、workrun に対するアクセスを 「許可」 します。
  1. 画面が自動で閉じ、接続が完了します。
 

ピースの設定項目

1. Webhook URL(表示のみ)

  • 生成されたWebhook URLが表示されます。
  • Chatworkの管理画面でWebhookを作成し、このURLを手動で登録してください。
[設定例]

2. Webhookの設定方法(表示のみ)

  • Chatwork管理画面での設定手順が表示されます。
  • 表示された手順に沿って、イベントを「アカウントイベント」に設定してください。
[設定例]
Chatwork管理画面でWebhookを新規作成し、イベントを「アカウントイベント」にして保存

取得できる情報

Chatworkから受信した自身へのメンションイベントの情報を、後続ステップで利用できます。主な項目は次のとおりです。
実際のキー内容・条件
イベント種別・イベント発生時刻
メッセージID・ルームID
メンションの送信元・宛先のアカウントID
メンションを含むメッセージ本文
送信時刻・更新時刻
  • 利用例:メンション本文と送信元のアカウントIDを使い、通知や対応振り分けに利用できます。
  • 取得項目や値は、接続先のデータ・権限・イベント内容によって異なります。実際に利用する項目は「テストトリガー」で確認してください。

出力例(抜粋)