Skip to main content

​
Chatwork

ShanoneのChatwork連携は、チャットルーム、メッセージ、タスク、ファイル、コンタクト、招待リンクを扱う32個のツールをエージェントに提供します。

​
はじめに

1

OAuthで接続する

エージェントにChatwork関連の作業を依頼(例: 「営業チャットルームにメッセージを送って」)するか、Shanoneダッシュボードの連携から事前に接続します。どちらの場合も、ShanoneをChatworkアカウントに対して許可するためのconnect_linkが発行されます。
2

Chatworkアカウントを許可する

Shanoneに操作させたいアカウントについて、ChatworkのOAuth同意画面を承認します。
3

リクエストを再実行する

接続が完了すると、chatwork_*ツールに対するshanone_execute_tool呼び出しが成功するようになります。

​
利用可能なツール

ShanoneはChatwork向けに32個のツールを、以下のカテゴリに整理して提供しています。
chatwork_get_room_messages, chatwork_send_message, chatwork_mark_as_read, chatwork_mark_as_unread, chatwork_get_message, chatwork_update_message, chatwork_delete_message
chatwork_list_rooms, chatwork_get_room_info, chatwork_list_room_members, chatwork_create_room, chatwork_update_room, chatwork_leave_room, chatwork_update_room_members
chatwork_create_task, chatwork_get_my_tasks, chatwork_list_tasks, chatwork_update_task_status, chatwork_get_task
chatwork_list_files, chatwork_get_file, chatwork_upload_file
chatwork_get_me, chatwork_get_my_status, chatwork_list_contacts, chatwork_list_incoming_requests, chatwork_approve_incoming_request, chatwork_reject_incoming_request
chatwork_get_invite_link, chatwork_create_invite_link, chatwork_update_invite_link, chatwork_delete_invite_link

​
よくあるユースケース

タスクのトリアージ

複数のチャットルームをまたいで自分の未完了タスクを取得し、期限が近いものを要約する

チャットルーム全体への告知

チャットルームに更新情報を投稿し、対応済みのメッセージを既読にする

ファイルの受け渡し

レポートや添付ファイルをプロジェクトのチャットルームに直接アップロードする

オンボーディングの自動化

チャットルームの招待リンクを発行し、届いたコンタクト申請を承認する

​
トラブルシューティング

接続済みのアカウントが対象チャットルームに既に参加している必要があります。送信前にchatwork_list_roomsでroom_idが認証済みユーザーから見えているか確認してください。
to_idsには、すでにそのチャットルームに参加している有効なChatworkアカウントIDをカンマ区切りで指定する必要があります。事前にchatwork_list_room_membersで確認してください。
Chatworkはアップロードをサーバー側で処理します。アップロードしたばかりのファイルがまだ一覧に出ない場合は、少し時間を置いてchatwork_list_filesを再実行してください。