チャネルオンボーディング — メディア運営者編¶

対象読者: メディア運営者 (spin-dd 運営担当)。システム管理者向けの手順はシステム管理者編を参照。

「初回のチャネル接続だけでなく、日々の使い方を一通り知りたい」場合はメディア運営者ハンドブック (利用開始 / 日次運用 / コンテンツ運用 / チャネル追加 / テナント切替 / FAQ) を参照。

このページに沿って作業すれば、LINE / HubSpot / Backlog のチャネルを新規 tenant 向けに発行・接続 できます。エンジニア知識は不要で、Claude Code セッションと各サービスの管理画面だけで完結します。

0. 前提条件 (管理者から受け取るもの)¶

作業を始める前に、システム管理者から以下を受け取っていることを確認:

担当テナント名 (例: bato)
automedia オンボーディング招待メール (件名 [automedia] <tenant> の運営者オンボーディングご案内、noreply@automedia.spin-dd.com から届く)。本文に 初期パスワード設定手順 + ~/.aws/config 用 snippet が含まれる
テーマリポを git clone 済 (例: spin-dd/bato-hubspot-theme)
「bootstrap 完了」の連絡 (システム管理者編 §1〜§8 完了)

未受領のものがあれば管理者に問い合わせる。

初回のみ: 初期パスワード + MFA 登録 → AWS CLI 設定 (10 分)¶

これは自分の PC ローカルで行う作業です

サーバや AWS Console での作業ではありません。具体手順はメディア運営者ハンドブック §1 を参照。

初期パスワード + MFA を登録 (詳細手順は handbook §1-2)
- SSO start URL に UserName のみ入力 → AWS から OTP パスコードメールを受信 → SSO portal にコードを入力 → 初期パスワード設定 → 続けて MFA (Authenticator アプリ) を登録
- 「Forgot password?」リンクは押さないこと (新規アカウントでは進めません / #188)
- OTP パスコードメールが届かない場合は管理者に one-time password の発行を依頼
AWS CLI をインストール (まだなら): macOS は brew install awscli、Windows は公式 MSI
テーマリポを git clone → cd <tenant>-hubspot-theme
Claude Code skill /automedia-aws-config-setup で ~/.aws/config を対話的に設定 (推奨)。招待メール本文の snippet を貼り付け (詳細)
動作確認: aws sso login --profile spindd-<tenant> → ブラウザで MFA → aws sts get-caller-identity --profile spindd-<tenant> で Account ID が返れば OK

1. AWS SSO ログイン (1 回 / 日)¶

$ aws sso login --profile spindd-<tenant>

ブラウザが開き、SSO Portal で MFA を入力すると完了。8 時間有効。詳細はクレデンシャル配布を参照。

複数テナントを担当する場合

aws sso login --sso-session spindd を 1 回すれば、担当する全テナント分の profile (spindd-bato, spindd-okada ...) が同時に有効になります。テナント切替は cd <tenant>-hubspot-theme でディレクトリを変えるだけ。具体手順はメディア運営者ハンドブック §5 を参照。

2. Claude Code セッションを開く¶

$ cd <tenant>-hubspot-theme
$ claude
> /automedia-init
# SSO 状態 + tenant 解決を skill が検証 → OK が出れば以降のスキルが使える

3. LINE チャネルを開設して投入¶

3-1. LINE 公式アカウントを作る¶

作業	URL / 場所
LINE Business ID 取得 (法人 ID、初回のみ)	https://account.line.biz/login
LINE 公式アカウント作成	https://www.linebiz.com/jp/entry/
OA Manager で「Messaging API を利用する」を有効化、月間配信通数プラン選択	https://manager.line.biz/

3-2. LINE Developers Console で Messaging API channel を作る¶

https://developers.line.biz/console/ にログイン
Provider を作成 (なければ) → その中に Messaging API channel を作成
上で作った OA と「Link to LINE Official Account」で接続

3-3. トークン 3 種を控える¶

入力項目	取得元
`channel_id`	Channel の Basic settings タブ → 「Channel ID」
`channel_secret`	同タブ → 「Channel secret」(コピーアイコンで取得)
`access_token`	同 Channel の Messaging API タブ → 「Channel access token (long-lived)」 (未発行なら Issue ボタン)

3-4. Webhook URL を Developers Console で登録¶

LINE Developers Console の Messaging API タブで:

Webhook URL: https://api.automedia.spin-dd.com/line/webhook/<channel_id>
Use webhook: Enabled
応答メッセージ: Disabled ← 重要 (automedia の welcome と二重化防止)
あいさつメッセージ: Disabled ← 同上

3-5. Claude Code で投入¶

> /automedia-secret-set provider=line

# 対話的に以下を聞かれます。クリップボードから貼り付け、入力中は伏字 (****) 表示:
  channel_id      : 2010xxxxxx
  channel_secret  : ************
  access_token    : ************

✓ JSON スキーマ検証 OK
✓ /automedia/<tenant>/line に保存しました
  last_updated_by: <あなたの SSO ユーザー名> / last_updated_at: 2026-05-26T10:23:45Z

skill が AWS API を呼ぶため、生キーがターミナル履歴やローカルファイルに残ることはありません。

3-6. 管理者に「LINE 完了」の連絡¶

channel_id の正式値を伝える (管理者が tenants.json > by_line_channel を更新する必要があるため)。

検証期間中の社外露出を絞る¶

最初の検証期間中は LINE 友だち追加 QR を社内 Slack のみで配布 し、本番ユーザーが流入しないようにする。

4. HubSpot を投入¶

4-1. HubSpot Private App を作る¶

HubSpot Portal にログイン
右上の 歯車 (Settings) → 左メニュー Integrations → Private Apps → Create a private app
Scopes で最低 content (Read & Write) にチェック
Create → 作成後の Access Token を控える (pat-na1-... で始まる)

4-2. 値の取得¶

入力項目	取得元
`access_token`	上の Private App の Auth タブ → 「Show token」 (`pat-na1-...`)
`portal_id`	Portal 右上アカウント名 → Account & Billing → Account ID (数字のみ)

4-3. Claude Code で投入¶

> /automedia-secret-set provider=hubspot

  access_token    : ************      # pat-na1-... を貼り付け
  portal_id       : 243366509          # 数字、省略可

✓ JSON スキーマ検証 OK
✓ /automedia/<tenant>/hubspot に保存しました

4-4. 管理者に「HubSpot 完了」の連絡¶

管理者が project.json > channels.hubspot の blog_id / author_id / author_name を取得・投入する。

検証期間中の社外露出を絞る¶

HubSpot Blog 投稿は state: DRAFT で作成 され、管理者の人間レビュー後に Publish される動線になっている。

5. Backlog の API キーを投入¶

Backlog の space_key / webhook_secret および TTRTAGSPIN プロジェクト自体の設定は 管理者が bootstrap 時に投入済 です。運営者は自分の 個人 API キー のみを更新します。

5-1. Backlog 個人 API キーを発行¶

https://spindd.backlog.com/EditApiSettings.action を開く
「登録」セクションで新規 API キーを発行 → コピー

5-2. Claude Code で投入¶

> /automedia-secret-set provider=backlog field=api_key

  api_key         : ************

✓ /automedia/<tenant>/backlog の api_key を更新しました
  (space_key / webhook_secret は変更されません)

5-3. TTRTAGSPIN プロジェクトに category を追加¶

https://spindd.backlog.com/projects/TTRTAGSPIN の管理画面で、新 tenant 名の category を追加 (HubSpot サイト名と一致させる、例: 馬頭 / おかだ)。

category 追加権限が無い場合は管理者に依頼する。

6. E2E 配信確認¶

TTRTAGSPIN プロジェクトに「コンテンツ運用」issueType でテスト課題を起票
「投稿日時」カスタムフィールドに 5 分後の時刻を設定
status を automedia承認 に変更
5 分後、Backlog コメントに [automedia] dispatched at ... が付き、LINE に配信されることを確認
status が automedia実行済み に自動遷移していることを確認

うまく動かない場合は管理者に連絡する (CloudWatch Logs を見れば原因が分かります)。

運営者チェックリスト¶

困ったとき¶

/automedia-secret-set が「権限不足」で失敗する → 管理者の bootstrap (Permission Set assignment) が完了していない可能性。管理者に連絡
aws sso login でブラウザが開かない → ~/.aws/config の sso_start_url が正しいか確認
配信が動かない → Backlog 課題の status が automedia承認 になっているか確認。automediaエラー になっていればコメントに失敗理由が書かれている
token を間違って入力した → 同じ /automedia-secret-set コマンドをもう一度実行すると上書きできる

チャネル オンボーディング — メディア運営者編¶

0. 前提条件 (管理者から受け取るもの)¶

初回のみ: 初期パスワード + MFA 登録 → AWS CLI 設定 (10 分)¶

1. AWS SSO ログイン (1 回 / 日)¶

2. Claude Code セッションを開く¶

3. LINE チャネルを開設して投入¶

3-1. LINE 公式アカウントを作る¶

3-2. LINE Developers Console で Messaging API channel を作る¶

3-3. トークン 3 種を控える¶

3-4. Webhook URL を Developers Console で登録¶

3-5. Claude Code で投入¶

3-6. 管理者に「LINE 完了」の連絡¶

検証期間中の社外露出を絞る¶

4. HubSpot を投入¶

4-1. HubSpot Private App を作る¶

4-2. 値の取得¶

4-3. Claude Code で投入¶

4-4. 管理者に「HubSpot 完了」の連絡¶

検証期間中の社外露出を絞る¶

5. Backlog の API キーを投入¶

5-1. Backlog 個人 API キーを発行¶

5-2. Claude Code で投入¶

5-3. TTRTAGSPIN プロジェクトに category を追加¶

6. E2E 配信確認¶

運営者チェックリスト¶

困ったとき¶

関連¶

チャネルオンボーディング — メディア運営者編¶