LINE Messaging API連携の進め方：Webhookと確認手順
既存のLINE公式アカウントをSocratesへ接続するために、Messaging API、チャネルシークレット、アクセストークン、Webhookの役割と設定手順を整理します。権限・秘密情報・動作確認・トラブル切り分けまで担当者向けに解説します。
既存のLINE公式アカウントをSocratesへ接続するには、認証情報を登録するだけでなく、Webhookの受信と実際の返信まで確認する必要があります。この記事では、LINE Messaging API連携の設定手順と確認方法を、担当画面ごとに整理します。
作業では、LINE Official Account ManagerとLINE Developersを使用します。Socrates側で必要な操作は、利用中の管理画面、公式案内、またはサポートで確認してください。確認できていない入力欄やWebhook URLの取得方法を前提に作業を進めないでください。LINE側の項目名や配置が本文と異なる場合は、LINEの公式資料と実際の管理画面を優先します。
！【前提】作業権限について
最初に、対象のLINE公式アカウントでMessaging APIの設定を変更できる権限があるか確認します。権限名や操作範囲は現行の管理画面で確認し、不足している場合はアカウント管理者へ作業を依頼してください。権限を確認しないまま進めると、途中で設定項目が表示されず、別アカウントを誤って操作する原因になります。
設定前のチェックリスト
- ✅ 対象のLINE公式アカウント名と管理組織が一致している
- ✅ LINE Official Account ManagerとLINE Developersへログインできる
- ✅ Socrates側で必要な設定項目と操作手順を、利用中の管理画面、公式案内、またはサポートで確認できる
- ✅ 既存の自動応答、手動チャット、あいさつメッセージの運用を把握している
- ✅ 設定変更を実施する日時と、問題が起きた場合の復旧担当者を決めている
- ✅ 変更前の設定状態を、秘密情報が写らない方法で記録している
ステップ 1：API の利用開始
LINE Official Account Managerで対象アカウントを開き、Messaging APIの利用を開始します。操作を確定する前に、アカウント名と担当組織を照合してください。
- 1対象のLINE公式アカウントを開き、設定画面からMessaging APIに関する項目を選びます。
- 2画面に表示された案内を読み、Messaging APIの利用開始操作を進めます。
- 3プロバイダーを選択します。既存のプロバイダーを使うか新規作成するかは、社内の管理単位を確認して決めます。
確定後は、LINE Developersに表示されたプロバイダー、Messaging APIチャネル、対象組織の組み合わせを照合します。ここでは照合結果だけを記録し、認証情報の取得はステップ2、Webhook URLの登録はステップ3へ進みます。
ステップ 2：2 つのキーの取得
LINE Developersで対象のMessaging APIチャネルを開き、チャネルシークレットとチャネルアクセストークンを確認します。このステップでは取得元を記録し、用途と入力先は後段の対応表で照合します。
- 1LINE Developersで対象のプロバイダーとチャネルを選び、LINE公式アカウント名と一致することを確認します。
- 2チャネル基本設定に相当する画面で、チャネルシークレットを確認します。
- 3Messaging API設定に相当する画面で、利用するチャネルアクセストークンを確認または発行します。表示される種別や発行方法は現行画面に従ってください。
⚡ 注意：トークンを変更または再発行する前に、利用中の接続先と影響範囲を確認してください。変更時の保管・記録方法は後段の「連携前に確認する権限と秘密情報」に集約します。
ステップ 3：Socrates への接続設定
Socrates固有の入力欄、必要な認証情報、Webhook URLの取得方法は、利用中の管理画面、公式案内、またはサポートで確認します。本文では未確認の画面名称や入力場所を断定しません。確認できた手順だけを実施し、取得したWebhook URLをLINE Developersの対象チャネルへ登録してください。
- 1利用中の管理画面、公式案内、またはサポートで、LINE Messaging API連携に使用する設定画面の有無と名称を確認します。
- 2確認できた案内にチャネルシークレットまたはチャネルアクセストークンの登録が含まれる場合は、指定された欄へ入力して保存します。入力値の前後に空白がないか確認してください。
- 3確認できた案内に従ってWebhook URLを取得します。取得場所を確認できない場合はSocratesへ問い合わせます。URLを取得できた場合は、別環境のURLと取り違えないよう対象アカウントも同時に確認してください。
- 4確認済みの方法で取得したWebhook URLを、LINE Developersの対象チャネルへ登録して保存します。URLの先頭・末尾に空白がなく、対象チャネルと接続先の組み合わせが正しいことも確認します。
ステップ 4：応答設定（最重要）
最後に、Webhookの利用状態とLINE側の既存応答を確認します。既存の自動応答を一律に停止するのではなく、SocratesとLINE側のどちらが、どの問い合わせへ返信するかを先に決めてください。
確認する項目
応答設定の名称や併用条件は変更される可能性があります。現行画面とLINEの公式資料を確認し、自社の運用方針に合う設定を選んでください。Webhookと既存応答の担当範囲を記録し、返信内容の合否は後段の「動作確認は6種類の質問で行う」で判定します。
動作確認とよくあるトラブル
- 返信がない場合
まずWebhookの利用状態とURLを確認し、同じ代表質問を再送します。改善しなければ、Socrates側で確認済みの設定が反映されているか、対象チャネル、アクセストークンの順に確認します。一度に複数の設定を変えず、各変更後の結果を記録してください。 - 二重に返信される場合
LINE側の既存自動応答とSocrates側の返信が、同じメッセージへ反応していないか確認します。どちらかを停止する前に、重複した返信内容と発生条件を記録してください。 - 認証情報のエラーが出る場合
チャネルシークレットとチャネルアクセストークンの取り違え、別チャネルの値、変更後の未更新を確認します。秘密情報をチャットへ貼り付けて第三者に確認を求めないでください。
FAQ：よくある質問
Q1. 設定を保存すれば連携は完了ですか？
保存だけでは完了と判断できません。Webhookの検証結果を確認し、LINEのトーク画面から代表質問を送ります。確認済みの製品仕様と自社の回答方針に沿った返信になり、不要な重複返信がないかを確認します。
Q2. 既存のあいさつメッセージは残せますか？
あいさつメッセージを含むLINE側の応答との併用可否は、現行の応答設定と実際のテストで確認してください。残す場合は、友だち追加時と通常の問い合わせ時を分けて確認します。
Q3. LINEから送った画像やPDFを処理できますか？
LINE経由の添付ファイルに関するSocratesの対応範囲は、利用中の機能仕様を確認してください。対応が確認できた場合だけ、許可した形式と内容でテストします。
Q4. トークンの有効期間や再発行の影響はどう確認しますか？
利用するトークンの種別によって扱いが異なるため、LINE Developersの現行表示と公式資料を確認します。変更後はSocrates側の登録値を確認し、代表質問を再送してください。
Q5. 連携を停止したい場合は？
WebhookとLINE側の応答設定を確認し、停止中の問い合わせを有人対応または別の窓口へ案内できる状態にします。変更前の設定と復旧手順を記録してから停止してください。
ここまでの操作記録には、対象チャネル、各ステップの実施者、確認時刻だけを残します。試験結果は後段の「運用担当者が残す確認記録」へ集約し、認証情報の実値はどちらにも記載しません。
LINE Messaging API連携を選ぶ判断基準
ステップ1の設定を始める前に、連携の目的を判断します。LINE上でSocratesの回答運用を行うのか、独自処理を実装するのかを切り分けてください。
選定時は、必要な処理の範囲を確認します。LINE上でSocratesのAI接客を運用することが目的なら、Socrates連携が候補になります。独自の予約処理や社内システムの更新など、固有の処理を実行する必要がある場合は、自作開発を含む別の構成を検討します。自作する場合は、実装だけでなく、認証、署名検証、監視、障害対応を誰が担当するかも判断材料に含めます。
チャネル、トークン、Webhookの関係
ステップ2とステップ3で設定値の取り違えを防ぐため、作業者とは別の確認者が次の対応表で取得元と入力先を照合します。
| 項目 | 役割と確認先 |
|---|---|
| プロバイダー | チャネルを管理する単位。対象の組織やサービスと一致するか確認する |
| Messaging APIチャネル | LINE公式アカウントと外部サービスを接続する設定単位 |
| チャネルシークレット | Webhook署名の検証に関係する秘密情報。Socrates側で登録が必要か、必要な場合の入力先を公式案内またはサポートで確認する |
| チャネルアクセストークン | Messaging APIを呼び出す際の認証情報。利用する種別を現行画面で確認する |
| Webhook URL | LINEからイベントを送るHTTPSの宛先。Socrates側の取得方法を公式案内またはサポートで確認し、確認できたURLをLINE Developersへ登録する |
この表はステップ2とステップ3の入力前に使う照合票です。「対象チャネル」「取得元」「入力先」「確認者」の四欄を設け、各欄が同じ接続先を示す場合だけ作業を進めます。秘密情報の実値は照合票へ記載しません。
連携前に確認する権限と秘密情報
ステップ2とステップ3で取得した秘密情報の実値は、作業記録、本文、共有チャットへ転記しません。ここでは設定手順を繰り返さず、保管と変更時の判断基準だけを確認します。閲覧者と更新担当者を限定し、社内で承認された保管方法を使用してください。
秘密情報として扱う内容
- チャネルシークレットとチャネルアクセストークンの実値
- 管理画面のパスワードや認証情報
- 秘密情報が表示されたスクリーンショット
変更時の確認
- 変更前に、利用中の接続先と影響範囲を確認する
- 変更後に、必要な登録値と動作確認の範囲を現行資料で確認する
- 秘密情報の実値を含まない確認結果は「運用担当者が残す確認記録」へ集約する
担当変更時は、秘密情報そのものを複製せず、保管場所への権限と更新手順を引き継いでください。
動作確認は6種類の質問で行う
ステップ1からステップ4までの設定後は、接続試験と回答試験を分けます。まずLINE Developersで対象チャネルのWebhook検証を実行し、結果を記録します。検証が通らない場合はLINEトークへ進まず、Webhook URL、対象チャネル、確認済みのSocrates側設定を一項目ずつ照合します。検証結果を確認できたら、次の6種類を基本セットとしてLINEトークで返信の合否を判定してください。
- 代表質問：店舗の営業時間など、登録済み情報で答えられる質問
- 言い換え質問：代表質問と同じ意図を別の表現で尋ねる
- 情報不足の質問：料金や契約条件など、条件を補わなければ答えられない質問
- 回答不可の質問：個別判断を含み、AIが断定すべきでない相談
- 有人案内の確認：回答できない場合に、回答文として社内で決めた相談先や連絡方法を案内できるか
- 添付の確認：対応仕様を確認済みの場合だけ、許可した形式を送る
代表質問と言い換え質問は一組で保存し、設定変更後も同じ条件で比較します。合格条件は項目ごとに分けます。実トーク返信は、送信した質問に対して意図した返信が一度返ることです。回答不可は、断定的な回答を返さないことです。有人対応は、社内で定めた相談先または引き継ぎ方法が案内されることです。重複返信は、同じ質問に対して不要な返信が複数返らないことです。各結果を個別に記録してください。
WebとLINEを同じ回答運用へつなぐ
WebとLINEを併用する場合は、入口が違っても、回答できない範囲、個人情報に関する注意、有人対応へ案内する条件をそろえます。チャネルごとの入口と共通ナレッジの考え方は、Webサイト埋め込みとLINE連携の運用ガイドで確認できます。
LINE公式アカウントを相談窓口として運用する場合は、APIの接続後に、案内文、返信の担当範囲、既存の配信との関係を決める必要があります。運用設計を確認する際は、LINE公式アカウントを相談窓口として運用するポイントも参照してください。
権限、秘密情報、会話データの取扱いを社内で説明するときは、Socratesのセキュリティと運用方針を参照し、自社の保管方法、閲覧者、更新手順と照合します。
連携方式と設定値に関するよくある質問
Q6. LINE Messaging APIとLINE公式アカウントは同じものですか？
同じものではありません。設定時は、LINE公式アカウント名と、それに対応するMessaging APIチャネルが一致しているかを確認してください。
Q7. Webhook URLは何をするものですか？
LINEからイベントを送るHTTPSの宛先です。設定後はWebhook検証の結果を確認します。
Q8. トークンを変更した後は何を確認しますか？
対象チャネルと更新が必要な登録箇所を現行資料で確認し、更新後に保存済みの質問で再テストします。
Q9. 自作ボットとSocrates連携はどう選びますか？
AI接客の回答運用が目的ならSocrates連携を候補にします。独自処理が必要なら、実装と保守の担当範囲を決めて自作を検討します。
運用担当者が残す確認記録
確認記録には「対象のLINE公式アカウント名」「対象チャネル」「作業者」「確認者」「作業日時」「変更理由」「変更内容」「変更前後の設定状態」「Webhook検証の結果」「基本セットのテスト質問」「追加したテスト質問」「期待結果」「実際の結果」「停止方法」「復旧担当者」「連絡先」の欄を設けます。認証情報を変更した場合は、「更新者」「更新日時」「対象チャネル」「現行資料で確認した更新箇所」も残します。ただし、チャネルシークレット、チャネルアクセストークン、パスワードの実値は記載しません。再テストでは同じ行へ新しい実施日時と結果を追記し、前回との差を確認してください。
記入例は「営業時間を教えてください／今日は何時まで営業していますか｜期待結果：登録済みの営業時間を案内する｜確認項目：返信内容・返信回数・確認時刻」のように一行へまとめます。情報不足と回答不可の試験では、期待する確認案内または社内窓口を同じ形式で記入します。
結果欄は「Webhook検証」「実トーク返信」「回答不可」「有人対応」「重複返信」に分けます。各欄へ合否と確認時刻を記入し、不合格の項目だけを「動作確認とよくあるトラブル」の切り分け順序で再確認します。
復旧手順を決めてから公開する
公開前に、最後に正常だった日時、直前の変更、停止判断者、利用者への代替案内、復旧確認者を復旧票へ記入します。障害時は「確認項目」「変更した項目」「再試験の結果」を一行ずつ追記し、一度に複数の設定を変更しません。Socrates固有の画面項目や有人対応の方法は、利用中の管理画面または製品資料で確認できた内容だけを復旧票へ記載してください。
停止条件には、判断者、代替案内先、停止を開始する状態を記載します。復旧条件には、Webhook検証と保存済み質問の再試験が完了し、重複返信がなく、確認者が結果を承認したことを記載してください。
連携の完了条件は、認証情報とWebhook URLの保存、Webhookの受信確認、LINEトークでの通常回答・回答不可・重複返信の確認が終わり、結果と復旧手順が記録されていることです。
自社の応答設定、有人対応へ案内する条件、秘密情報の管理方法を判断できない場合は、確認したい項目を整理したうえでSocratesの設定確認または導入相談をご利用ください。
