使い方ガイド

🆕 はじめての方：会社を登録する

他社の Lark でこのポータルを使うには、最初に 自社のテナント登録 が必要です。 各社で 1 度だけ実施してください。所要時間は 5〜10 分。

必要なもの

• Lark の カスタムアプリ作成権限（管理者または開発者ロール）
• 5 分の時間

手順

1. Lark 開発者コンソールを開く
   https://open.larksuite.com/app （飞书運用なら open.feishu.cn/app）
2. 「カスタムアプリ作成」から新規アプリを作成（アプリ名は何でも OK、例：「カードポータル」）
3. 左メニュー Add Features から ボット機能を有効化
4. 左メニュー Permissions & Scopes で以下の権限を追加：
   • im:message:send_as_bot（カード送信）
   • contact:user.base:readonly（OAuth ログイン用）
5. 左メニュー Security Settings → Redirect URL に以下を追加：
   https://lark-card-portal.pages.dev/auth/callback
6. 左メニュー Credentials & Basic Info から App ID と App Secret をコピー
7. 左メニュー Version Management & Release から新しいバージョンを作成・公開
8. ポータルの 会社を登録ページ で：
   • 会社名（例：株式会社BECOME RICH）
   • テナント URL slug（例：become-rich）
   • App ID / App Secret
   • Lark 種別（海外版 or 飞书）
   を入力 → 「登録」
9. 登録完了画面が出たら 「Lark でログインして始める」ボタンを押すと、 自社の Lark の認可画面が出ます。許可すれば あなたが admin として最初のメンバー になります。

かんたん 3 ステップ

① Lark でログインする

1. トップページ右上の 「Lark でログイン」 ボタンをクリック
2. Lark の許可画面が出るので、内容を確認して 「許可する」
3. 自動で戻ってきて、カードを作る画面（ビルダー）が開きます

② カードを組み立てる

タイトル帯

カードの上部にある色つきの帯です。お知らせの「種類」がひと目で分かるよう色を使い分けると効果的：

• 青 / 空 — 一般的なお知らせ
• 緑 / 碧 — 完了報告、ポジティブな内容
• 黄 / 橙 — 注意喚起、リマインド
• 赤 / 紅 — 緊急、トラブル報告
• 紫 / 藍 — イベント、特別な案内
• 灰 / 白 — おとなしめ、メモ

タイトル帯が不要なときは「タイトル帯を表示する」のチェックを外してください。

本文ブロック

下の「＋ ブロックを追加」から好きなパーツを足していきます。

各ブロックの右上：

• ↑ ↓ — 並び替え
• ✕ — 削除

ブロックの種類と使い分け

テキスト装飾（太字・リンクなど）

テキストブロックや注釈の中では、以下の記号で装飾ができます。

③ 送信先の Chat ID を調べる

Lark には「グループ ID」や「ユーザー ID」がそれぞれありますが、 本サービスで送信するには Chat ID（oc_ から始まる文字列）が必要です。

方法 A：Lark アプリの「グループ設定」から

1. 送信したい Lark のグループを開く
2. グループ名の右にある「⚙ 設定（または「⋯」）」を開く
3. 「グループ情報」や「Group ID」の項目から oc_xxxx... をコピー

表示が見当たらない場合は、グループ管理者に Bot 連携の権限を確認してもらうか、下の「方法 B」を試してください。

方法 B：Bot 経由で取得（推奨）

使いたい Lark のグループに 「秘書：エール」Bot を追加すると、その時点でグループの Chat ID が API 経由で取得できるようになります。

1. Lark でグループを開く → グループ設定 → 「グループ Bot」→ 「秘書：エール」を追加
2. 運用者にお願いして Chat ID 一覧を取得してもらう（コマンドで一覧が出ます）

送信する

1. 右下の「Chat ID」欄に oc_xxxx... を貼り付け
2. 「このカードを送信」ボタンを押す
3. 下に「送信しました ✓」と表示されたら成功。Lark で確認してください。

送信前にプレビューでイメージ通りか確認しましょう。「JSON」タブを切り替えれば、実際に送られる中身も見られます（普段は気にしなくて OK）。

うまくいかないとき

よくある質問