連携管理 (Chatwork / LINE / tl;dv)
連携状態サマリー (Chatwork ルーム)
📖 セットアップガイド (クリックで展開)
全体の流れ (推奨: APIポーリングのみ・件数制限なし):
- Chatwork で APIトークン を発行 → 下記「APIトークン設定」に登録
- Chatwork にログイン → 右上アバター → 「サービス連携」
- 左メニュー「API」 → 「APIトークン」 をクリック (※「OAuth」ではないので注意)
- APIトークン直リンク → (Chatworkログイン後にこのリンクで直接ジャンプ可)
- 表示されたトークン文字列をコピー → 下記「APIトークン」入力欄に貼り付けて「保存」
- ⚠ 「OAuth」「OAuthクライアントの新規作成」「Webhook」のページではAPIトークンは取得できません
- 下記「Step 1 → ①Chatworkから取得して一括登録」をクリック
- 「Chatworkからルーム一覧を取得」 → 参加中の全ルームが表示される
- 監視したいルームをチェック → 「選択したルームを一括登録」
- Webhook設定は不要。件数制限なし (Chatwork側のWebhook 5件制限は回避される)
- 「Step 2: 工務店への紐付け」で各ルームを認定工務店に紐付け (1工務店=1ルーム)
- 以降は自動で4時間ごとにバックフィル。各ルームの最新100件が継続的にDBに保存される
オプション: Webhookでリアルタイム取込 (最大5件まで)
特定の重要ルーム (最大5件) だけは Webhook 設定でリアルタイム取込にできます。Chatwork は1アカウントあたりWebhook 5件まで作成可能。
- Chatwork管理画面で「Webhook」作成
- Webhook URL:
読込中… - イベント: 「メッセージが作成されたとき」
- 発行されたWebhookトークンをコピー
- Webhook URL:
- 下記「Step 1 → ②手動入力 + Webhook設定」で ルームID + Webhookトークン を登録
ルームID の確認方法: Chatwork のルーム URL https://www.chatwork.com/#!rid391232362 → ルームIDは 391232362 (rid の後の数字)
過去メッセージの遡及: Chatwork API は最新100件まで。それ以前は「CSV取込」機能でCSVエクスポートして取込可能
AI要約: 取込されたメッセージは工務店詳細タブの「AI要約」に反映される
Chatwork APIトークン設定
1アカウントにつき1トークン。全ルームのバックフィルに使用。発行は Chatwork にログイン → 「サービス連携」 → 左メニュー「API」 → 「APIトークン」 (OAuth ではなく) から行えます。APIトークン直リンク →
1ルーム登録
Chatworkの監視対象ルームを登録します。2 つの方法:
① Chatworkから取得して一括登録 (推奨・件数制限なし) — APIポーリングのみで取込
② 手動入力 + Webhook 設定 (リアルタイム取込・最大5件 / Chatwork制限)
📥 ① Chatwork から取得して一括登録 (推奨)
APIトークンが設定済みなら、自分が参加中のChatworkルームを一覧取得して、チェックしたものをまとめて登録できます。Webhook設定は不要。4時間ごとに自動取込されます。
⚡ ② 手動入力 + Webhook (リアルタイム取込)
Chatwork Webhook を設定すると新着メッセージがリアルタイムで届きます (1アカウントあたり最大5件まで)。Webhookトークンは省略可 — その場合 APIポーリングのみで取込されます。
2🔗 紐付け待ちルーム (工務店に未紐付け=要対応)
まだ認定工務店に紐付いていないルームだけを表示します。ここで工務店に紐付けます (1工務店=1ルーム)。工務店詳細の「対応履歴」タブからも紐付けできます。
バックフィル (API ポーリングで取込)
登録済みルームの最新100件を Chatwork API で取得します。4時間ごとに自動実行 (JST 09:00 / 13:00 / 17:00 / 21:00 / 翌01:00 / 翌05:00)。Webhook設定が無いルームでもこれで全件取込されます。
📋 全ルーム一覧 (登録済み・全状態の台帳)
これまで登録した全ルームの台帳です。紐付け済み・未紐付け・候補・無視をすべて含みます。状態確認・検索・CSV取込に使います。(上の「紐付け待ち」はこのうち未紐付けだけを抜き出したものです)