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.
- Pada LINE Developers Console, pilih atau buat LINE Login Channel di bawah Provider yang sama.
- Siapkan Channel ID dan Channel secret. Koneksi login merek hanya memakai cakupan
profiledanopenid. Masukkan secret hanya pada kolom aman OOOPEN Lab. - 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}/callbackuntuk koneksi login merek ini.
Buat ruang, hubungkan proyek, dan uji login
- Buat Ruang data anggota dalam pengaturan akun. Gunakan ruang terpisah untuk setiap merek atau klien.
- 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.
- 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.
- 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
- Langkah 1: atur Channel di LINE Developers
- Langkah 2: atur OOOPEN Lab
- Langkah 3: verifikasi LINE userId
- Langkah 4: periksa data Webhook
- Pengujian menyeluruh
- Pemecahan masalah dan tanya jawab
Mengapa login LINE bawaan belum cukup
OOOPEN Lab menyediakan dua jalur login LINE yang berbeda. Pengenal yang dihasilkan tidak dapat saling dipertukarkan.
| Pilihan editor | LINE Channel yang digunakan | Pengenal yang diterima |
|---|---|---|
| Login sosial bawaan dengan LINE diaktifkan | LINE Login Channel bersama milik OOOPEN Lab | LINE userId yang valid dalam namespace Channel OOOPEN Lab; nilainya tidak cocok dengan ID teman akun resmi Anda |
| Login OAuth kustom | LINE Login Channel yang dibuat di bawah Provider LINE Developers Anda sendiri | Namespace 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:
- Ajukan Email address permission untuk Channel dan tunggu persetujuan.
- Tambahkan
emailpada scope OAuth di langkah 2.2. - 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
| Kolom | Nilai | Contoh |
|---|---|---|
| Nama platform Anda | Ditampilkan pada tombol “Masuk dengan XXX” | LINE |
| Warna tombol login | Warna 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:
- Simpan pengaturan dan buka kuis dalam jendela privat.
- Pilih Masuk dengan {Nama platform Anda}. Pop-up seharusnya menuju
access.line.me. - Selesaikan login LINE. Pop-up seharusnya tertutup dan jendela awal melanjutkan ke kuis.
- Selesaikan kuis dan cari respons dalam pengelolaan respons OOOPEN Lab. Pastikan ID anggota berupa nilai LINE
U.... - Pastikan server Webhook menerima POST penyelesaian dan
data.oauthUser.idmemuat nilai yang sama. - Bandingkan dengan log Webhook Messaging API akun resmi atau permintaan
GET /v2/bot/profile/{userId}yang terotorisasi. Nilainya harus menunjuk orang yang sama. - 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 kesalahan | Kemungkinan penyebab | Perbaikan |
|---|---|---|
invalid redirect_uri | Callback persis belum didaftarkan pada LINE Login Channel | Salin redirect_uri di bawah URL login OAuth dan tambahkan ke LINE Login → Callback URL |
invalid_client atau invalid_request | Channel ID atau secret salah | Salin kembali nilainya dari Basic settings |
state_not_found atau invalid_state | Status login kedaluwarsa atau cookie yang diperlukan diblokir | Segera coba kembali dalam jendela browser biasa dan periksa pengaturan privasi browser |
uerid_not_found | Token terverifikasi tidak memiliki sub, biasanya karena openid tidak disertakan atau URL OIDC salah | Sertakan 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.