star

Artikel disunting oleh: OOOPEN Lab | 2026-06-03

Cara mengatur login LINE merek agar hasil kuis dapat dicocokkan dengan teman akun resmi

Cara mengatur login LINE merek agar hasil kuis dapat dicocokkan dengan teman akun resmi

Login LINE merek untuk pengaturan baru

Ruang data anggota merek dan login LINE tersedia untuk semua akun tanpa biaya tambahan. Membuat koneksi pengiriman data kegiatan memerlukan paket berbayar yang masih aktif.

Jika menggunakan anggota toko SHOPLINE, ikuti Cara menghubungkan login anggota SHOPLINE dan otomatisasi kampanye. SHOPLINE terhubung melalui instalasi pedagang, bukan melalui langkah pengaturan LINE Channel di bawah.

Siapkan Channel dan callback login merek

Gunakan LINE Login Channel milik Anda sendiri, bukan Messaging API Channel. LINE Login Channel dan Messaging API Channel akun resmi harus berada dalam Provider LINE Developers yang sama agar LINE userId dapat dicocokkan. Login LINE bawaan memakai Channel OOOPEN Lab dan tidak menyediakan ID teman akun resmi Anda.

  1. Pada LINE Developers Console, pilih atau buat LINE Login Channel di bawah Provider yang sama.
  2. Siapkan Channel ID dan Channel secret. Koneksi login merek hanya memakai cakupan profile dan openid. Masukkan secret hanya pada kolom aman OOOPEN Lab.
  3. Buka Pengaturan persyaratan login proyek. Pada Gunakan login anggota merek, salin URL callback OAuth dan daftarkan sebagai Callback URL LINE Login. Callback ini digunakan bersama dalam lingkungan saat ini. Jangan membuat sendiri callback per proyek /auth/{quizId}/callback untuk koneksi login merek ini.

Buat ruang, hubungkan proyek, dan uji login

  1. Buat Ruang data anggota dalam pengaturan akun. Gunakan ruang terpisah untuk setiap merek atau klien.
  2. Pilih ruang itu pada proyek. Jika belum memiliki koneksi, formulir Buat koneksi login muncul. Jika koneksi sudah ada, buka Kelola ruang data anggota dan koneksi login. Pilih LINE pada Protokol login, isi ID klien dengan Channel ID dan Rahasia klien dengan Channel secret. Nama koneksi login adalah nama pengelolaan, bukan nilai untuk verifikasi login.
  3. Tekan Buat dan hubungkan ke proyek ini. Untuk menggunakan identitas yang sama pada proyek lain, pilih ruang dan koneksi yang sama, lalu tekan Izinkan proyek ini. Jangan membuat koneksi baru untuk setiap proyek.
  4. Tekan Uji login saat ini dan login dengan akun uji LINE. Jika browser memblokir jendela uji, simpan perubahan yang perlu dipertahankan, lalu gunakan Uji login di jendela ini.

Periksa identitas dan pengiriman data secara terpisah

Login LINE tidak berarti pemain sudah berteman dengan akun resmi atau hasil kuis telah ditulis ke daftar teman maupun CRM. Alur login merek ini tidak mengambil email. Jangan memakai nama tampilan untuk mencocokkan identitas.

Untuk mengirim data ke sistem sendiri, buat pengiriman data kegiatan di bagian Pengembang pada pengaturan akun. Pilih ruang data anggota yang sama, proyek, dan peristiwa. Ikuti panduan Webhook untuk format, tanda tangan, pencocokan ID, dan deduplikasi.

Setelah login dan penyelesaian jawaban, peristiwa finish dapat diterima sesuai pengaturan. Cocokkan proyek serta respons melalui payload.quizId dan payload.answerId, lalu periksa payload.result dan payload.answers jika tersedia. Hasil adalah kode, bukan nama hasil yang ditampilkan kepada pemain. brandMemberId tidak selalu tersedia. Jangan menganggap externalUserId sebagai LINE userId. Menerima peristiwa atau membalas HTTP 200 tidak berarti sistem merek sudah memberi tag, kupon, atau memperbarui data anggota.

Uji dengan anggota yang sama pada proyek A dan B, menggunakan ruang serta koneksi LINE yang sama. Pastikan login berhasil pada kedua proyek. Jika pengiriman data diaktifkan, periksa juga peristiwa pada penerima. Untuk ID yang berbeda, periksa Provider. Jika proyek B tidak mengenali anggota, periksa ruang dan koneksinya. Jika login gagal, periksa callback, Channel ID, Channel secret, serta izin Channel.

Referensi pengaturan Custom OAuth lama yang sudah ada

Bagian berikut hanya menjelaskan konfigurasi Custom OAuth lama per kuis yang sudah digunakan. Untuk pengaturan baru, ikuti login LINE merek di atas. Callback per kuis, cakupan email, kolom URL, dan contoh data.oauthUser berikut bukan pengaturan untuk koneksi login merek baru. Jangan mencampurkan kedua alur. Pertahankan pengaturan lama sampai kebutuhan peningkatannya dipastikan.

Apakah Anda mengelola akun resmi LINE dan ingin mencocokkan respons kuis dengan orang yang sama dalam data teman LINE? Login OAuth kustom OOOPEN Lab dapat menghubungkan LINE Login Channel milik Anda sendiri. Setelah pemain masuk dan menyelesaikan kuis, Webhook respons dapat membawa namespace LINE userId yang sama dengan Messaging API Channel yang terhubung ke akun resmi tersebut.

Panduan ini mengasumsikan Anda sudah memahami pengaturan dasar OAuth dan Webhook OOOPEN Lab. Fokusnya adalah persyaratan khusus LINE.

Daftar isi

Mengapa login LINE bawaan belum cukup

OOOPEN Lab menyediakan dua jalur login LINE yang berbeda. Pengenal yang dihasilkan tidak dapat saling dipertukarkan.

Pilihan editorLINE Channel yang digunakanPengenal yang diterima
Login sosial bawaan dengan LINE diaktifkanLINE Login Channel bersama milik OOOPEN LabLINE userId yang valid dalam namespace Channel OOOPEN Lab; nilainya tidak cocok dengan ID teman akun resmi Anda
Login OAuth kustomLINE Login Channel yang dibuat di bawah Provider LINE Developers Anda sendiriNamespace userId yang sama dengan Messaging API Channel di bawah Provider tersebut

Jika CRM atau otomasi pemasaran perlu mengenali “responden ini adalah teman LINE ini”, gunakan OAuth kustom dan penuhi semua prasyarat berikut:

  • Akun OOOPEN Lab Anda memiliki akses ke Login OAuth kustom. Ketersediaannya bergantung pada paket dan fitur tambahan saat ini.
  • Anda memiliki atau dapat membuat LINE Login Channel. Ini berbeda dari Messaging API Channel.
  • Yang terpenting, LINE Login Channel dan Messaging API Channel akun resmi harus berada di bawah Provider LINE Developers yang sama. ID pengguna LINE berlaku dalam lingkup Provider; ID dari Provider berbeda tidak dapat dicocokkan.

Langkah 1: atur Channel di LINE Developers

1.1 Buat atau pilih LINE Login Channel

Buka LINE Developers Console. Pilih Provider yang sudah memuat Messaging API Channel akun resmi LINE Anda. Buat Channel baru dan pilih LINE Login, atau gunakan LINE Login Channel yang sudah ada di bawah Provider yang sama.

1.2 Salin Channel ID dan secret

Pada Basic settings Channel, cari:

  • Channel ID — bukan rahasia;
  • Channel secret — rahasia.

Keduanya digunakan dalam editor OOOPEN Lab. Simpan secret hanya pada sistem yang disetujui dan jangan pernah menempelkannya pada issue publik, tangkapan layar, atau halaman sisi klien.

1.3 Daftarkan URL callback

Pada LINE Login → Callback URL, daftarkan callback setiap kuis:

https://ooopenlab.cc/auth/{QUIZ_ID}/callback

{QUIZ_ID} adalah pengenal pada URL editor kuis. Cara paling aman adalah membuka Pengaturan persyaratan login dalam editor kuis dan menyalin redirect_uri sebenarnya yang ditampilkan di bawah URL login OAuth. Tambahkan nilai persis tersebut ke LINE Developers.

1.4 Opsional: minta izin email

LINE tidak mengembalikan alamat email secara bawaan. Jika integrasi benar-benar membutuhkannya:

  1. Ajukan Email address permission untuk Channel dan tunggu persetujuan.
  2. Tambahkan email pada scope OAuth di langkah 2.2.
  3. Jelaskan alasan pengumpulan email dan tangani kemungkinan email tidak tersedia meskipun sudah diminta.

1.5 Publikasikan Channel

Akun LINE Anda sendiri dapat ditambahkan sebagai penguji selama integrasi masih dikembangkan. Ubah Channel menjadi Published sebelum kampanye sebenarnya dimulai.

Langkah 2: atur OOOPEN Lab

Buka editor kuis, masuk ke Pengaturan persyaratan login, aktifkan Login OAuth kustom, lalu lengkapi kolom berikut.

2.1 Kolom tampilan

KolomNilaiContoh
Nama platform AndaDitampilkan pada tombol “Masuk dengan XXX”LINE
Warna tombol loginWarna HEX yang valid#06C755

2.2 URL login OAuth

Gunakan endpoint otorisasi LINE dengan Channel ID dan scope yang diperlukan. Jangan menambahkan redirect_uri atau state; OOOPEN Lab menambahkannya secara otomatis.

https://access.line.me/oauth2/v2.1/authorize?response_type=code&client_id={YOUR_CHANNEL_ID}&scope=profile%20openid

Perubahan opsional:

  • Untuk meminta email setelah persetujuan LINE, gunakan scope=profile%20openid%20email.
  • Untuk mengajak pemain menambahkan akun resmi, tambahkan &bot_prompt=normal. LINE Login Channel dan Messaging API Channel akun resmi harus ditautkan di bawah Provider yang sama.

2.3 Grant Type

Pilih Authorization Code (?code='{code}'). Jangan gunakan Implicit Flow untuk pengaturan LINE ini.

2.4 URL penukaran token

Gunakan endpoint token LINE dan masukkan Channel ID serta secret Anda sendiri:

https://api.line.me/oauth2/v2.1/token?grant_type=authorization_code&client_id={YOUR_CHANNEL_ID}&client_secret={YOUR_CHANNEL_SECRET}

Channel secret disimpan dalam konfigurasi backend terlindungi milik kuis ini agar server dapat menukarkan kode otorisasi. Dengan memasukkannya, Anda mengizinkan OOOPEN Lab menyimpan secret tersebut. Jika Channel digunakan bersama sistem lain atau persyaratan keamanan Anda lebih ketat, buat LINE Login Channel khusus OOOPEN Lab di bawah Provider yang sama.

2.5 Metode pengambilan data pengguna

Pilih OpenID Connect dan masukkan URL OpenID Connect (OIDC) berikut:

https://api.line.me/oauth2/v2.1/verify?client_id={YOUR_CHANNEL_ID}

OOOPEN Lab mengirim id_token ke endpoint verifikasi dan membaca payload terverifikasi:

  • sub → LINE userId dan ID anggota;
  • name → nama tampilan;
  • email → email, hanya jika izin dan scope sama-sama tersedia.

Scope OAuth wajib menyertakan openid; jika tidak, LINE tidak mengembalikan id_token dan login gagal. Simpan pengaturan sebelum pengujian.

Langkah 3: verifikasi LINE userId

Dengan konfigurasi ini, ID anggota yang ditampilkan pada pengelolaan respons, ekspor CSV, dan data Webhook adalah LINE userId mentah, misalnya U1234567890abcdef.... Nilainya harus sama persis dengan userId yang dikirim Messaging API untuk teman yang sama, tanpa menambah atau menghapus awalan.

Kecocokan ini bergantung pada Provider yang sama. Jika mengganti Channel ke Provider lain, pengguna LINE yang masuk kembali mendapat ID dari namespace berbeda dan tidak dapat dicocokkan dengan catatan lama.

Login sosial LINE bawaan mungkin juga menampilkan nilai berawalan U, tetapi nilai itu milik Provider OOOPEN Lab sehingga tidak cocok dengan ID teman akun resmi Anda.

Langkah 4: periksa data Webhook

Setelah pemain menyelesaikan kuis, OOOPEN Lab mengirim peristiwa yang dikonfigurasi ke URL Webhook Anda. Jika OAuth diaktifkan, data anggota terdapat pada data.oauthUser.

{
  "type": "finish",
  "timestamp": "2026-06-01T12:34:56.789Z",
  "data": {
    "answerId": "answer-123",
    "quizId": "quiz-123",
    "quizName": "Personality Type Quiz",
    "startedAt": "2026-06-01T12:30:00.000Z",
    "finishedAt": "2026-06-01T12:34:56.000Z",
    "duration": 296000,
    "result": {
      "id": "result-a",
      "label": "Analytical Explorer"
    },
    "oauthUser": {
      "id": "U1234567890abcdef...",
      "email": "[email protected]",
      "provider": "custom"
    },
    "answers": [
      { "id": "q1", "title": "Question 1", "value": "Choice A", "duration": 1234 }
    ]
  }
}

Gunakan data.oauthUser.id sebagai pengenal LINE:

const lineUserId = payload.data.oauthUser.id;
// Compare this exact value with your official-account friend records.
// It may also be used in an authorized Messaging API request such as
// GET /v2/bot/profile/{userId}.

Webhook Anda harus mengautentikasi permintaan sesuai rancangan integrasi, memvalidasi payload, menangani pengiriman ulang dengan aman, dan menghindari pencatatan secret atau data pribadi yang tidak diperlukan.

Pengujian menyeluruh

Jalankan pengujian ini sebelum publikasi:

  1. Simpan pengaturan dan buka kuis dalam jendela privat.
  2. Pilih Masuk dengan {Nama platform Anda}. Pop-up seharusnya menuju access.line.me.
  3. Selesaikan login LINE. Pop-up seharusnya tertutup dan jendela awal melanjutkan ke kuis.
  4. Selesaikan kuis dan cari respons dalam pengelolaan respons OOOPEN Lab. Pastikan ID anggota berupa nilai LINE U....
  5. Pastikan server Webhook menerima POST penyelesaian dan data.oauthUser.id memuat nilai yang sama.
  6. Bandingkan dengan log Webhook Messaging API akun resmi atau permintaan GET /v2/bot/profile/{userId} yang terotorisasi. Nilainya harus menunjuk orang yang sama.
  7. Ulangi dengan kegagalan login dan pengiriman ulang Webhook untuk memastikan integrasi gagal dengan aman serta tidak menduplikasi pekerjaan lanjutan.

Pemecahan masalah dan tanya jawab

Pop-up menyatakan terjadi kesalahan saat login

Periksa konsol browser dan kesalahan yang dikembalikan ke jendela awal.

Kata kunci kesalahanKemungkinan penyebabPerbaikan
invalid redirect_uriCallback persis belum didaftarkan pada LINE Login ChannelSalin redirect_uri di bawah URL login OAuth dan tambahkan ke LINE Login → Callback URL
invalid_client atau invalid_requestChannel ID atau secret salahSalin kembali nilainya dari Basic settings
state_not_found atau invalid_stateStatus login kedaluwarsa atau cookie yang diperlukan diblokirSegera coba kembali dalam jendela browser biasa dan periksa pengaturan privasi browser
uerid_not_foundToken terverifikasi tidak memiliki sub, biasanya karena openid tidak disertakan atau URL OIDC salahSertakan openid dan gunakan URL verifikasi LINE di atas

Bagaimana cara menerima email?

Ajukan izin email LINE dan, setelah disetujui, gunakan profile%20openid%20email sebagai scope. Integrasi tetap harus menangani email yang tidak tersedia.

Bisakah satu LINE Login Channel digunakan untuk beberapa kuis?

Bisa. Daftarkan URL callback setiap kuis pada Channel dan konfigurasikan Channel ID serta secret yang sama secara terpisah pada setiap kuis.

Bagaimana cara menggabungkan catatan lintas kuis?

Gunakan LINE Login Channel yang sama pada setiap kuis. Pemain yang sama akan memiliki data.oauthUser.id yang sama dalam Webhook kuis tersebut. Backend Anda yang terotorisasi dapat menggunakan nilai ini sebagai kunci lintas kuis.

Apa yang terjadi jika Channel diganti?

Perbarui Channel ID dan secret pada URL login OAuth, URL penukaran token, serta URL OIDC. Respons lama tidak berubah. Pindah ke Channel di bawah Provider lain menghasilkan namespace userId berbeda, sehingga login baru tidak dapat dicocokkan dengan ID teman lama.

Sumber terkait


Anda mungkin juga menyukai…

  • Cara menghubungkan login anggota SHOPLINE dan otomatisasi kampanye
    Cara menghubungkan login anggota SHOPLINE dan otomatisasi kampanye
    Lihat selengkapnya
  • Atur pengiriman data kegiatan merek
    Atur pengiriman data kegiatan merek
    Lihat selengkapnya
  • Tes psikologi, multifaktor, atau berbasis skor? Panduan lengkap pemetaan hasil
    Tes psikologi, multifaktor, atau berbasis skor? Panduan lengkap pemetaan hasil
    Lihat selengkapnya

Buat komunikasi merek lebih seru

BerandaTentang OOOPEN LabTentangKetentuan layanan dan kebijakan privasiPengungkapan transmisi eksternalLaporkan penyalahgunaan

Copyright © 2026 OOOPEN Lab