このガイドでは、LINE連携が有効なワークスペースで、LINE公式アカウントをSankaに接続する方法を説明します。設定手順、期待動作、顧客照合の制約、トラブルシューティング、AIに依頼する前のチェックポイントを確認し、設定問題とプロダクト不具合を切り分けやすくします。
LINE連携を使う場面
LINE連携は、LINE公式アカウントで顧客との会話を受け付け、その会話をSankaで確認したいチーム向けです。LINEの利用可否はワークスペース設定によって異なる場合があるため、すべてのワークスペースで標準的に作成・利用できるとは限りません。
次の場合にこのガイドを使います。
- ワークスペース管理者またはSankaサポートが、LINE連携の有効化を確認しています。
- LINE公式アカウントとLINE Developersのチャネルにアクセスできます。
- LINEからの受信イベントをSankaワークスペースに接続します。
- Webhook配信、チャネルアクセストークン、顧客照合を確認します。
LINEは、Sankaのすべてのメッセージチャネルを置き換えるものではありません。メール、SMS、Slack、通話、LINEでは、ワークスペース設定に応じて作成、取り込み、照合、返信の挙動が異なる場合があります。
事前準備
- LINE公式アカウントを用意します。
- 対象のプロバイダーとMessaging APIチャネルにアクセスできるLINE Developers権限を用意します。
- チャネルアクセストークンを発行またはコピーできる権限を用意します。
- Messaging APIのWebhook URLを編集できる権限を用意します。
- Sankaで連携サービスを作成できるワークスペース管理者権限、または管理者の協力を用意します。
- 対象ワークスペースでLINE連携が有効になっていることを確認します。
- LINE会話に関連付ける可能性がある取引先担当者、会社、チケット、その他のレコードを閲覧または更新できる権限を確認します。
AIに設定チェックリストを作成してもらいます
トークンやWebhook設定を変更する前に、Sankaに接続したClaudeまたはCodexへチェックリスト作成を依頼します。管理者が現在の設定を確認するまでは、AIにトークンの再発行、Webhook URLの変更、顧客返信、顧客レコード更新を依頼しないでください。
/sanka LINE公式アカウントをSankaに接続するためのチェックリストを作成してください。LINE Developers権限、Messaging APIチャネル設定、チャネルアクセストークン、Sankaワークスペース権限、Webhook URL検証、期待される受信メッセージの動作、顧客照合の確認、不具合として扱う前に集める証跡を含めてください。トークン、Webhook設定、顧客レコードは変更しないでください。
LINE Developersを準備します
LINE Developersで次を確認します。
- LINE公式アカウントのプロバイダーを開きます。
- 対象アカウントで使うMessaging APIチャネルを作成するか、既存チャネルを開きます。
- チャネルが正しいLINE公式アカウントに接続されていることを確認します。
- Messaging APIチャネルのチャネルアクセストークンを発行またはコピーします。
- トークンを安全に管理します。認証情報として扱い、連携設定に必要なワークスペース管理者のみに共有してください。
Sanka連携を作成します
Sankaで次を行います。
- ワークスペース > 連携サービス を開きます。
- ワークスペースに LINE が表示されている場合は選択します。
- LINEが表示されない場合は、ワークスペース管理者またはSankaサポートにLINE連携が有効か確認します。
- 連携を作成し、LINE Developersで取得したチャネルアクセストークンを入力します。
- 連携を保存します。
- SankaのLINE連携に表示されるWebhook URLをコピーします。
Sankaサポートまたは管理者が通常の連携サービス画面以外で連携を作成した場合は、Webhook URLと接続状態をどこで確認するかを確認してから続けてください。
LINE Webhookを設定します
LINE Developersで次を行います。
- Messaging APIチャネルを開きます。
- Webhook URL にSankaのWebhook URLを貼り付けます。
- Webhookの利用を有効にします。
- LINE DevelopersでWebhook検証を利用できる場合は実行します。
- LINE公式アカウントにメッセージを送信できるテスト用LINEアカウントから、テストメッセージを送ります。
- Sankaに戻り、ワークスペースで設定されているメッセージ画面または会話画面にメッセージが表示されるか確認します。
検証に失敗する場合は、プロダクト不具合として扱う前に、Webhook URL、チャネルアクセストークン、チャネル状態、ワークスペースでのLINE連携有効化を確認します。
期待動作
設定後は、次の動作が期待されます。
- SankaがワークスペースのLINE接続を保存します。
- Webhookが有効な場合、LINEはMessaging APIイベントをSankaのWebhookへ送信します。
- メッセージは、ワークスペースで設定されているSankaのメッセージ画面または会話画面にのみ表示されます。
- 顧客照合は、ワークスペースで利用できる識別子とレコードに依存します。
- SankaがLINE送信者を確実に識別できない場合、会話は未割り当てのままになるか、確認が必要な状態になります。
- 返信、取り込み、自動化は、ワークスペースとチャネルで有効な場合に限り利用できます。
- チャネルアクセストークンの再発行やWebhook URLの変更を行うと、SankaとLINE Developersの設定をそろえるまで配信が停止する場合があります。
LINEページ、ボタン、作成オプションが表示されない場合でも、すぐに不具合とは判断しないでください。まず、ワークスペースでLINEが有効であり、対象チャネルが依頼された操作に対応していることを確認します。
ログを検索すべてのアクションすべての日付
LINEの問題をプロダクト不具合として扱う前に、これらのチェックポイントを確認します。多くの設定問題は、ワークスペース有効化、チャネルアクセストークン、Webhook URL、Webhook配信、顧客照合で説明できます。
顧客照合と関連付け
LINE送信者の識別情報は、メールアドレスや電話番号とは異なります。照合は、ワークスペースで利用できるレコードと識別子に依存します。Sankaが送信者を確実に識別できる場合にのみ、会話が自動で関連付くことが期待されます。
送信者が不明な場合は、取引先担当者、会社、チケット、受注、請求書、その他のレコードに関連付ける前に会話を確認します。チームが送信者の本人確認とワークスペースの同意ルールを確認するまでは、LINEメッセージだけを根拠に顧客レコードを作成または統合しないでください。
LINE会話が未対応のサポート内容に関係する場合は、関連するチケットまたはタスクを紐づけ、次の担当者がフォローアップ内容を理解できるようにします。
よくある問題を確認します
| 問題 | 確認すること |
|---|
| 連携サービスにLINEが表示されません | ワークスペースでLINE連携が有効か確認します。有効でない場合は、接続を作成する前にワークスペース管理者またはSankaサポートへ確認します。 |
| Webhook検証に失敗します | Webhook URLを正しいSankaワークスペースからコピーしたこと、WebhookとMessaging APIチャネルが有効になっていることを確認します。 |
| メッセージがSankaに表示されません | チャネルアクセストークン、Webhook URL、Webhook設定、ワークスペース有効化、LINE用に設定されたSankaのメッセージ画面を確認します。 |
| 間違った顧客に表示されます | 保存する前に、顧客識別子と既存の関連付けを確認します。LINE送信者の識別は手動確認が必要な場合があります。 |
| 返信できません | ワークスペースでLINE返信が有効か、ユーザーがそのチャネルから返信できる権限を持つか確認します。 |
| トークン変更後に配信が止まりました | Sanka連携に現在のチャネルアクセストークンを設定し、もう一度テストメッセージを送信します。 |
| 会話が重複します | 複数のLINEチャネルまたはワークスペースが同じWebhookやLINE公式アカウントを参照していないか確認します。 |
| AIがLINEをメールやSMSと同じように扱っています | 返信文やコード変更案を作成する前に、ワークスペース有効化、チャネル固有の挙動、対応しているメッセージ画面を確認します。 |
AIに安全に確認させます
LINEの問題では、AIが返信やコード変更案を作成する前に、問い合わせを次の観点で分類します。
- 有効化: このワークスペースでLINE連携を利用できますか。
- チャネル設定: LINE公式アカウントが正しいMessaging APIチャネルに接続されていますか。
- Webhook配信: SankaのWebhook URLがLINE Developersに保存され、有効化されていますか。
- トークン有効性: チャネルアクセストークンが再発行された、または別チャネルのものがコピーされていませんか。
- メッセージ画面: このワークスペースではLINE会話がどこに表示されますか。
- 顧客照合: 送信者を取引先担当者、会社、チケット、受注に関連付けるための証跡がありますか。
- 権限: ユーザーはこの会話を閲覧または返信できますか。
/sanka このLINE連携の問題について、顧客返信やコード変更案を作成する前に確認してください。ワークスペースでのLINE有効化、LINE公式アカウントとMessaging APIチャネル、Webhook URL、Webhook配信、チャネルアクセストークン、設定済みのSankaメッセージ画面、顧客照合の証跡、ユーザー権限を確認してください。期待動作、不足している証跡、安全な次の確認事項を要約してください。プロダクトの動作が誤っている証跡があるまで、顧客返信の送信、トークン変更、レコード再関連付け、コード変更案の作成は行わないでください。
AIは、ワークスペース、LINEチャネル状態、Webhook検証結果、テストメッセージの証跡を確認する返信文の下書きを作成できます。トークン、Webhook、関連付け、返信、自動化ルールを変更する前には、人の確認を挟んでください。
関連ガイド