連携（LINE・AI）

こんなとき

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

画面に出る文言

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

なぜ起きるか

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

直し方

1. 配信一覧で該当の配信の〔詳細〕を開き、理由欄と内訳に「友だち未追加」が何件あるかを見る
2. 次回からは配信前に〔送信できる人数を確認〕を押して内訳を必ず確認する。「友だち未追加」に入っている人数には届かない
3. 店頭の友だち追加QRや、チェックイン画面の「友だち追加でクーポンプレゼント」バナー（店舗設定でON）を使って友だち追加を増やす（バナーを出してもクーポンは自動では届かない。LINE 公式アカウントのあいさつメッセージにクーポンを入れておく）
4. 友だち追加してもらえれば、次の配信から自動的に届くようになる

こんなとき

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

画面に出る文言

LINE 公式アカウントが未連携です。店舗設定で連携してください（下書き保存はできます）。

なぜ起きるか

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

直し方

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

こんなとき

LINE配信の〔クーポン・キャンペーンを送信〕で、送信するクーポンを選ぼうとしたとき

画面に出る文言

停止中のため送信できません。「クーポン・くじ」で［再開する］を押すと送信できます。

なぜ起きるか

〔クーポン・キャンペーンを送信〕には、削除していないクーポンとキャンペーンがすべて並びます。停止中のもの・配布期間が終わったもの・見出しの無いものは灰色になり、選べません（カードに、送信できない理由と、送信できるようにする手が書いてあります）。配布開始前のものは選べますが、送信日時を配布開始以降にする必要があります（〔今すぐ送信〕は押せず、ボタンの上に理由が表示されます）。くじはレシート専用のため、LINE では送信できず並びません。削除したものも並びません。

直し方

1. 灰色のカードに書いてあるとおりにする（停止中なら〔クーポン・くじ〕で〔再開する〕を押す。配布期間が終わっているなら〔編集〕で「配布期間」を延長する。見出しが無いならカードの中の〔内容を編集〕で見出しを入力する）
2. LINE配信の画面を開き直すと、選べるようになる
3. クーポンがまだ無いときは、LINE配信の〔クーポンを追加〕から追加する（追加したクーポンを選択した状態で戻る）。〔クーポン・くじ〕を編集できる権限が無い人には、このボタンは表示されない

こんなとき

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

画面に出る文言

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

なぜ起きるか

毎朝の自動送信は、前日までにレジで締めた営業日だけを送ります。締めていない日は届かず、当日分がその日のうちに届くこともありません。ほかに、連携先に本部側の店舗コードが入っていない、対象の営業日がレジで開けられていない（開店処理がない）と止まります。商品コードが未設定でも売上は届きますが、商品別の明細の番号が空になります。

直し方

1. 届いていない営業日を、レジで締めたかを確かめる。締めていなければ締める（締めれば、翌朝5時半ごろの自動送信で送られます）
2. 管理画面 →「外部システム連携」→ 対象の連携先で「編集」を開き、店舗コードが「未設定」になっていないか確認して入力する
3. その日の営業日がレジ側で開けられているか確認する。開店の記録が無い日はデータを作れない
4. 商品コードの警告が出ている場合は、商品コードの一括取込（CSV）で埋める。埋めないと商品IDが空欄のまま本部に届く
5. それでも届かない日は、〔外部システム連携〕の連携先の行の〔再送〕を押し、その営業日が「送信済み」か「送信失敗」かを見る。送り直すときは、その日を選んで再送を予約する（次の朝5時半の自動送信で送ります）
6. 本部側で必要なコードの値が分からない場合はサポートへ連絡する

こんなとき

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

画面に出る文言

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

なぜ起きるか

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

直し方

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

こんなとき

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

画面に出る文言

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

なぜ起きるか

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

直し方

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

こんなとき

管理画面の「AI連携・MCP」の手順どおりに追加したあと

画面に出る文言

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

なぜ起きるか

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

直し方

1. 管理画面 →「AI連携・MCP」を開き、表示されているサーバーURLをコピーして貼り直す。ChatGPTは「OAuthの詳細設定」の「OIDCを有効にする」のチェックを外す（Claudeは認証の設定を変えない）
2. Claude.ai の無料プランはカスタム接続が1つまで。ほかの接続を消すか、有料プランにする
3. Museは、会話に「確認が必要なタスクがあります」と出ていたら〔承認〕を押す。許可の画面は別の窓で開くので、出てこないときはブラウザが muse.ai のポップアップを止めていないか確かめる
4. 接続に使うアカウントは、ロッキーレジの管理画面に自分でログインできるアカウントにする（招待メールを受け取っただけでログインしていないアカウントでは使えない）
5. つながっているのにレジの機能が呼べない場合は、AI側で接続を一度削除して追加し直し、新しいチャットで試す
6. それでも直らない場合はサポートへ連絡する（アカウントと店舗の紐づけを確認します）

こんなとき

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

なぜ起きるか

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

直し方

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

こんなとき

LINE配信を追加して「今すぐ送信」または「送信を予約」をしたあと。あるいは「送信できる人数を確認」を押しても「0 人に配信」としか出ないとき。初めて配信する日に多い。

画面に出る文言

0 人に配信 ／ （人数）人：お店の LINE を友だち追加していない ／（配信一覧の理由欄）全件送信失敗：友だち未追加 12件

なぜ起きるか

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

直し方

1. ①「配信を追加」の画面の〔クーポン・キャンペーンを送信〕で、送信しようとしているクーポン・キャンペーンが灰色になっていないか見る。灰色のカードには、送信できない理由と、送信できるようにする手が書いてある（停止中なら〔クーポン・くじ〕で〔再開する〕を押す。配布期間が終わっているなら配布期間を延長する）。送信予約した配信が一覧で失敗になり、理由の欄にクーポンの停止や配布期間が書いてあるときも同じで、クーポン・キャンペーンを直してから配信を作り直す。くじは LINE では送信できない
2. ②「配信を追加」の画面で「送信できる人数を確認」を押し、内訳を見る。「お店の LINE を友だち追加していない」（設定が済んでいないときは「友だちかどうかを判定できていない」）に大半が入っていないか確認する。ここに入っている人数には届かない
3. ③管理画面の〔店舗〕で、いま選んでいる店舗の行の〔設定を編集〕を押し、「LINE 連携」の欄で「LINE 配信」が接続済みか確認する。未接続だと送信ボタン自体が押せない（下書き保存のみ）
4. ④同じ画面の「LINE 配信」が「接続済（まだ受信なし）」で、かつ畳んである「接続の設定と LINE 側の手順」の〔LINE 側の設定を確認する〕で「LINE 側に URL が登録されていません」か「URL は登録されていますが、Webhook がオフです」と出るなら、「Webhook URL（LINE からの通知の受信先）」のURLを横の〔コピー〕でコピーし、LINE Developers Console の「Webhook URL」に貼って「Webhookの利用」をON、さらに LINE公式アカウントマネージャー → 設定 → 応答設定 の「Webhook」もON にする（スイッチは2か所）。そのあと〔LINE 側の設定を確認する〕でもう一度確かめる
5. ⑤内訳の下の「今月の送信数 ◯ 通 / 上限 ◯ 通」を見る。赤字で「（このまま送信すると上限を超えます）」と出ていたら上限に達しているので、翌月まで待つか、LINE 公式アカウントの管理画面で契約プランか追加メッセージ数の上限目安を見直す（上限は LINE で決まり、ロッキーレジの画面では変えられない）
6. ④が原因のときは、設定より前にもらった友だち追加はさかのぼって記録されない。設定より前から友だちだった方は、次にご来店いただいてチェックインされた時点で記録される
7. 店頭で友だち追加してもらっているのに配信対象が全員「友だち未追加」になる場合は、この群の「友だち追加してもらったのに、配信対象が全員「友だち未追加」のままになる」も合わせて見る（④と同じ原因）