パラメーターエクスポートとは

「パラメーターエクスポート」とは、外部システムとエルメを連携する事が出来る機能です。

外部システムからコールバックURLを発行し、そのURLをエルメに登録することで、LINE公式アカウントに友だち追加が行われた際に、外部システム側へ顧客情報を自動で送信することが出来ます。

こちらの機能を利用するためには、外部システム側でコールバックURLを発行し、そのURLでGETリクエストを受け取れる環境が必要です。
コールバックURLの発行方法や外部システムの設定方法については、ご利用のシステムや環境によって異なるため、サポート対象外となります。

パラメーターエクスポートの利用方法

それでは実際にパラメーターエクスポートの利用方法について解説します。

QRコードアクションの新規作成

①左メニューの「情報管理」にカーソルを合わせ、「QRコードアクション」をクリック

②「新規作成」をクリック

③「管理名」を入力
④稼働対象を選択
⑤「QRコードアクションの新規作成に進む」をクリック

⑥上部のタブから「外部連携」をクリック
⑦左メニューから「パラメーターエクスポート」をクリック
⑧パラメーターエクスポートの「利用する」をクリック

コールバックURLの設定

⑨コールバックURLの設定欄に、外部システムで発行したコールバックURLを入力

⑩画面下部の「保存」をクリック

QRコードアクションURLの取得

⑪画面上部の「QRコード表示」タブをクリック

⑫QRコードアクションURLのコピーボタンをクリック

こちらのQRコードアクションURLを、友だち追加を促したいSNSや各種広告などに設置してください。

そうする事で、QRコードアクションURLから友だちが登録があった際に、友だちの「LINE ID」「友だち追加情報」「LINE登録名」「メールアドレス」といった情報が、コールバックURLに送信されます。

エクスポート可能な情報

パラメーターエクスポート機能では、主に4種類の情報を外部システムに送信する事が出来ます。

基本情報

「LINE ID」「友だち追加情報」「LINE登録名」「メールアドレス」はエルメが外部システムに自動で送信する情報です。
これらの情報は自動で送信されるため、QRコードアクションURLにパラメーターとして記載する必要はございません。

・LINE ID
QRコードアクションURLから登録した友だちのLINE IDです。
（例:U8189cf6745fc0d808977bdb0b9f22995）
・友だち追加情報
登録した友だちの種類です。
（新規友だち：new、既存友だち：old、ブロック解除友だち：block と表示されます。）
・LINE登録名
友だちのLINE登録名です。
・メールアドレス
友だち側が事前にLINEにメールアドレスを登録している場合のみ、メールアドレスがエクスポートされます。

パラメーターエクスポートを利用した場合、エルメがGETアクセス（URLを開いて情報を渡すこと）を行うURLは以下のようになります。

上記のようにパラメーターが付与されたコールバックURLに対して、エルメがGETアクセスを行うことで、外部システム側へ「LINE ID」「友だち追加情報」「LINE登録名」「メールアドレス」の情報が送信されます。

任意のパラメーター

QRコードアクションのURLに任意のパラメーターを付与すれば、友だち追加時にそのパラメーター情報を外部システムへ自動送信する事もできます。

例えば、QRコードアクションURLに対して、上記ようにパラメーターを付与する事で、エルメがGETアクセスを行うコールバックURLは以下のようになります。

上記のURLに対してエルメがGETアクセスを行うことで、「LINE ID」「友だち追加情報」「LINE登録名」「メールアドレス」の情報と一緒にURLに付与したパラメーター情報が外部システムに送信されます。

注意事項

・セキュリティ
コールバックURLが安全であることを確認し（HTTPS の使用推奨）、必要に応じて認証メカニズムを設定してください。

・フォーマット
パラメーターは URL クエリ文字列として送信されます。外部システムが特殊文字の URL エンコーディングを正しく処理できることを確認してください。

・テスト
異なるカスタム URL から実際に友だち追加テストを行い、すべてのパラメーターが正確に送信されることを必ず確認してください。