Jinba FlowでChatworkのメッセージとタスクを操作する

フローからChatworkルームを操作する場合は、Chatworkツールを使います。5つのツールすべてで、token設定にChatwork APIトークン、入力にroom_idが必要です。実行前にトークンを設定してください。

操作に合うChatworkツールを選ぶ

操作	ツールID	必須入力	結果
メッセージを送る	`CHATWORK_SEND_MESSAGE`	`room_id`, `message`	`result.message_id`
メッセージを取得する	`CHATWORK_GET_MESSAGES`	`room_id`	`result`: メッセージの配列
タスクを作る	`CHATWORK_CREATE_TASK`	`room_id`, `body`, `to_ids`	`result.task_ids`: タスクIDの配列
タスクを取得する	`CHATWORK_GET_TASKS`	`room_id`	`result`: タスクの配列
タスクの状態を変える	`CHATWORK_UPDATE_TASK_STATUS`	`room_id`, `task_id`, `status`	`result.task_id`

CHATWORK_GET_MESSAGESの任意の真偽値forceをtrueにすると最新100件まで取得し、既定のfalseでは新しいメッセージのみ取得します。CHATWORK_GET_TASKSではaccount_id、assigned_by_account_id、status（openまたはdone）で絞り込めます。CHATWORK_CREATE_TASKでは任意のlimit（UnixタイムスタンプまたはYYYY/MM/DD形式の日付）とlimit_type（none、date、time）を指定できます。

Chatworkにメッセージを送る

- id: send_message
  tool: CHATWORK_SEND_MESSAGE
  config:
    - name: token
      value: "{{secrets.CHATWORK_API_TOKEN.api_token}}"
  input:
    - name: room_id
      value: "123456"
    - name: message
      value: "レポートが完成しました。"

成功すると送信したメッセージのIDがresult.message_idに返ります。失敗した場合は、トークンの有効性、ルームへのアクセス権、room_idを確認します。入力名はbodyではなくmessage、設定名はapi_tokenではなくtokenです。

Chatworkに動的なレポートを送信する

メッセージには前のステップの結果を含められます。次の例は、以前のガイドにあった週次レポートの用途を残したものです。フロー内の実際のステップIDと出力フィールドに置き換えてください。

- id: send_weekly_report
  tool: CHATWORK_SEND_MESSAGE
  needs: [sales_data, metrics, action_items]
  config:
    - name: token
      value: "{{secrets.CHATWORK_API_TOKEN.api_token}}"
  input:
    - name: room_id
      value: "123456"
    - name: message
      value: |
        週次レポート
        売上概要: {{ steps.sales_data.result.summary }}
        主な指標: {{ steps.metrics.result.kpi }}
        対応事項: {{ steps.action_items.result.summary }}

Chatworkのタスクを作成して完了する

- id: create_task
  tool: CHATWORK_CREATE_TASK
  config:
    - name: token
      value: "{{secrets.CHATWORK_API_TOKEN.api_token}}"
  input:
    - name: room_id
      value: "123456"
    - name: body
      value: "レポートを確認する"
    - name: to_ids
      value: "6454321"

複数人に割り当てる場合は、to_idsにアカウントIDをカンマ区切りの文字列で指定します(例: "6454321,7654321")。後続ステップでタスクを完了するには、create_taskから返されたIDを使います。

- id: complete_task
  tool: CHATWORK_UPDATE_TASK_STATUS
  needs: [create_task]
  config:
    - name: token
      value: "{{secrets.CHATWORK_API_TOKEN.api_token}}"
  input:
    - name: room_id
      value: "123456"
    - name: task_id
      value: "{{steps.create_task.result.task_ids[0]}}"
    - name: status
      value: done

これは旧Advancedページのタスク管理ワークフローを、現在のフィールド名で示した例です。変更したタスクはresult.task_idで確認できます。

未完了タスクを確認する

CHATWORK_GET_TASKSでルーム内の未完了タスクを取得し、後続ステップで状況をまとめられます。担当者を絞る場合はaccount_idを指定します。

- id: list_open_tasks
  tool: CHATWORK_GET_TASKS
  config:
    - name: token
      value: "{{secrets.CHATWORK_API_TOKEN.api_token}}"
  input:
    - name: room_id
      value: "123456"
    - name: status
      value: open

結果はタスクレコードの配列です。各タスクには本文、状態、期限が設定されている場合はUnixタイムスタンプのlimit_timeが含まれます。この一覧からリマインダーやレポートを作成できます。空の配列は該当するタスクがないことを示します。期限を監視するには、Pythonステップで設定済みのlimit_timeと現在時刻を比較し、未完了タスクを期限超過または期限間近に分類します。limit_timeはUnixタイムスタンプなので、人に表示する前に日付へ変換します。

最近のメッセージを確認する

CHATWORK_GET_MESSAGESは前回の取得以降の新着メッセージを取得します。forceをtrueにすると最新100件まで取得します。結果はメッセージの配列で、各メッセージにbody、送信者のaccount、送信・更新時刻が含まれます。後続ステップに渡して、話題、質問、対応事項を整理できます。

- id: get_recent_messages
  tool: CHATWORK_GET_MESSAGES
  config:
    - name: token
      value: "{{secrets.CHATWORK_API_TOKEN.api_token}}"
  input:
    - name: room_id
      value: "123456"
    - name: force
      value: true

結果はsteps.get_recent_messages.resultのメッセージ配列です。これを分析し、同じルームに動的なレポートを投稿できます。次の例ではOPENAI_INVOKEで最新メッセージを要約します。実行前にOpenAIの認証情報またはJinbaクレジットを設定してください。

- id: summarize_messages
  tool: OPENAI_INVOKE
  needs: [get_recent_messages]
  input:
    - name: prompt
      value: |
        最近のChatworkメッセージを要約してください。主な話題、未回答の質問、対応事項を列挙し、内容を推測しないでください。
        {% for message in steps.get_recent_messages.result %}
        - {{ message.account.name }}: {{ message.body }}
        {% endfor %}

- id: send_message_report
  tool: CHATWORK_SEND_MESSAGE
  needs: [summarize_messages]
  config:
    - name: token
      value: "{{secrets.CHATWORK_API_TOKEN.api_token}}"
  input:
    - name: room_id
      value: "123456"
    - name: message
      value: |
        最近のメッセージレポート
        {{ steps.summarize_messages.result.content }}

​操作に合うChatworkツールを選ぶ

​Chatworkにメッセージを送る

​Chatworkに動的なレポートを送信する

​Chatworkのタスクを作成して完了する

​未完了タスクを確認する

​最近のメッセージを確認する