Chatwork APIの設定・トークン発行ガイド

Slim Chatworkの一部機能（マイメモのメンバー一覧表示など）は、Chatworkが公式に提供するChatwork APIを利用します。これらの機能を使うには、ChatworkでAPIトークン を発行し、Slim Chatworkのポップアップに設定します。

利用の流れは ①発行（Chatwork側）→ ②設定（Slim Chatwork側） です。目的に応じて、必要な箇所からお読みください。

APIトークンの発行手順

公式ヘルプ：APIトークンを発行する（Chatworkヘルプ）

Chatwork画面右上の [利用者名] をクリックし、メニューから [サービス連携] を開きます。
サービス連携画面の [API Token] ページにアクセスします。
表示されたAPIトークンを [コピー] ボタンでコピーします。
Slim Chatworkのポップアップ設定画面右上のメニュー（︙）から 「Chatwork API設定」 を開き、トークンを貼り付けて保存します。

組織契約で発行できない場合（管理者への依頼）

組織契約のChatworkでは、APIの利用に組織管理者の承認が必要な場合があります。API Tokenページでトークンを発行できない場合や「申請が必要」と表示される場合は、組織管理者に利用申請を承認してもらう必要があります。

利用者側：API Tokenページから利用申請を送信します（画面の案内に従ってください）。
管理者側：管理者設定から申請を承認します。手順は公式ヘルプのAPIの利用申請を承認・却下する（Chatworkヘルプ）を参照してください。

依頼文テンプレート

そのままコピーして管理者に送れる依頼文です。

お疲れさまです。

業務効率化のため、Chatwork公式APIの利用を許可していただけますでしょうか。

【利用目的】
Chrome拡張機能「Slim Chatwork」のメンバー一覧表示などで、
Chatwork公式APIを利用するため（自分のアカウントでアクセスできる範囲のみ）。

【安全性について】
・Chatwork社が公式に提供しているAPIです
　https://developer.chatwork.com/
・トークンは暗号化され、ブラウザの拡張機能用ストレージ内にのみ保存されます
・Slim Chatworkの運営サーバーや第三者のサーバーへ送信されることはありません
　https://slimchatwork.com/docs/guides/chatwork-api-token/

【承認手順（管理者向け公式ヘルプ）】
https://help.chatwork.com/hc/ja/articles/115000169501

お手数ですが、ご検討よろしくお願いいたします。

ポップアップでの設定方法

発行したトークンは、Slim Chatworkのポップアップ設定画面から登録します。

ポップアップ設定画面を開き、ヘッダー右上のメニュー（︙）→ 「Chatwork API設定」 を選びます。
「通信を許可」 でChatwork API（api.chatwork.com）へのアクセスを許可します（許可するまでトークン入力欄は使えません）。
発行したトークンを入力欄に貼り付け、「接続テスト」 で正しく設定できたか確認します。問題がなければ 「保存」 します。

設定は以上です。トークンの変更・削除は、いつでも同じ設定画面から行えます。

トークンの取り扱い・セキュリティ

Slim Chatworkでは、APIトークンを安全に取り扱うため、以下の仕組みを採用しています。

暗号化保存：トークンは暗号化され、お使いのブラウザの拡張機能ストレージ（ローカル）にのみ保存されます。他のデバイスには同期されません。
運営・第三者サーバーへの送信なし：トークンがSlim Chatworkの運営サーバーや第三者のサーバーへ送信されることはありません。通信先はChatwork公式API（api.chatwork.com）のみです。
利用範囲：ご自身のアカウントで参加しているルームのメンバー一覧の取得など、Slim Chatworkの機能に必要な範囲でのみ利用します。
いつでも削除可能：設定画面からトークンをいつでも削除できます。Chatwork側でトークンを再発行すると、以前のトークンは即座に無効になります。

トークンを使う主な機能

機能名	トークンで有効になる内容
マイメモ	メンバーメモ機能の利用

トークンを設定しなくても、Slim Chatworkの多くの機能はそのまま利用できます。今後のアップデートで、APIを利用する機能を順次追加する予定です。

よくある質問

Chatwork APIトークンを設定しないとSlim Chatworkは使えませんか？

いいえ。トークンなしでも大半の機能は動作します。トークンを設定すると、上記のAPI連携機能が追加で利用できるようになります。

会社の管理者が許可してくれるか不安です

Chatwork APIはChatwork社が公式に提供している仕組みで、Zapierなどの外部サービスとの連携にも広く使われています。上の依頼文テンプレートには、管理者向けの公式手順と安全性に関する説明を記載しています。管理者へ送付のうえ、ご相談ください。

トークンが漏えいした可能性があります

ChatworkのAPI Tokenページで「再発行」すると、以前のトークンは即座にすべて無効になります。再発行後、Slim Chatworkには新しいトークンを設定し直してください。