連携（LINE・AI）

こんなとき

クーポンやお知らせをLINEで配信したあと。配信一覧では成功扱いなのに、お客様から「来ていない」と言われる

画面に出る文言

（配信一覧の理由欄）一部失敗：友だち未追加 2件 ／（配信の詳細）友だち未追加

なぜ起きるか

LINEの決まりで、店の公式アカウントを「友だち追加」していないお客様にはメッセージを送れません。モバイルオーダーのQRからLINEでチェックインしただけのお客様は「友だち」ではないので、対象に見えていても届きません。

直し方

1. 配信一覧で該当のキャンペーンを開き、理由欄と内訳に「友だち未追加」が何件あるかを見る
2. 次回からは配信前に「配信対象プレビュー」の内訳を必ず確認する。「友だち未追加」に入っている人数には届かない
3. 店頭の友だち追加QRや、チェックイン画面の「友だち追加でクーポンプレゼント」バナー（店舗設定でON）を使って友だち追加を増やす
4. 友だち追加してもらえれば、次の配信から自動的に届くようになる

こんなとき

クーポン配信を作って送信しようとしたとき。下書き保存はできるのに送信だけ通らない

画面に出る文言

LINE Messaging API が未設定です。店舗設定で連携してください（下書き保存は可能）。

なぜ起きるか

LINE連携は「①LIFF／ログイン（お客様の識別）」と「②Messaging API（配信）」の2つに分かれていて、①だけつながっている状態です。メッセージを送るには②の接続が必要です。

直し方

1. 管理画面 → 店舗設定 →「LINE 連携」を開く
2. 「② Messaging API（クーポン・レシートの配信）」が「未接続」になっていないか見る
3. 「Messaging API を接続する」を押し、LINE Developers Console の Messaging API チャネルの チャネルID／チャネルシークレット／アクセストークン（long-lived）を入力する
4. 「① LIFF / ログイン」が未接続だと②は接続できないので、先に①をつなぐ
5. LINE Developers 側の値がどこにあるか分からない場合はサポートへ連絡する

こんなとき

LINE配信を新規作成し、配信するクーポンを選ぼうとしたとき

画面に出る文言

この promo は LINE 掲載ルートが選択されていません。クーポン定義で「LINE で配信」をチェックしてください

なぜ起きるか

クーポンの設定で「LINE で配信」の掲載先にチェックが入っていないクーポンは、LINE配信の選択リストに出ません（店頭掲示だけのクーポンを誤って配信しないための仕組みです）。

直し方

1. 管理画面 → クーポン（店舗プロモ）を開く
2. 配信したいクーポンを編集し、掲載先で「LINE で配信」にチェックを入れて保存する
3. LINE配信の作成画面を開き直すと、選択リストに出てくる

こんなとき

毎日自動で本部に送っているはずなのに本部側に当日分が無い、または手動でファイルを作ろうとしてエラーになるとき

画面に出る文言

この連携先に external_store_code（WinB店舗コード）が未設定です。外部システム連携の編集画面で設定してください。／ 12 件のメニューに外部コード未設定（メニューID が空欄で出力されます）

なぜ起きるか

連携先に本部側の店舗コードが入っていない、対象の営業日がレジで開けられていない（開店処理がない）、商品コードが未設定、のいずれかで止まっています。

直し方

1. 管理画面 →「外部システム連携」→ 対象の連携先で「編集」を開き、店舗コードが「未設定」になっていないか確認して入力する
2. その日の営業日がレジ側で開けられているか確認する。開店の記録が無い日はデータを作れない
3. 商品コードの警告が出ている場合は、商品コードの一括取込（CSV）で埋める。埋めないと商品IDが空欄のまま本部に届く
4. 本部側で必要なコードの値が分からない場合はサポートへ連絡する

こんなとき

外部システム連携で送信先やパスワード、ファイル名などを変更して保存したあと

画面に出る文言

設定を変更しました。テスト送信を再実行してください（状態が「設定済み・未テスト」に戻る）

なぜ起きるか

接続情報を変更すると「テスト成功」の記録がいったん取り消され、自動送信も止まります。テスト送信をやり直して成功させるまで再開しません。

直し方

1. 管理画面 →「外部システム連携」の自動連携一覧で、状態が「稼働中」以外になっていないか見る
2. 対象の「配送設定」を開き、「2. テスト送信」の「テスト送信を実行」を押す
3. 成功したら「3. 自動連携を稼働」のトグルをONにする（テスト成功までトグルは押せません）
4. テスト送信が失敗する場合は、画面に出たエラー文言を控えてサポートへ連絡する

こんなとき

複数店舗を運営しているアカウントで、AIからレジのデータを聞いたとき

画面に出る文言

この操作は store_id の指定が必須です。list_stores で対象店舗を確認して渡してください（省略時の primary fallback による取り違え事故防止）。

なぜ起きるか

店舗を取り違えて別の店の数字を答えてしまう事故を防ぐため、複数店舗を見られるアカウントでは「どの店か」の指定が必須になっています。

直し方

1. 質問文に店名を入れて聞き直す（例：「◯◯店の今日の売上を教えて」）
2. それでも通らないときは、先に「使える店舗の一覧を出して」と聞き、返ってきた店名をそのまま使って聞き直す
3. 「全店合計」を一度に聞くことはできない。店舗ごとに分けて聞く

こんなとき

管理画面の「外部連携 (MCP)」の手順どおりにコネクタを追加したあと

画面に出る文言

Unauthorized: invalid or expired OAuth token（AI側では「接続できませんでした」等と表示）

なぜ起きるか

AI側の無料プランはカスタム接続が1つまでで枠が埋まっている、または接続に使ったアカウントがまだ店舗に紐づいていない（招待されただけで一度もログインしていない）ことが多いです。

直し方

1. 管理画面 →「外部連携 (MCP)」を開き、表示されているサーバーURLをコピーして貼り直す。OAuthの項目はすべて空欄のままでよい
2. Claude.ai の無料プランはカスタム接続が1つまで。ほかの接続を消すか、有料プランにする
3. 接続に使うアカウントは、ロッキーレジの管理画面に自分でログインできるアカウントにする（招待メールを受け取っただけでログインしていないアカウントでは使えない）
4. つながっているのにレジの機能が呼べない場合は、AI側で接続を一度削除して追加し直し、新しいチャットで試す
5. それでも直らない場合はサポートへ連絡する（アカウントと店舗の紐づけを確認します）

こんなとき

店頭でお客様に友だち追加してもらった直後や、配信対象プレビューで「LINE配信可 0人／友だち未追加 全員」になっているとき

なぜ起きるか

LINE側に登録する「通知の受け取り先（Webhook URL）」がロッキーレジを向いていないと、友だち追加された通知がレジまで届きません。レジは誰が友だちなのか分からないままなので、全員が未追加として扱われます。

直し方

1. 管理画面 → 店舗情報の編集 → LINE を開く。「⚠️ 接続済（まだ受信なし）」と出ていれば、友だち追加をまだ1件も受け取れていない状態。〔接続を確認する〕を押して「LINE 側に URL が登録されていません」または「Webhook が OFF です」と出たら、以下の手順で直す
2. 「Webhook URL の登録」の欄にお店専用のURLが出ている。〔Webhook URL にこの URL を貼って更新する〕でコピーする
3. LINE Developers Console の Messaging API 画面で、そのURLを「Webhook URL」に貼って更新し、「Webhookの利用」をONにする
4. スイッチはもう1か所ある。LINE公式アカウントマネージャー → 設定 → 応答設定 の「Webhook」もONにする（片方だけだと通知は送られてこない）
5. 店舗設定に戻って〔接続を確認する〕を押す。「設定は正しく入っています」と出れば完了。〔テスト送信〕で実際に届くところまで確かめられる
6. この設定より前にいただいた友だち追加はさかのぼらない。設定より前から友だちだった方は、次にご来店いただいてチェックインされた時点で記録される

こんなとき

LINE配信を作って「今すぐ送信」または「送信を予約」をしたあと。あるいは「対象をプレビュー」を押しても「0 人に配信」としか出ないとき。初めて配信する日に多い。

画面に出る文言

0 人に配信 ／ 友だち未追加（除外）: （人数）人 ／（配信一覧の理由欄）全件送信失敗：友だち未追加 12件

なぜ起きるか

原因は上から順に5つあり、下に行くほど気づきにくくなります。①配るクーポンに「LINE で配信」のチェックが無い、②友だち追加していない人ばかりで実際の宛先が0人、③店舗設定でMessaging APIがつながっていない、④LINE側に通知の受け取り先（Webhook URL）が登録されていないため友だち追加が1件も記録されていない、⑤当月の送信上限を超えている。とくに④が多く、このときは店舗設定の LINE の欄が「⚠️ 接続済（まだ受信なし）」になっています（この表示は「まだ1件も受け取れていない」という意味なので、④なのか、単に誰も友だち追加していないだけなのかは〔接続を確認する〕で切り分けます）。

直し方

1. ①管理画面 →「販促 promo / クーポン」で、配ろうとしているクーポンの「掲載ルート」に「LINE で配信」のチェックが入っているか確認する。入っていないと、そもそも配信の「配布するクーポン」の一覧に出てこない
2. ②LINE配信の作成画面で「対象をプレビュー」を押し、内訳を見る。「友だち未追加（除外）」に大半が入っていないか確認する。ここに入っている人数には届かない
3. ③管理画面 → 店舗情報の編集 → LINE で「② Messaging API」が接続済みか確認する。未接続だと送信ボタン自体が押せない（下書き保存のみ）
4. ④同じ画面が「⚠️ 接続済（まだ受信なし）」で、かつ〔接続を確認する〕が「URL が登録されていません」「Webhook が OFF です」を返すなら、「Webhook URL の登録」の欄のURLをコピーし、LINE Developers Console の「Webhook URL」に貼って「Webhookの利用」をON、さらに LINE公式アカウントマネージャー → 設定 → 応答設定 の「Webhook」もON にする（スイッチは2か所）。そのあと〔接続を確認する〕で診断できる
5. ⑤プレビューの下の「当月送信 ◯ / ◯」を見る。赤字で「（クォータ超過）」と出ていたら上限に達しているので、翌月まで待つか、店舗設定の「Messaging API クォータ」の「月次配信上限」を上げる
6. ④が原因のときは、設定より前にもらった友だち追加はさかのぼって記録されない。設定より前から友だちだった方は、次にご来店いただいてチェックインされた時点で記録される
7. 店頭で友だち追加してもらっているのに配信対象が全員「友だち未追加」になる場合は、この群の「友だち追加してもらったのに、配信対象が全員「友だち未追加」のままになる」も合わせて見る（④と同じ原因）