Chatwork連携をはじめる(導入設定)¶
Automation 業務自動化パネル(画面左上の表示「Automation」)の機能です
最終更新日: 2026-11-04 対象読者: 管理者
💡 一言でいうと: Chatwork連携は、「Dr.MiRAI専用のChatworkアカウントを1つ用意する」「グループチャットの名前に院と施設の番号を書く」 の2つがそろえば動き始めます。この2つを「ミニマム設定」と呼びます。スタッフ本人の名義で投稿し直す機能まで使うときは、さらにメンバーごとのAPIトークンが必要です。
概要¶
Chatwork連携を有効にすると、Dr.MiRAIが5分おきにクリニックのグループチャットを読みに行き、次のことを自動で行います。
| 機能 | 内容 | ミニマム設定で動くか |
|---|---|---|
| メモ転記 | 患者について書かれた投稿を、患者を特定して電子カルテ(モバカル)のメモへ転記します | 動きます |
| 元の投稿へのURL追記 | 転記できたら、元の投稿の末尾に患者ページのURLを書き足します | 投稿者本人のAPIトークンが必要。無い人の投稿は転記だけ行われ、URLは付きません |
| タスク管理 | 「〜してください」などの依頼の投稿からChatworkタスクを自動で作り、st=done の返信で完了にします。タスクは監視用アカウントの名義で作られます |
動きます(担当者は投稿の宛先(To)の人です。全員宛て([toall])の投稿では、Chatwork設定の「[toall] の投稿でタスクを割り当てる担当者」に入れた人と、患者の主治医(チャットのメンバーに名前が一致する人が1人だけいるとき)が担当者になります) |
| 電話再診 | 医師の返信を電話再診として判定し、事務向けのタスクと電子カルテの記録を作ります | 動きます |
| 置換投稿 | 「かんごさん」などの語を宛先(To)に展開して投稿者本人の名義で投稿し直します | 本人のAPIトークンが必要。未登録の人の投稿はそのまま残ります |
| Chatworkタスク作成(手動) | Web版の画面から患者と担当医師を選んでタスクを投稿します | 送信者の登録が必要(送信者本人のAPIトークン登録。サポート窓口で送信用のアカウントを指定した院はそのアカウントが送信者になります)。担当医師は、タスク作成先チャットのメンバーから選べます |
機能の初期設定(法人単位の有効化、監視用アカウントの登録、タスクの投稿先ルームの指定)はサポート窓口が行います。法人側で有効になったあとは、クリニックごとの ON / OFF とメンバーのトークン登録を、業務自動化の「設定 → Chatwork設定」画面から自分で行えます(下の「クリニック側で変えられること」を参照)。
準備の全体像¶
| 誰が | やること | このページの節 |
|---|---|---|
| クリニック | Dr.MiRAI専用(監視用)のChatworkアカウントを作り、APIトークンを発行する | ステップ1 |
| クリニック | 監視したいグループチャットにそのアカウントを入れ、チャット名に番号を付ける | ステップ2 |
| クリニック | 必要な情報をサポート窓口へ渡す | ステップ3 |
| サポート窓口 | Dr.MiRAI側にアカウントと機能の設定を登録する | (クリニックの作業はありません) |
| クリニック(任意) | 置換投稿・手動タスク作成を使うメンバーのAPIトークンを登録する | フル設定 |
⚠️ 注意: 初回の登録(監視用アカウントの登録、法人単位での機能の有効化、タスク投稿先ルームの指定)は、クリニック側の画面からはできません。サポート窓口へ依頼してください。
ステップ1: 監視用のChatworkアカウントを用意する¶
Dr.MiRAIがチャットを読み取るための、人が普段使わない専用アカウントを1つ作ります。社内では「observe専用アカウント」「監視用アカウント」と呼んでいます。
なぜ専用アカウントが必要か¶
- 止まらないため: 個人のアカウントを流用すると、その人の退職やパスワード変更で連携が全部止まります
- 投稿の名義を分けるため: 自動作成のタスクや通知は、このアカウントの名義で投稿されます。個人名義だと「本人が書いた」ように見えてしまいます
- 回数制限のため: ChatworkのAPIには1アカウントあたりの回数制限があります。読み取りを1アカウントに集約して、制限内に収める設計になっています
手順¶
- Chatworkで新しいアカウントを作ります。表示名は「Dr.MiRAI連携」など、ひと目でシステム用と分かる名前にしてください
- そのアカウントでログインし、右上のプロフィール画像から サービス連携 を開き、API Token を発行(表示)します
- ChatworkアカウントID(プロフィールに表示される数字)と APIトークン を控えます
⚠️ 注意: APIトークンはパスワードと同じ扱いです。チャットやメールの本文に貼らず、サポート窓口が案内する方法で渡してください。1院につき監視用アカウントは 1つだけ 登録できます。
💡 ヒント: 法人で複数の院を運用している場合は、法人で1つの監視用アカウントにまとめることもできます。どちらにするかはサポート窓口にご相談ください。
ステップ2: グループチャットに番号を付けて、監視用アカウントを入れる¶
Dr.MiRAIは、グループチャットの名前に書かれた番号を見て「どの院・どの施設のチャットか」を判断します。番号が無いチャットは読みに行きません。
書き方¶
チャット名のどこかに、半角の角カッコで次のように書きます。
| 対象のチャット | 書き方 | 例 |
|---|---|---|
| 施設(老人ホームなど)ごとのチャット | [クリニックID:施設番号] |
さくらホーム [12345:678] |
| 既定の院にある施設のチャット | [施設番号] |
さくらホーム [678] |
外来・院内連絡など、施設に紐づかないチャットを転記の対象にしたいときは、ルーム名を決める前にサポート(FutureSync)へご相談ください。院ごとに設定方法をご案内します。
- クリニックID: モバカルのクリニックID(Dr.MiRAIのモバカル連携に登録している番号)です。分からないときはサポート窓口に確認してください
- 施設番号: モバカルに登録している施設(老人ホーム等)の番号です。施設番号を書くと、その施設の入居者の中から患者を探すので、同姓同名の取り違えが減ります
⚠️ 注意: 書式は厳密です。次のものは認識されません。
- 全角のカッコ・全角のコロン(
[12345:678]) - カッコの中のスペース(
[12345 : 678]) - 数字以外の文字(
[A123:678])
ルール¶
- 1つのチャットは1つの院にだけ紐づきます。複数の院や施設を1つのチャットにまとめることはできません
- 対象はグループチャットだけです。ダイレクトチャットとマイチャットは読みません
[クリニックID:施設番号]の形があれば、その形を優先します。無い場合に[施設番号]の形を使います。同じ形が複数あるときは先に書かれたものが使われるため、番号の指定は1つだけにしてください[施設番号]の形は、法人内で「既定の院」として設定された院に割り当てられます。カッコの中の数字はクリニックIDではなく施設番号で、患者名から患者を探すときの施設照会に使われます。複数院で使う場合や既定の院が分からない場合は、サポート窓口に確認してください[99999]は タスク専用チャット のための予約番号です。この番号を付けたチャットでは、st=doneの拾い上げは続きますが、患者の特定とメモ転記は行いません。ふつうのチャットにこの番号を付けないでください
監視用アカウントをメンバーに入れる¶
番号を付けたすべてのグループチャットに、ステップ1で作った監視用アカウントをメンバーとして追加してください。入っていないチャットは、番号があっても読めません。
💡 ヒント: 番号を付けたチャットは、その場ですべて読まれるわけではありません。古い投稿は一定期間(およそ1週間)より前のものを飛ばして、それ以降の投稿から処理します。
ステップ3: サポート窓口へ渡す情報¶
次の情報をそろえてサポート窓口へ依頼してください。
| 項目 | 内容 |
|---|---|
| クリニック名(法人名) | 対象の院。法人でまとめる場合はその旨 |
| 監視用アカウント | ChatworkアカウントIDとAPIトークン(トークンは案内された方法で) |
| 使いたい機能 | メモ転記 / タスク管理 / 電話再診 / 置換投稿 のうち有効にするもの |
| タスクの投稿先ルームID | タスク管理を使う場合。自動作成したタスクを投稿するグループチャットの番号(URL末尾の数字) |
| 手動タスクの投稿先ルームID | Web版の「Chatworkタスク作成」から投稿するチャットを、自動タスクの投稿先と分けたい場合。指定しなければタスクの投稿先と同じチャットに投稿します。院ごとに分けることもできます |
| 通知先ルームID | 通知を受け取るチャットがあれば |
| 監視対象を絞りたい場合 | 「このチャットだけ」など絞り込みの希望があれば |
登録が終わると、サポート窓口から連絡があります。以降は5分おきに読み取りが始まります。
クリニック側で変えられること(Chatwork設定画面)¶
サポート窓口の登録が終わったあとは、業務自動化(Automation)の左メニュー 「設定 → Chatwork設定」 で、次を自分で変更できます。業務自動化の利用権限がある人なら開けます。
| タブ | できること |
|---|---|
| メモ転記 / 置換投稿 / タスク管理 / 電話再診 | 機能ごとの ON / OFF を、クリニック単位で切り替える |
| メンバー | メンバーの名前・ChatworkアカウントID・APIトークンを登録し、有効/無効を切り替える |
| 置換辞書 | 置換する語と置換後の文言を編集する(Chatworkと連携する) |
⚠️ 注意: 法人側が OFF の機能は、クリニックのスイッチを操作できません(グレーアウトします)。法人 ON → 全クリニック ON(個別に OFF 可)、法人 OFF → 全クリニック OFF という関係です。法人側の設定と、タスクの投稿先ルームID・手動タスクの投稿先ルームID(空欄ならタスクの投稿先と同じ)などの法人共通の項目は、法人スコープの管理者が「法人横断」で開いたときだけ編集できます。それ以外の方はサポート窓口へ依頼してください。
フル設定: メンバーごとのAPIトークンを登録する¶
次の機能は、投稿する本人のChatworkアカウントが Dr.MiRAI に登録されているときだけ動きます。
| 機能 | 本人の登録が無いとどうなるか |
|---|---|
| 元の投稿へのURL追記 | メモは転記されますが、投稿に患者ページのURLは付きません |
| 置換投稿(かんごさん → To展開) | 置換されず、元の投稿がそのまま残ります |
| Chatworkタスク作成(手動)の「送信者(あなたは?)」 | 選択肢に出ません |
登録には2段階あります。
| 段階 | 内容 | できること |
|---|---|---|
| アカウントIDの紐づけ | Dr.MiRAIのメンバーとChatworkアカウントを対応づける | メンションの展開先になる。手動タスク作成で、タスク作成先チャットにいる医師が医師として出ないときの補正になる |
| APIトークンの登録 | そのメンバー本人のAPIトークンを預ける | 本人の投稿へのURL追記、本人名義での置換投稿、手動タスクの送信者になる |
方法A: メンバー画面の「外部ID紐づけ(名寄せ)」(アカウントIDのみ)¶
- Web版の左メニュー「設定」→ クリニック設定 → 「メンバー」を開きます
- 右上のメニューから 外部ID紐づけ(名寄せ) を選びます
- 監視用アカウントが入っているチャットのメンバー一覧をもとに、名前が一致する候補が自動で並びます。確認して適用してください
この方法で紐づくのはアカウントIDだけです。APIトークンは入らないため、本人名義の投稿はまだできません。詳しくは メンバー設定 を見てください。
方法B: クリニック端末アプリの「Chatworkメンバー管理」(トークンまで登録)¶
はあと構成のクリニックでは、クリニック端末アプリの設定画面に Chatworkメンバー管理 があります。名前とAPIトークンを1人ずつ登録し、「BE同期」で Dr.MiRAI へ送ります。画面に無いときは、その契約・ビルドでは対象外です。端末の設定 を見てください。
方法C: 業務自動化の「Chatwork設定 → メンバー」タブ(トークンまで登録)¶
業務自動化を使えるクリニックでは、左メニュー 「設定 → Chatwork設定」 の メンバー タブから、メンバーを追加 で名前・ChatworkアカウントID・APIトークンを 1 人ずつ登録できます。登録済みの人は トークン更新 でトークンを差し替えられ、無効化 / 有効化 で一時的に止められます。まだ誰も登録されていないときは「Chatworkメンバーが登録されていません」と出ます。
方法D: サポート窓口へ一覧を渡す¶
メンバーごとに次を集めて、サポート窓口へ渡してください。
| 項目 | 取得方法 |
|---|---|
| 氏名(Dr.MiRAIの登録名) | メンバー設定の表示名 |
| ChatworkアカウントID | 本人のプロフィールに表示される数字 |
| APIトークン | 本人がChatworkの「サービス連携」→「API Token」で発行 |
💡 ヒント: 登録時に「このトークンは本当にそのアカウントのものか」を Dr.MiRAI が Chatwork に問い合わせて確認します。他人のトークンを誤って登録すると、その時点でエラーになります。
⚠️ 注意: 監視用アカウントのIDを、メンバーの個人アカウントとして登録することはできません。「このアカウントIDは監視用アカウントとして登録済みです」と表示されます。
動作を確認する¶
- 番号を付けたグループチャットに、テストとして患者の連絡を1件投稿します(例:
[ID:00001] 本日発熱あり、様子観察)。[ID:患者番号]を先頭に付けると患者の特定が確実です - 読み取りは5分おきですが、処理の待機やAPI回数制限により、転記まで5分を超えることがあります。少し待ってから確認してください
- モバカルでその患者のメモを開き、投稿した内容が入っていれば成功です
- 投稿した本人のAPIトークンを登録済みなら、元の投稿の末尾に患者ページのURLが書き足されます。ミニマム設定ではURLは付きません
うまくいかないときは、実行履歴を確認する と下の表を見てください。
うまく動かないとき¶
| 症状 | 確認すること |
|---|---|
| どのチャットも読まれない | サポート窓口での有効化が済んでいるか。監視用アカウントのAPIトークンが有効か(Chatwork側で再発行すると古いトークンは使えなくなります) |
| 特定のチャットだけ読まれない | チャット名の番号が半角で正しいか。監視用アカウントがそのチャットのメンバーに入っているか。グループチャットか |
| 別の院のメモに転記された | [クリニックID:施設番号] ならクリニックIDを、[施設番号] なら既定の院の設定を確認してください |
| 患者が特定されず転記されない | 投稿に患者名または [ID:患者番号] があるか。同姓同名がいる施設では施設番号を付ける |
| 転記はされるが投稿にURLが付かない | 投稿した本人のAPIトークンが登録されているか(ミニマム設定では付きません) |
| 置換投稿されない(かんごさんが展開されない) | 投稿した本人のAPIトークンが登録されているか。置換辞書に「かんごさん」「じむさん」が有効な特殊キーワードとして入っているか |
| 手動タスク作成で送信者が出ない | 送信者本人のAPIトークン登録(フル設定)が済んでいるか。送信用のアカウントを指定した院では、そのアカウントのトークンが有効か |
| 手動タスク作成で担当医師が出ない | タスク作成先のチャットに医師がメンバーとして入っているか。入っているのに医師として出ないときは、メンバー画面の外部ID紐づけで医師とChatworkアカウントを紐づけてください。急ぐときは「医師以外のメンバーも表示」から選べます |
| しばらく読み取りが止まる | ChatworkのAPI回数制限にかかると、数分〜10分ほど待機して再試行します。処理待ちや再度の回数制限で、さらに時間がかかることがあります。対象を絞る相談もできます |
よくある質問¶
Q: 監視用アカウントは有料プランが必要ですか?¶
A: Chatworkの契約に関する条件はChatwork側の規約によります。組織で管理しているアカウントなら、管理者が発行できる範囲でご用意ください。
Q: 監視用アカウントの代わりに院長のアカウントを使ってもよいですか?¶
A: おすすめしません。URL返信などが院長名義になり、院長のパスワード変更やトークン再発行のたびに連携が止まります。
Q: 番号を付ける前の古い投稿も転記されますか?¶
A: されません。読み取りを始めた時点からおよそ1週間より前の投稿は飛ばします。
Q: 全員分のAPIトークンを集めるのが大変です。¶
A: ミニマム設定だけで、メモ転記・自動タスク・電話再診は動きます。投稿へのURL追記・置換投稿・手動タスク作成を使う人から順に、少しずつ登録して構いません。
関連ページ¶
- Chatworkと連携する(タスク作成と置換辞書の使い方)
- 業務自動化でできること
- メンバー設定
- 連携(法人)
- 端末の設定
- 実行履歴を確認する