# LINE連携設定 ヘルプ ## 概要 LINE連携では、施設のLINE公式アカウントとUnlockOSを接続します。連携することで、ゲストがLINEを通じてチェックイン・チェックアウト・予約などの操作を行えるようになります。 ## 主な機能 - LINE公式アカウントとの連携設定（4ステップウィザード） - リッチメニューの自動生成・設定 - Webhook URLの自動設定 - チェックイン機能・予約機能の組み合わせ選択 - 管理者への通知設定 --- ## 事前準備 LINE連携を行うには、以下が必要です。 | 必要なもの | 説明 | |-----------|------| | LINE公式アカウント | LINE Official Account Managerで作成 | | Messaging API | LINE公式アカウントのMessaging APIを有効化 | | Channel ID | LINE Developersコンソールで確認 | | Channel Secret | LINE Developersコンソールで確認 | | Channel Access Token | LINE Developersコンソールで発行 | --- ## セットアップウィザード LINE未接続の場合、4ステップのウィザードが表示されます。 ### Step 1: LINE公式アカウントの作成 LINE公式アカウントをすでにお持ちの場合は「はい、持っています」を選択して Step 2 に進みます。 アカウントをお持ちでない場合は「いいえ、作成する」を選択して、以下の手順で作成します。 1. 「LINE Official Account Manager を開く」ボタンをクリック 2. 「アカウントを作成」→ 無料プランを選択 3. アカウント名に施設名を入力 4. アカウント作成後、「作成しました → 次へ」ボタンをクリック ### Step 2: Messaging API を有効化 1. LINE Official Account Manager の「設定」→「Messaging API」を開く 2. 「Messaging APIを利用する」をクリック 3. プロバイダーを選択して同意 4. 有効化が完了したら「有効化しました → 次へ」ボタンをクリック ### Step 3: Channel情報をコピー&ペースト 1. 「LINE Developers Console を開く」ボタンをクリック 2. 対象チャンネルの「Basic settings」タブで **Channel ID** と **Channel Secret** を確認 3. 「Messaging API」タブで **Channel Access Token** を発行（「Issue」ボタン） 4. 各値をコピーして、下記フォームに貼り付け | 入力項目 | 取得場所 | |---------|---------| | Channel ID | Basic settings タブ | | Channel Secret | Basic settings タブ | | Channel Access Token | Messaging API タブ（要発行） | 接続テストを行うには「接続テスト」ボタンをクリックします。Channel Access Token が正しければ、LINEボット名が表示されて成功となります。 #### LINE Login Channel ID / Secret（任意・施設ごとのLIFFアプリ発行用） 同じ画面に **「LINE Login Channel ID（任意）」** と **「Login Channel Secret（任意）」** という入力欄があります。これは施設専用のLIFFアプリ（ゲストがLINEから開くミニアプリ）を発行するための設定で、以下のいずれかに該当する場合のみ入力してください。 | 入力欄 | 用途 | |--------|------| | LINE Login Channel ID | LIFFアプリを LINE Login チャネル上に作成した場合に入力します。LIFF IDの「-」より前の数字と同じ値です。空欄の場合は Channel ID（Messaging API チャネル）が使われます。Messaging API チャネルと同一プロバイダー配下である必要があります | | Login Channel Secret | あわせて入力すると、連携時に UnlockOS がこの施設専用のLIFFアプリを **自動作成** します（LINE Developers Console でLIFF設定を別途行う必要がなくなります）。保存後は画面上に再表示されません | どちらも空欄のまま連携すると、施設専用のLIFFアプリは作成されず、プラットフォーム共通のLIFFアプリ（従来の1施設限定の仕組み）にフォールバックします。複数施設でLINE連携を使う場合は、施設ごとに固有のLIFFアプリが必要になるため、これらの項目の入力を推奨します。 すべての項目を入力したら「次へ →」をクリックして Step 4 へ進みます。 ### Step 4: サービス選択 このLINE公式アカウントで提供するサービスを選択します。少なくとも1つ選択が必要です。 | 設定項目 | 説明 | |---------|------| | チェックイン設定 | 既存のチェックイン設定をドロップダウンから選択。選択するとチェックイン・鍵表示・チェックアウト機能が有効になります | | 予約設定 | 既存の予約設定をドロップダウンから選択。選択すると予約一覧・新規予約機能が有効になります | チェックイン設定・予約設定のいずれか、または両方を選択できます。「なし」を選択すると、その機能は無効になります。 #### リッチメニューのレイアウト ここで選んだチェックイン設定・予約設定の有無に応じて、リッチメニューに表示する機能（チェックイン / 予約）が自動判定されます。画面下部のプレビューで確認できます。 **すべてのリッチメニューは、選んだ機能に加えて末尾に必ず「お問い合わせ」「施設情報」の2セルが固定表示されます。** 表示する機能セルは最大4つ（このステップではチェックイン・予約の最大2つ）で、機能セルの数によってレイアウトが自動で決まります。 | 機能セルの数 | レイアウト | |------------|-----------| | 1つ（チェックインのみ、または予約のみ） | ハーフサイズ（3×1）。機能1セル + お問い合わせ + 施設情報の3セルで隙間なく埋まります | | 2つ（チェックイン + 予約の両方） | フルサイズ（3×2）。機能2セル + お問い合わせ + 施設情報の4セルが埋まり、残り2セルは空白（タップ不可）になります | より多くの機能（会員・回数券・ロッカー・入居者ポータルなど、最大4つまで）をリッチメニューに載せたい場合は、連携完了後に表示される「リッチメニュー表示設定」で個別に選択できます（下記「接続済みの状態」を参照）。 設定内容を確認したら「接続して自動設定 →」ボタンをクリックします。接続が完了すると、リッチメニューとWebhookが自動で設定されます。 --- ## 接続済みの状態 LINE連携が完了すると、以下の情報と設定が表示されます。 ### 自動設定状態 | 項目 | 説明 | |-----|------| | リッチメニュー | ゲストのLINE画面に表示されるメニューの設定状態 | | Webhook URL | LINEからUnlockOSへの通知を受け取るURLの設定状態 | | LIFFディープリンク | LIFFアプリのディープリンクが設定済みかどうか。プロビジョニングが「完了」なのにこの項目だけ未設定の場合、リッチメニューの各ボタンが（LIFFアプリではなく）通常のWebページとして開いてしまいます | 「LIFFディープリンク」が未設定のまま表示された場合は、黄色い注意メッセージが表示されます。Step 3 の Channel 情報（および任意項目の Login Channel ID / Secret）を確認し、再接続してください。 ### リッチメニュー表示設定 連携が完了すると「リッチメニュー表示設定」セクションが表示され、リッチメニューに載せる機能を個別に選び直せます。 - 選択できる機能: **チェックイン・予約・メンバーシップ・回数券・ロッカー・居住者ポータル**（施設で有効な機能のみ表示されます） - 選択できるのは**最大4つ**まで（チェックボックス形式）。チェックイン・予約など特定の設定を必要とする機能は、あわせて対象の設定をドロップダウンから選びます - 画面には実際の配置に基づいた**プレビュー**が表示され、選択内容を変えるとリアルタイムで反映されます - 何も選択しない場合は Step 4 で選んだチェックイン設定・予約設定の有無から自動判定されます（上記「リッチメニューのレイアウト」を参照） - 選んだ機能に関わらず、末尾の **「お問い合わせ」「施設情報」の2セルは常に固定表示**されます - 変更後は **「保存してリッチメニューを再生成」** ボタンをクリックしてください #### 固定セル（お問い合わせ・施設情報） すべてのリッチメニューの末尾に、以下の2つの固定セルが常に表示されます。これらは施設側で表示・非表示を切り替えることはできません。 | セル | タップ時の動作 | |-----|--------------| | お問い合わせ | LIFFアプリは開かず、LINEのトーク画面でそのままチャット入力キーボードが開きます。ゲストが入力したメッセージは、そのまま施設のLINE公式アカウントのトーク画面に届きます（UnlockOS側では内容を転送・保存しません） | | 施設情報 | LIFFアプリは開かず、施設名・住所・電話番号・連絡先メールなどを含むカード形式のメッセージがトーク画面に返信されます。表示される情報は[基本設定](base-settings.md)に登録された施設情報です | ### 管理者通知設定 LINEを通じて管理者（施設オーナー）に通知を送る条件を設定できます。 | 通知設定 | 説明 | |---------|------| | チェックイン時に管理者に通知 | ゲストがチェックインした際に通知 | | チェックアウト時に管理者に通知 | ゲストがチェックアウトした際に通知 | | 決済失敗時に管理者に通知 | 決済エラーが発生した際に通知 | 設定を変更したら「通知設定を保存」ボタンをクリックしてください。 > **注意**: 管理者通知を受け取るには、管理者自身がLINE公式アカウントを友だち追加している必要があります。 > **この設定と[通知ワークフロー](notification-workflow.md)の「施設管理者」向け通知は別機能です。** ここで設定するのはチェックイン/チェックアウト/決済失敗をLINEで知らせる従来の仕組みです。新規予約・承認待ち・決済完了・キャンセル・延長などの予約イベントに応じたオーナー通知は、通知ワークフローの「施設管理者」宛ワークフローで管理します（現状はEmailのみで届きます）。 ### お友達追加QRコード ゲストにLINE公式アカウントを友だち追加してもらうためのQRコードは、LINE Official Account Manager の「友だちを増やす」から取得できます。 ### 連携解除 「連携解除」ボタンをクリックすると、LINE連携・リッチメニュー・Webhook設定がすべて削除されます。解除後は再度ウィザードから設定を行う必要があります。 --- ## ゲスト向けLIFFアプリの操作フロー LINE連携が完了すると、ゲストはリッチメニューのボタンをタップして施設とやり取りができます。ボタンによってはLIFFアプリ（LINE内ブラウザ）が起動するものと、LINEトーク画面内で直接応答が返るものがあります。以下のフローでゲストが操作を行います。 ### 初回のみ：メールアドレス登録 LINEから初めてチェックインしようとしたゲストには、メールアドレス登録画面が表示されます。 1. メールアドレスを入力 2. お名前を入力（省略可。省略時はLINE表示名が使用されます） 3. 「次へ」ボタンをタップ → チェックイン画面に進む 登録は1回のみです。2回目以降は自動的にチェックイン画面に進みます。 ### チェックインフロー 1. リッチメニューの「チェックイン」をタップ 2. 料金内訳が表示される（プランによって内容が異なります） 3. 「チェックインする」ボタンをタップ 4. 処理完了後、デジタル鍵（QRコードまたはPINコード）が表示される ### 鍵の表示 チェックイン完了後、または「鍵を表示」ボタンをタップすると、入室用の鍵情報がLINEのトーク画面に直接メッセージとして送信されます。アプリの起動は不要です。鍵情報はリッチなカード形式で表示されます。 カードに含まれる情報： - QRコード画像（ドア横の読み取り機にかざして使用） - PINコード（該当する場合。ドア横のテンキーに入力） - 部屋・スマートロック名 - チェックイン日時 - 鍵の有効期限 同じ施設で複数のチェックインが有効な場合は、すべての鍵がカルーセル形式で連続して表示されます。 | 鍵タイプ | 操作方法 | |---------|---------| | QRコード | ドア横の読み取り機にスマートフォンの画面をかざす | | PINコード | ドア横のテンキーにコードを入力する | 鍵は滞在中のみ有効です。チェックアウト後は無効になります。 ### チェックアウトフロー 1. リッチメニューの「チェックアウト」をタップ 2. チェックイン時刻と料金明細が表示される 3. 「チェックアウトする」ボタンをタップ 4. 「ご利用ありがとうございました」の完了画面が表示される ### お問い合わせ・施設情報（固定セル） リッチメニューの末尾には、選択した機能に関わらず常に「お問い合わせ」「施設情報」の2つのボタンが表示されます。 - **お問い合わせ**: タップするとLINEのチャット入力キーボードが直接開き、ゲストはその施設のLINE公式アカウント宛にメッセージを送信できます（アプリは開きません） - **施設情報**: タップすると施設名・住所・電話番号・連絡先メールなどをまとめたカードがトーク画面に返信されます（アプリは開きません） --- ### 予約一覧・新規予約 1. リッチメニューの「予約確認」をタップ → 予約一覧が表示される 2. 各予約のプラン名・日程・ステータスを確認できる 3. 「新しい予約をする」ボタンをタップ → 予約サイト（booking.unlockos.io）が外部ブラウザで開く --- ## トラブルシューティング ### 接続テストが失敗する - **Channel Access Token が正しいか確認**: LINE Developers Console の Messaging API タブで、Tokenを再発行して貼り付け直してください。 - **Messaging API が有効か確認**: LINE Official Account Manager の「設定」→「Messaging API」で有効化されているか確認してください。 - **コピーミスに注意**: Token の前後に余分なスペースや改行が含まれていないか確認してください。 ### プロビジョニングが失敗する（リッチメニュー・Webhookが設定されない） - **Channel Secret が正しいか確認**: Basic settings タブで Channel Secret を再確認してください。 - **サポートに連絡**: エラーメッセージをコピーして support@unlockos.com にお問い合わせください。 ### リッチメニューがゲストのLINEに表示されない - 接続済み画面の「自動設定状態」でリッチメニューが「設定済み」になっているか確認してください。 - ゲストがLINE公式アカウントをまだ友だち追加していない可能性があります。QRコードを提供してください。 - LINE側の反映に数分かかる場合があります。 ### 管理者に通知が届かない - 管理者のLINEアカウントでLINE公式アカウントを友だち追加しているか確認してください。 - 通知設定が有効になっているか確認してください。 ### LIFFアプリが開かない・エラーが表示される - **「LIFF ID not configured」エラー**: システム側の設定問題です。support@unlockos.com にお問い合わせください。 - **「LINE login required」エラー**: LINEアプリ内からボタンをタップしているか確認してください。外部ブラウザから直接URLを開いた場合に表示されます。 - **画面が真っ白になる**: LINEアプリを再起動してからもう一度お試しください。 ### ゲストのチェックインが失敗する - ゲストが初回メールアドレス登録を完了しているか確認してください。 - チェックイン設定が正しく選択されているか確認してください（LINE連携設定のStep 4）。 - チェックイン設定が有効で、利用可能な料金プランが存在するか確認してください。 ### 鍵が表示されない - 「鍵を表示」をタップすると、LINEのトーク画面にメッセージとして鍵が届きます。アプリが起動するわけではないため、ゲストはLINEのトーク履歴を確認するよう案内してください。 - チェックインは成功しているが鍵のメッセージが届かない場合、スマートロックの接続設定を確認してください。[ロック接続](lock-connection.md)ページを参照してください。 - 鍵カードは表示されるがドアで使えない場合は、ロック接続状態と鍵の有効期限を確認してください。 ### ゲストの予約が表示されない - 予約設定が正しく選択されているか確認してください（LINE連携設定のStep 4）。 - 予約ステータスが「確定（confirmed）」であることを確認してください。 --- ## よくある質問 ### Q: 1つのLINE公式アカウントで複数の施設を管理できますか？ A: いいえ、1つのLINE公式アカウントは1施設のみに連携できます。複数施設を管理する場合は、施設ごとにLINE公式アカウントを作成してください。 ### Q: すでにMessaging APIを使用しているLINE公式アカウントを連携できますか？ A: 連携は可能ですが、既存のWebhook設定はUnlockOSのURLに上書きされます。既存のWebhook設定をご利用中の場合は事前にご確認ください。 ### Q: LINE連携後にチェックイン設定や予約設定を変更できますか？ A: 現在の仕様では、変更するには一度連携を解除して再度設定し直す必要があります。 ### Q: ゲストはLINEでどのような操作ができますか？ A: ゲストはリッチメニューのボタンをタップして施設とやり取りができます。チェックイン設定を選択した場合は「チェックイン・デジタル鍵（LINEトーク画面にFlexメッセージで直接送信）・チェックアウト」、予約設定を選択した場合は「予約一覧の確認・新規予約（予約サイトへリダイレクト）」ができます。選択内容に関わらず、リッチメニューの末尾には常に「お問い合わせ」「施設情報」ボタンが表示され、チャット入力または施設情報カードで応答します。 ### Q: 複数の施設でLINE連携を使う場合、ゲストのLINEアカウントは共有されますか？ A: いいえ。LIFFアプリは施設ごとに発行され、LINEのユーザーIDは発行元のLIFFアプリ（LINE Loginチャネル）単位で異なる値になります。そのため、同一人物でも施設が違えば別のゲストアカウントとして扱われます。施設間で滞在履歴を引き継ぐことはできません。 ### Q: ゲストが初めてLINEからチェックインする際に何が必要ですか？ A: 初回のみ、LIFFアプリ上でメールアドレスの登録が必要です。登録後はメールアドレスとLINEアカウントが紐づけられ、次回以降は自動でチェックイン画面に進みます。 ### Q: チェックイン時に料金は表示されますか？ A: はい。チェックイン確認画面で、適用される料金プランの内訳と合計金額が表示されます。 ### Q: セットアップが難しい場合はどうすればいいですか？ A: ページ下部の案内から、有償のセットアップ代行サービスをご依頼いただけます。ボタンをクリックすると、お問い合わせフォーム（unlockos.io/contact）に移動します。 --- ## 関連ページ - [ロック接続（KEYVOX・Stripe）](lock-connection.md) - [チェックイン設定](checkin-config-form.md) - [予約設定](reservation.md) - [LINE通知](line-notifications.md) - [通知ワークフロー](notification-workflow.md)