Skip to main content

​
LINE WORKS

ShanoneのLINE WORKS連携は、Shanoneのカタログの中で最大となる350個のツールをエージェントに提供します——日常的なメッセージング、メール、カレンダー、ドライブに加えて、本格的なディレクトリ管理(ユーザー、グループ、組織単位、カスタムフィールド)とBot管理までカバーします。

​
はじめに

1

LINE WORKS Developerアプリを登録する

LINE WORKS Developer Consoleでアプリを作成し、Client ID、Client Secret、およびJWTベース認証用の秘密鍵を持つService Accountを発行します。
2

Shanoneに4つすべての認証情報を追加する

ShanoneダッシュボードのIntegrations > LINE WORKSで、Client ID、Client Secret、Service Account、Private Keyを入力します——アクセストークンを発行するにはこの4つすべてが必要です。
3

リクエストを再実行する

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

​
利用可能なツール

ShanoneはLINE WORKS向けに350個のツールを、以下のカテゴリに整理して提供しています。
自分のドライブ、共有ドライブ、グループフォルダ、チャンネルフォルダにまたがるファイル/フォルダのCRUD、共有、権限、リビジョン、リンク、ゴミ箱——例: lineworks_upload_drive_file, lineworks_create_drive_permission, lineworks_list_drive_file_revisions, lineworks_create_drive_file_link
メンバーのライフサイクル、プロフィール、ステータス、アカウント連携——例: lineworks_create_member, lineworks_search_members, lineworks_suspend_member, lineworks_grant_member_link_to_works, lineworks_resolve_member_by_external_key
掲示板、投稿、コメント、添付ファイル——例: lineworks_create_board, lineworks_create_board_post, lineworks_search_board_posts, lineworks_create_board_post_comment
会社/個人の連絡先、タグ、カスタムプロパティ、写真——例: lineworks_create_contact, lineworks_search_user_contacts, lineworks_create_contact_custom_properties
組織階層のレベルと職位——例: lineworks_create_level, lineworks_create_position, lineworks_enable_levels
個人・デフォルトカレンダーとイベント——例: lineworks_create_calendar_event, lineworks_search_calendar_events, lineworks_update_default_calendar_event
Botのリッチメニューと常時表示メニュー——例: lineworks_create_rich_menu, lineworks_set_user_rich_menu, lineworks_create_persistent_menu
タスクとタスクカテゴリ——例: lineworks_create_task, lineworks_complete_task, lineworks_create_task_category
送信、フォルダ、フィルタ、転送——例: lineworks_send_mail, lineworks_create_mail_filter, lineworks_enable_mail_forwarding
グループ、メンバー、管理者、外部キー——例: lineworks_create_group, lineworks_add_group_administrator, lineworks_update_group_external_keys
BotとBotドメインの作成/更新——例: lineworks_create_bot, lineworks_register_bot_domain, lineworks_add_bot_domain_member
グループノートとノート投稿——例: lineworks_create_group_note, lineworks_create_group_note_post, lineworks_search_group_note_posts
メンバー、ユーザータイプ、チーム別の組織単位アクセス制限——例: lineworks_set_member_orgunit_access_restrict, lineworks_set_team_orgunit_access_restrict
チームとチームメンバーシップ——例: lineworks_create_team, lineworks_get_team_members, lineworks_move_team
カスタムフィールドとメンバーカスタムプロパティ——例: lineworks_create_custom_field, lineworks_create_member_custom_properties
カスタムユーザータイプとプロフィールステータス——例: lineworks_create_user_type, lineworks_create_profile_status
レベル、職位、ユーザータイプの外部キーマッピング——例: lineworks_update_level_external_keys, lineworks_list_position_external_keys
ダイレクト/チャンネルメッセージングと読み取り専用のBot/ユーザー/チャンネル参照——例: lineworks_send_message_to_user, lineworks_send_message_to_channel, lineworks_create_channel, lineworks_list_users
Bot添付ファイル、監査/モニタリングログのダウンロード、外部ブラウザポリシー——例: lineworks_upload_bot_attachment, lineworks_download_audit_logs, lineworks_enable_external_browser

​
よくあるユースケース

従業員オンボーディング

メンバーを作成し、組織単位/レベル/職位を割り当て、招待メールを送信する

社内ポータルの運用

掲示板に会社のお知らせを投稿し、必読の既読確認を追跡する

コンプライアンス対応のエクスポート

セキュリティレビューのために監査・モニタリングログをダウンロードする

ドキュメントのコラボレーション

きめ細かい権限でドライブフォルダを共有し、ファイルのリビジョンを追跡する

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

LINE WORKSは単純なベアラートークンではなく、JWTベースのサービスアカウント認証を使用します——Client ID、Client Secret、Service Account、Private Keyのすべてが正しく設定されている必要があり、1つでも欠けているか誤っているとトークンが発行されません。
これらのツールには、Developer Consoleでそのアプリに対してDirectory Management APIのスコープが付与されている必要があります——メッセージング専用のスコープでは不十分です。
通常の削除はソフトデリート/無効化にとどまることが多いです——メンバーレコードを永久かつ即座に削除する必要がある場合はlineworks_force_delete_memberを使ってください。
Botメッセージング系ツールは、lineworks_create_botで登録された特定のBotの認証情報の下で動作します——対象のBot IDがそのドメインで認可されているか、lineworks_list_bot_domainsで確認してください。