- WebhookとAPIって聞いたことはあるけど、よくわからない
- AIで効率化したいけど、業務への活かし方がわからない
- 結局、どんなことができるの？
そんな疑問を持つ方は多いはずです。
そこで今回ご紹介するのは、Lステップの新機能「API連携」。
このAPI連携は、Webhook転送と組み合わせることで往復連携を実現し、これまでにないデータ連携の形をつくれる仕組みです。
「Webhook転送 × API連携」で何ができるのか。どんなシーンで活用できるのか。
この記事では、その仕組みと可能性をわかりやすく解説していきますので、ぜひ最後までご覧ください。
この機能は高度な設定となります。設定の際は十分にご注意ください。
また、弊社サポートでは記事に関する質問は完全にお答えしきれない可能性があります。ご了承いただきますようお願い申し上げます。
また、利用にあたって気を付けることを記載しましたので、こちらも必ずご確認ください。
API連携の申請方法は、【Lステップ×AI 外部連携セミナー】（オンライン／参加費無料）にご参加いただいた方のみ、申請が可能となります。
目次
【おさらい】Webhook転送とは
API連携の仕組みをより深く理解するために、まずは一度「Webhook転送」について整理しておきましょう。
というのも、Webhook転送はAPI連携と組み合わせることで往復連携の片側を担う、重要なパーツだからです。
Webhook転送の仕組み
Webhook転送とは「友だちがLINE上で行ったアクションを、外部システムへリアルタイム通知する仕組み」です。
たとえば、Lステップと連携しているLINE公式アカウントで以下のような動きがあるたびに、LステップはLINE公式アカウントから受け取った通知をそのまま外部システム（GAS・Make・スプレッドシートなど）へ転送します。
- 友だち追加した
- テキストやスタンプを送った
- アカウントをブロックした
- ボタンをタップした
つまりWebhook転送は、LステップがLINE公式アカウントからの通知を外に知らせる出口と覚えておくといいでしょう。
さらにWebhook転送データには、必ず UID（LINEユーザーID）が含まれ、 誰がアクションしたかを特定できます。
Webhook転送の注意点
Webhook転送は、「LINE公式アカウント上で起きたアクション」を外部システムへ通知するための仕組みです。
そのため、取得できるのはあくまでLINE上の動きに関するデータのみで、Lステップ内部の情報（タグ・友だち情報など）を取得することはできません。
言い換えると、Webhook転送だけではLステップから外部の一方向（送信専用）にとどまります。
ここで必要になるのが、今回の新機能「API連携」 です。
Webhook転送：
外へ通知する仕組み（Lステップ → 外部）
API連携：
外からLステップを操作・更新する仕組み（外部 → Lステップ）
この2つを組み合わせることで、双方向にデータが行き来する「往復連携」 が可能になります。
Webhook転送とAPI連携は、それぞれ役割が明確に異なるため、両者の違いを理解して設計することが重要です。
API連携とは
API連携について解説します。
※API連携機能は高度な設定と専門的な知識を必要とするため、現状はプロプラン以上でのみ利用可能です。
※重要なお知らせ
API連携は高度な設定が必要です。多くの方がイメージを持つ「API＝なんでもできる」というわけではなく、連携できるシステムには制限がございます。
詳しくは是非無料セミナーにご参加ください。
API連携の仕組み
API連携は、外部からLステップのアクション設定を実行できる機能です。つまり、外部からLステップを操作するための仕組みです。
外部システムからLステップへ命令を送り、以下のようなLステップ側のアクションが自動で動作します。
- タグ付け／タグ削除
- 友だち情報の更新
- 友だち情報への値の登録・加算・減算
- メッセージ送信（サンクス・リマインドなど）
- リマインドの設定
API連携で実行できる操作
API連携では、Lステップのアクション設定で設定できる内容が実行できます。
たとえば、外部システムの情報（予約日時・購入金額など）を引き継いで、メッセージへの挿入やタグの自動作成、リマインダ配信のゴール日に指定などが可能です。
ただし、外部システムでもUID（LINEユーザーID）を把握していることが必須です。
Webhook転送・API連携のどちらでもUIDを必ず使用するので、外部システム側でUIDを把握していなければ、正しくユーザーを操作できません。
※UIDの部分はLステップの「friendID」を使用することもできます。外部システム側でfriendIDが管理できる場合に利用してください。
Webhook転送 × API連携で実現する「往復連携」の仕組み
Webhook転送とAPI連携は単体でも便利ですが、両方を組み合わせることで「外部とLステップの往復連携 」の仕組みが実現します。
■データ往復連携の3ステップ
1.Webhook転送
ユーザーのアクションをLステップが外部へ「知らせる」
2.外部システム
UIDでデータを受け取った外部システムがデータを整理・判定して「考える」
外部システムのGAS・Make・スプレッドシートなどが「このユーザーは次にどうすべきか」を判定します。
3.API連携
UIDを使ってLステップのAPI連携を呼び出し、アクションを「動かす」
外部システムが Lステップへアクションを動かすように指示します。この指示により、タグの作成やメッセージへの挿入が実行できます。
取得した情報を、そのままメッセージに埋め込んで配信することもできます。
例）商品購入時のメッセージ
Webhook転送+API連携の主な活用例
Webhook転送+API連携の活用例を紹介します。
■ 外部予約システムのリマインド
外部予約システムで予約後、UIDを照合してLステップから予約に必要事項を埋め込んだリマインダ配信をします。
■ AI自動返信Bot
ユーザーがLINEで質問し、Webhook転送で外部AIへ送ります。その後、API連携でLステップから回答を送信できるので、24時間自動対応チャットが構築可能です。
■ ECサイトでの購入フォロー
購入時に入力した情報（商品名・価格・コースなど）を友だち情報として登録し、配信のセグメントに活用できます。
API連携の申請方法
API連携の申請方法は、【Lステップ×AI 外部連携セミナー】（オンライン／参加費無料）にご参加いただいた方のみ、申請が可能となります。
※API連携機能は高度な設定と専門的な知識を必要とするため、現状はプロプラン以上でのみ利用可能です。
ご興味がある方は、まずセミナーにお越しください。
API連携とMakeを連携する設定手順
ここでは連携ツールの「Make」を例として、API連携とMakeを連携する設定手順を5つのステップで簡単に解説します。
- 受信用エンドポイントを作成する
- パラメータを作成する
- Lステップのアクション設定をする
- 認証に必要なアクセストークンを取得する
- 外部システムからAPIリクエストを送信する
設定に入る前に、Lステップ側でAPI連携の情報を入れるために、あらかじめタグや友だち情報欄などを作成しておきます。
- タグ ：API連携_イベント①申込
- 友だち情報欄：API連携_イベント①申込内容
①受信用エンドポイントを作成する
受信用の箱のようなイメージで、エンドポイントを作成します。
1.左メニューからAPI連携を開いて【エンドポイント設定】タブをクリックします。
2.【+新しいエンドポイント】をクリックしてエンドポイントのラベル名を入力し、作成します。
3.エンドポイントを作成すると、エンドポイントごとの設定画面に移動できます。
②パラメータを作成する
1.【パラメータ管理】タブをクリックして、【+新しいパラメータ】をクリックします。
2.パラメータ登録画面で各項目を設定します。
| 項目 | 説明 |
| ①JSONキー | 外部システムからのリクエストでパラメータ名として設定する文字列です。
例）event_type、event_name、user_nameなど |
| ②データ型 | 文字列・数字・日時のいずれかを選択できます。 |
| ③ラベル | 管理用のラベルです。アクション設定をする時に表示されます。
例）イベント形式、イベント名、申込者名、過去の累計参加回数など |
【ラベルのイメージ】
3.必要なパラメータが作成できたら、パラメータ登録は完了です。
③Lステップのアクション設定をする
API連携を使った時にどのようなアクションをしたいかの設定をします。
1.【連携アクション】タブをクリックして、【+連携アクションを追加】をクリックします。
2.連携アクション新規作成画面が開くので、必要な項目を設定します。
| 項目 | 説明 |
| ①連携アクション | 管理用のアクション名を入力します。 |
| ②ステータス |
保存後も、一覧画面でステータスを切り替えられます。 |
| ③友だちの絞り込み | アクションの実行対象となる友だちを絞り込みます。 |
| ④アクション設定 | APIリクエストが送られたときに実行するアクションを設定します。 |
3.【保存】をクリックしてアクションの作成は完了です。
④認証に必要なアクセストークンを取得する
リクエストには、認証のためにトークンが必要です。トークンはAPI連携画面の「認証」タブから確認・コピーできます。
次の⑤の手順でもトークンをコピーできます。
⑤外部システムからAPIリクエストを送信する
外部システム側で、受信用エンドポイントに送るリクエストを用意します。
1.API連携 > 【エンドポイント設定】タブ > 「リクエストを送りたいエンドポイント名」をクリックします。
2.エンドポイント詳細画面で、【cURL実行サンプル】をクリックします。
3.「cURL実行サンプル」が表示されます。【コピー】をクリックすると、実行サンプルをコピーできます。
- 【コピー】からコピーした場合、マスクされたトークンが実際のトークンに置き換わります。
- 該当のエンドポイントで作成したパラメータのキーはサンプルに記載しています。値にはサンプルの値が表示されます。
※UIDの部分はLステップの「friendID」を使用することもできます。外部システム側でfriendIDが管理できる場合に利用してください。
4.LステップでのAPI連携機能の設定はこれで完了です。「cURL実行サンプル」を使用して、外部システム側でリクエストを送る設定をしてください。
下記はMakeへ設定した場合のサンプル画面です。Make側の必要な項目に、「cURL実行サンプル」の情報を入力します。
正しく設定ができたら、作成したエンドポイントに外部システムからリクエストが起きると、設定したアクションが実行されます。
【要確認】API連携で気を付けること
Webhook転送とAPI連携で実現する「往復連携」の仕組みはとても便利ですが、次の2点に気をつけましょう。
①UIDを外部システムでも取得できているか確認する
API連携はUIDまたはfriendIDを必ず使用するので、外部システム側でUIDを把握していなければ、正しくユーザーを操作できません。
外部システムでもUIDを把握していることが必須です。UIDまたはfriendIDのないAPI連携の設定自体ができないため、導入前に必ず確認しましょう。
②「Webhook転送でLステップ内部の情報が取得できる」と誤解しない
Webhook転送は、Lステップから外部に「LINE上の動き」を通知する仕組み です。
ユーザーがボタンをタップした、メッセージを送った、といった“外側の動き”しか送られません。
一方で、Lステップ内部のデータ（タグ・友だち情報・リマインドの設定など）の取得・操作は API連携側の役割です。
双方向の連携を成立させるためには、Webhook転送（外へ通知）＋ API連携（中のデータにアクセス） の両方が不可欠です。
よくある質問
よくある質問をご紹介します。
Shopifyとの連携も可能ですか？
はい、Shopifyとの連携も可能になります。
Shopify側でソーシャルログインを導入するとLINEログインができるようになるので、そこでUIDを取って、連携します。
お客様の位置情報をもとに近くの店舗をおすすめするといった設定は可能ですか？
LINE公式アカウントの「位置情報」を友だち側から送っていただくと、Make側で取得して、その後の動きの設定が可能です。
※LINE DevelopersのLINE URLスキームも参考にご覧ください。
まとめ
今回は、Lステップの新機能「API連携」でできることや活用例をまとめて解説しました。
API連携については、【Lステップ×AI 外部連携セミナー】（オンライン／参加費無料）でも解説しておりますので、ご興味がある方はこちらへの参加もおすすめです。
