API連携・Webhook転送とは

API連携・Webhook転送とは、エルメのデータを外部のCRMや業務システムと連携できるようにする機能です。

これまでエルメの友だち情報やタグは、エルメの管理画面の中で完結して扱うものでした。この2つの機能を使うことで、社内で使っている顧客管理システム（CRM）・予約システム・会計システムなどとデータを行き来させ、LINE上の顧客情報と社内の顧客情報を一元管理できるようになります。

2つの機能は、どちらも「外部システムとの連携」ですが、データが流れる向きが逆になります。

・API連携：外部システムからエルメを操作する（外部システム → エルメ）
・Webhook転送：LINE公式アカウント・エルメで起きたことを外部システムに知らせる（LINE公式アカウント・エルメ → 外部システム）

項目	API連携	Webhook転送
データの向き	外部システム → エルメ	LINE公式アカウント・エルメ → 外部システム
動作のきっかけ	外部システムが必要なときにリクエストする	LINE公式アカウント・エルメ側でイベントが発生した瞬間に自動送信される
主な用途	タグ付与・友だち情報の更新・メッセージ送信・シナリオ操作	友だち追加・メッセージ受信・アクション実施・フォーム回答・予約・決済の即時通知

今後のアップデート予定

API連携・Webhook転送は、フェーズを分けて段階的にリリースを予定しています。

・フェーズ 1：メッセージ送信、タグ・友だち情報・シナリオの操作、チャット状態の変更、LINE公式アカウントの通知転送
・フェーズ 2：回答フォーム・サロン予約／レッスン予約に関する通知、対応ステータスの追加変更
・フェーズ 3：決済（申し込み・申し込み失敗・キャンセル）に関する通知

「LINE公式アカウントの通知転送」と「エルメ独自イベントの通知」は別の設定です。LINE公式アカウントに届いた通知をそのまま流したい場合は前者、エルメの機能で起きた出来事を受け取りたい場合は後者を使います。

API連携でできること

API連携は、外部システムからエルメへリクエストを送り、エルメを操作する機能です。操作した結果は、エルメからLINE公式アカウントを経由して友だちへ届きます。

外部システムが直接LINEへ送信するのではなく、エルメがLINE公式アカウントとのやり取りを担う形です。そのため、API経由で送ったメッセージもエルメの配信履歴に記録が残ります。

外部システムからエルメを操作できる機能の一覧は以下のとおりです。

機能	できること	提供時期
メッセージ送信	テキスト／画像／テンプレートを友だちへ送信	フェーズ 1
アクション発火	タグ操作（付ける／外す）	フェーズ 1
	友だち情報操作（登録／更新／削除）	フェーズ 1
	シナリオ操作（開始／停止）	フェーズ 1
タグ管理	登録一覧の取得	フェーズ 1
	各タグが付いている友だち一覧の取得	フェーズ 1
友だち情報管理	登録一覧の取得	フェーズ 1
	各友だち情報の登録値と、対象の友だち一覧の取得	フェーズ 1
テンプレート	登録一覧の取得	フェーズ 1
チャット状態	対応ステータス／ブックマーク／非表示	フェーズ 1
	確認／未確認の切り替え	フェーズ 1
	対応ステータスの追加・変更	フェーズ 2

⚠️テンプレートの新規作成は、API連携の対象外です。テンプレートはエルメの管理画面で作成し、APIからは一覧取得と送信に利用する形になります。

友だちの情報をまとめて取得できること

API連携は、エルメを操作するだけでなく、エルメに蓄積された友だちの情報を外部システム側から取得することにも使えます。CRMを新しく導入するときに、これまでLINEでやり取りしてきた友だちの情報をまとめて取り込みたい、といった場合に活用できます。

取得できるもの	主な使いどころ	提供時期
友だちの一覧	CRM導入時に既存の友だちをまとめて取り込む／日々の増減を定期的に反映する	フェーズ 1
1人の友だちの詳細（プロフィール・タグ・友だち情報・購読中のシナリオ）	特定の友だちの最新状況をCRM側の画面にも表示する	フェーズ 1
友だちとのチャットの一覧（未確認・対応ステータス・タグなどで絞り込み可能）	返信待ちのチャットだけを条件で絞り込んでCRM側から検索する	フェーズ 1
友だちとの直近のトーク履歴	問い合わせ対応の際に、これまでのやり取りの流れをCRM側でも確認する	フェーズ 1

⚠️取得した情報の一次情報は、あくまでエルメの管理画面です。取得した情報をもとにCRM側で判断した結果は、上記の「アクション発火」（タグ操作・友だち情報操作・シナリオ操作）でエルメ側へ書き戻すことで、LINE公式アカウント・エルメ・CRMを同じ状態に保てます。

API連携の設定方法

API連携の設定は以下の方法で行います。

APIキーの設定方法

①画面右上のアイコンをクリック
②「マイページ」をクリック

③画面左メニューの「API連携」をクリック

④画面右上の「APIキーを発行」をクリック

⑤「キー名」を入力
⑥「権限」を選択
・全権限：友だち情報・配信・タグなどの参照に加えて、作成・更新・削除も行えます。
・読み取り専用：友だち情報や配信実績などの参照のみ行えます。データの更新はできません。
⑦「有効期限」を選択
※「1日」「1週間」「30日」「無期限」から選択できます。
⑧「発行する」をクリック

⑨APIキー発行画面が表示されるので、「APIキー」をコピー

発行したAPIキーを利用して、外部システムと連携を行ってください。

APIキー画面で確認できること

APIキー画面では以下の確認ができます。

①ステータス：APIキーの有効、無効(期限切れ)が確認できます。
②キー名：各APIキーの管理名が表示されます。
③APIキー：APIキーが確認できます。目のアイコンをクリックするとマスキングが解除されます。コピーアイコンをクリックすると、APIキーをコピーできます。
④権限：各APIキーの権限が確認できます。
⑤発行者：APIキーを発行したユーザーが確認できます。
⑥有効期限：APIキーの有効期限が確認できます。
⑦最終利用：該当のAPIキーで最後にAPIが呼び出された日時が表示されます。
⑧操作：削除アイコンをクリックすると、APIキーの削除ができます。
⑨検索ボックス：APIキーの名前を入力して検索ができます。
⑩ステータス絞り込み：「すべてのステータス」「有効」「無効(期限切れ)」の各ステータスでAPIキーを絞り込めます。
⑪操作履歴：操作履歴を確認できます。

Webhook転送でできること

Webhook転送には、「LINE公式アカウントの通知転送」と「エルメ独自イベントの通知」の2種類があります。

転送のタイミングと設定の考え方

「LINE公式アカウントの通知転送」と「エルメ独自イベントの通知」は、それぞれ独立した機能です。どちらか一方だけを使うことも、両方を別々の送信先URLで使うこともでき、一方のオン/オフや設定を変更しても、もう一方には影響しません。

イベントが発生してから転送先に届くまでの時間は、ほぼリアルタイム（数秒程度）です。画像・動画・音声を含むメッセージも転送の対象になりますが、送られるのはファイルそのものではなく、ファイルを特定するための情報のみです。

⚠️転送機能をオンにした時点より前に発生していたイベントは、さかのぼって送信されません。過去のデータが必要な場合は、Webhook転送ではなく、上記「API連携でできること」でご紹介した友だち情報の取得機能をご利用ください。

LINE公式アカウントの通知転送の流れ

エルメとLINE公式アカウントを接続すると、LINEから送られるWebhookはエルメが受け取る形になります。そのため、外部システムでLINE公式アカウントの通知を利用したい場合は、エルメを経由して転送する必要があります。この役割を担うのが「LINE Webhook転送」です。

友だちの発言や友だち追加などのイベントは、以下の流れで外部システムに届きます。

エルメは受け取ったWebhookを加工せず、そのまま転送先へ送信します。エルメの自動応答やシナリオ配信はこれまでどおり動作するため、既存の運用を変えずに外部システムを追加できます。

1対1トークやグループトークで発生する主なWebhookイベントは以下のとおりです。

イベント	発生するタイミング
メッセージイベント	友だちがメッセージを送信したとき（このイベントには応答できます）
フォローイベント	LINE公式アカウントが友だち追加、またはブロック解除されたとき
フォロー解除イベント	LINE公式アカウントがブロックされたとき
参加イベント	LINE公式アカウントがグループトーク・複数人トークに参加したとき
退出イベント	グループトークからLINE公式アカウントが削除されたとき
メンバー参加イベント	LINE公式アカウントが参加しているグループに、ユーザーが参加したとき
メンバー退出イベント	LINE公式アカウントが参加しているグループから、ユーザーが退出したとき
ポストバックイベント	ユーザーがポストバックアクションを実行したとき

各イベントの詳細な仕様や、上記以外のイベントについては、LINE Developers「Webhookでメッセージやイベントを受け取る」をご確認ください。

エルメ独自イベントの通知（フェーズ 1〜3）

エルメの機能の中で発生した出来事を、外部システムへ通知します。LINEの標準Webhookでは取得できない、エルメならではの情報を扱えるのが特長です。

機能	通知されるタイミング	提供時期
アクション実施	友だち情報操作が行われたとき	フェーズ 1
	タグ操作が行われたとき	フェーズ 1
回答フォーム	フォームが回答されたとき	フェーズ 2
サロン予約／レッスン予約	予約受付時	フェーズ 2
	予約リクエスト受付時	フェーズ 2
	予約リクエスト承認時	フェーズ 2
	予約変更時	フェーズ 2
	予約変更リクエスト受付時	フェーズ 2
	予約変更リクエスト承認時	フェーズ 2
	予約キャンセル時	フェーズ 2
	キャンセルリクエスト受付時	フェーズ 2
	キャンセルリクエスト承認時	フェーズ 2
決済（商品販売）	申し込み時	フェーズ 3
	申し込み失敗時	フェーズ 3
	キャンセル時	フェーズ 3

Webhook転送の設定方法

Webhook転送の設定は以下の方法で行います。

Webhook転送画面への遷移

①画面右上のアイコンをクリック
②「マイページ」をクリック

③画面左メニューの「Webhook転送」をクリック

LINE公式アカウントの通知転送設定を行う

メッセージ受信、友だち追加など、LINE公式アカウント側で受信したイベントを外部ツールへ転送する設定を行います。
※エルメ独自のイベントのみを外部ツールへ転送する場合は設定不要です。

①「LINE公式アカウントデータ転送」を選択
②「転送先URL」を入力
③「転送の状態」を「転送中」に変更
④「保存する」をクリック

上記手順でLINE公式アカウント側で受信したイベントが外部ツールへ転送されます。

エルメ独自イベントの通知転送設定を行う

フォーム回答など、エルメ内で発生したイベントを外部ツールへ転送する設定を行います。
※LINE公式アカウントが受信したイベントのみを外部ツールへ転送する場合は設定不要です。

①「L Messageデータ転送」を選択
②「転送先URL」を入力
③「転送の状態」を「転送中」に変更
④「保存する」をクリック

上記手順でエルメ内で発生したイベントが外部ツールへ転送されます。

※「署名シークレット」について
外部システム側が「このリクエストは本当にエルメから届いたものか」を確認するために使うパスワードのようなものです。外部ツール側でこの値を検証すると、エルメからの送信であることを確認できます。
「再生成」ボタンをクリックすることで、新しい「署名シークレット」が生成できます。

転送エラー

各イベントの「転送エラー」で、転送に失敗したデータを確認できます。

⚠️転送に失敗した場合は自動で最大3回まで再送を試みます。3回とも失敗したものだけ「転送エラー」に記録されます。表示は直近100件までです。これより古いエラーは表示されません。成功した送信は記録していません。

活用事例

API連携とWebhook転送を組み合わせることで、CRMをはじめとした外部システムとの連携が可能になります。ここでは代表的な3つの事例を紹介します。

事例1：CRMとの顧客データ双方向連携

起点になるのは、LINE公式アカウントで発生する友だち追加やブロックのイベントです。これらはLINEからエルメへWebhookとして届き、さらにWebhook転送でCRMへ流すことで、新規の友だちをCRMに自動登録できます。

逆方向として、CRMに蓄積された会員ランクや購入履歴を、API連携でエルメの友だち情報・タグへ書き込みます。両方向をつなぐことで、LINE公式アカウント・エルメ・CRMの3つが常に同じ顧客像を持てるようになります。

この事例で使う機能
・LINE Webhook転送：フォローイベント（友だち追加・ブロック解除）、フォロー解除イベント
・Webhook転送：アクション実施（タグ操作・友だち情報操作）
・API連携：タグ操作（付ける／外す）、友だち情報操作（登録／更新／削除）

たとえばCRM側で「ゴールド会員」に昇格した顧客に、エルメ側で自動的に「ゴールド」タグを付与。そのタグ付与をきっかけにシナリオを開始し、LINE公式アカウントから会員限定の案内を配信する、といった運用ができます。

事例2：予約情報を店舗管理システムへリアルタイム連携

友だちはLINE公式アカウントのリッチメニューや配信メッセージから予約ページへ進み、エルメのサロン予約・レッスン予約で予約を申し込みます。受け付けた内容は、Webhook転送で店舗管理システムやCRMへ即時に送られます。

予約の受付だけでなく、変更やキャンセルまで通知されるため、外部システム側の予約台帳を常に最新の状態に保てます。予約確認のメッセージは、エルメからLINE公式アカウントを経由して友だちへ届きます。

この事例で使う機能
・Webhook転送：サロン予約／レッスン予約（予約受付時・予約変更時・予約キャンセル時・各リクエストの受付／承認時）
・API連携：メッセージ送信（予約確認メッセージをLINE公式アカウント経由で配信）

予約のリクエスト受付時と承認時が別々に通知されるため、「仮予約が入った段階でスタッフに知らせる」「承認された時点で正式な予約として台帳に登録する」といった、承認フローを含む運用にも対応できます。

事例3：決済データをCRM・会計システムへ連携し、フォロー配信まで自動化

エルメの商品販売で発生した申し込み・申し込み失敗・キャンセルを、Webhook転送でCRMや会計システムへ送ります。さらに外部システム側の処理結果をAPI連携でエルメへ書き戻すことで、購入後のフォロー配信までを一続きの流れとして自動化できます。

最後のフォロー配信は、エルメからLINE公式アカウントを経由して友だちへ届きます。外部システムが直接LINEへ送信するのではなく、エルメがLINE公式アカウントとのやり取りを担う形です。

この事例で使う機能
・Webhook転送：決済（申し込み時・申し込み失敗時・キャンセル時）
・API連携：タグ操作、シナリオ操作（開始／停止）、メッセージ送信（LINE公式アカウント経由で配信）

申し込み失敗の通知を受け取れるため、決済エラーになった顧客だけを抽出して再案内のメッセージを送る、といったフォローも可能になります。キャンセル時には購入者タグを外し、進行中のシナリオを停止する運用も組めます。

注意点

⚠️エルメAPIの取り扱いにご注意ください
エルメAPIは、エルメのデータを操作できる重要な情報です。第三者への共有や、公開されるソースコードへの記述は避けてください。漏洩が疑われる場合は、設定画面の再発行ボタンから速やかに再発行してください。

⚠️LINE公式アカウントのWebhook設定はエルメが受け取ります
エルメと接続したLINE公式アカウントのWebhookはエルメが受信します。外部システムのURLをLINE側に直接設定するとエルメが正常に動作しなくなるため、必ず「LINE Webhook転送」を使ってエルメ経由で転送してください。

⚠️外部システム側の開発が必要です
API連携・Webhook転送を利用するには、外部システム側でリクエストを送る処理や、Webhookを受け取るエンドポイントを用意する必要があります。導入時は、社内の開発担当者や外部の開発会社にご相談ください。

⚠️API連携・Webhook転送の技術的な仕様については、下記リファレンスをご確認ください。
L Message（エルメ）API/Webhook リファレンス

⚠️AI（Claude等）を使って開発を行う際の注意点
本記事の内容をもとにClaudeなどのAIツールへAPI連携・Webhook設定の実装を依頼すると、「セーフガードがこのメッセージを検出しました」といった確認画面が表示されることがあります。これはエルメ側の不具合ではなく、AIツール側が「APIキー」「署名」「認証」などの単語を含む会話を、安全のため広めに検知する仕組みによるものです。正当な開発作業であれば、表示された選択肢（モデルの切り替え・続行など）を選んでそのまま作業を続けていただいて問題ありません。

⚠️提供時期・仕様は変更となる場合があります
本記事で紹介している機能は、フェーズ 1からフェーズ 3にかけて段階的にリリースを予定しているものです。項目名や提供時期は開発状況により変更となる場合があります。

⚠️API/Webhook連携機能に関するお問い合わせについては下記フォームよりお願いします。
L Message API/Webhook連携に関するお問い合わせ
※上記フォームは技術的なお問い合わせのみ受け付けております。アクセストークンやAPIキーなどの認証情報は絶対に記載しないでください。また、お客様が開発されたプログラムのコード作成・デバッグ代行はサポート範囲外です。

また、LINE公式アカウント側のWebhook設定については、通信エラー時の取りこぼしを防ぐためにWebhook再送の設定方法もあわせてご確認ください。

API連携とWebhook転送は、エルメを「LINE配信ツール」から「社内の顧客データ基盤とつながるシステム」へと広げる機能です。自社の運用でどのデータを連携したいかを整理したうえで、リリースに合わせてご活用ください。