Your AI Connector Docs

LINE

Hubungkan LINE Official Account Anda sendiri agar percakapan LINE mengalir ke dalam aplikasi dan Agen AI dapat membalasnya. Anda dapat menghubungkannya dengan menempelkan kredensial LINE Messaging API (Channel secret + access token) dan mengatur satu URL webhook — tidak perlu coding.

Apa Itu Integrasi LINE?

Integrasi LINE menghubungkan LINE Official Account (OA) yang Anda miliki ke platform menggunakan Messaging API resmi LINE — sistem milik LINE sendiri untuk mengirim dan menerima pesan secara otomatis, alih-alih Anda mengetiknya secara manual di aplikasi LINE. Obrolan 1-ke-1 Anda dengan orang-orang yang telah menambahkan OA Anda sebagai teman akan tersedia di dalam aplikasi, dan Agen AI, Siaran (Broadcast), serta kotak masuk bersama (shared inbox) dapat bekerja di atasnya.

Berbeda dengan Telegram atau WhatsApp Web, ini adalah integrasi resmi — integrasi ini menggunakan Messaging API milik LINE sendiri, sehingga stabil dan sesuai dengan aturan LINE. Karena LINE tidak memiliki tombol “hubungkan” sekali klik untuk alat pihak ketiga, Anda perlu menempelkan kredensial OA Anda sekali selama pengaturan.

Ketersediaan. LINE Official Account paling umum digunakan di Jepang, Taiwan, Thailand, dan Indonesia, serta tidak tersedia di UE. Anda memerlukan LINE Official Account yang terdaftar di wilayah yang didukung untuk menggunakan saluran ini.

Sebelum Anda Memulai

Anda akan membuat (atau menggunakan) tiga hal di konsol LINE sendiri. Ini adalah pengaturan satu kali yang memakan waktu sekitar 5 menit.

  1. Sebuah LINE Official Account (dibuat di LINE Official Account Manager). Jika Anda belum memilikinya, masuklah dengan LINE Business ID Anda dan buat akun baru — beri nama dan isi formulir singkatnya.
  2. Sebuah Messaging API channel untuk OA tersebut. Cara termudah adalah dengan mengaktifkannya dari dalam OA Manager (lihat Langkah 1 di bawah) — Anda tidak perlu membuat channel secara manual di Developers Console terlebih dahulu. Saat diminta, pilih provider yang sudah ada atau buat yang baru.
  3. Dari channel tersebut, ada tiga nilai yang perlu Anda tempelkan ke dalam aplikasi:
    • Channel ID (tab Basic settings) — opsional, hanya untuk informasi
    • Channel secret (tab Basic settings)
    • Channel access token — token berumur panjang yang Anda terbitkan di tab Messaging API

Tidak ada dokumen bisnis yang diperlukan untuk Official Account standar (tidak terverifikasi) — cukup LINE Business ID. Verifikasi (lencana biru) bersifat opsional dan hanya ditawarkan di beberapa wilayah.

Menyiapkan LINE

Langkah 1: Aktifkan Messaging API untuk Official Account Anda

  1. Masuk ke LINE Official Account Manager (atau buat Official Account baru terlebih dahulu).
  2. Buka OA Anda.
  3. Klik Settings (sudut kanan atas).
  4. Di menu pengaturan, klik Messaging API.
  5. Statusnya dimulai sebagai Disabled — klik untuk mengaktifkannya.
  6. Pilih provider untuk channel ini (perusahaan/pengembang yang memilikinya). Jika Anda belum memilikinya, buat provider baru, lalu konfirmasi.

Langkah 2: Dapatkan Kredensial Anda dari Developers Console

Mengaktifkan Messaging API akan membuat channel di bawah provider Anda di LINE Developers Console.

  1. Buka developer account / provider.
  2. Klik ke dalam Messaging API channel.
  3. Buka tab Basic settings dan salin Channel ID serta Channel secret Anda.
  4. Buka tab Messaging API, terbitkan (atau buat ulang) Channel access token berumur panjang, lalu salin token tersebut.

Simpan nilai-nilai ini — Anda akan menempelkannya ke dalam aplikasi nanti.

Langkah 3: Hubungkan LINE di Aplikasi

  1. Di bilah sisi kiri, klik Settings di dekat bagian bawah.
  2. Di rel kiri Settings, di bawah Channels, klik Channels.
  3. Temukan kartu LINE dan klik Connect.
  4. Secara opsional, tempel Channel ID Anda — hanya untuk informasi.
  5. Tempel Channel secret Anda.
  6. Tempel Channel access token Anda.
  7. Klik Connect.
  8. Aplikasi akan memvalidasi kredensial dengan LINE dan menampilkan “Connected to: <nama OA Anda>”. Jika kredensial salah, Anda akan mendapatkan pesan kesalahan — terbitkan ulang token akses di LINE Developers Console dan coba lagi.

Langkah 4: Atur Webhook URL di LINE

Setelah terhubung, aplikasi akan menampilkan bagian Finish setup in LINE dengan webhook URL — salin URL tersebut. (Webhook URL hanyalah sebuah alamat web; menempelkannya ke LINE memberi tahu LINE ke mana harus mengirim pesan baru secara otomatis.) Kemudian di LINE Developers Console untuk channel Messaging API Anda:

  1. Buka tab Messaging API.
  2. Tempelkan URL ke dalam Webhook URL.
  3. Klik Update.
  4. Ubah Use webhook menjadi ON.

Langkah 5: Perbaiki Pengaturan Official Account Manager (Penting)

Secara default, LINE OA menangani obrolan dan balasan otomatis sendiri, yang mencegah pesan masuk ke AI. Kembali ke LINE Official Account Manager, buka pengaturan OA Anda dan atur:

Pengaturan Nilai yang diperlukan Mengapa
Chat On Mengaktifkan obrolan agar percakapan mengalir (memungkinkan Anda menggunakan filter obrolan).
Response mode Bot Memungkinkan API (Agen AI Anda) menangani pesan. Mode “Chat” saja akan menelan pesan tersebut.
Response hours / Auto-response messages Off Menonaktifkan balasan otomatis LINE agar AI menangani respons (penyebab utama “balasan ganda”).
Greeting messages Off Mencegah pesan sapaan otomatis LINE bersaing dengan AI.
Webhooks On Agar LINE meneruskan pesan ke aplikasi.

Jika aplikasi memberikan peringatan bahwa akun Anda berada dalam Chat mode, ubahlah ke Bot mode di sini — bot tidak dapat menerima atau mengirim pesan sampai Anda melakukannya.

Langkah 6: Uji Bot

  1. Dari ponsel yang berbeda (misalnya aplikasi LINE Anda sendiri), tambahkan Official Account Anda sebagai teman dan kirimkan pesan.
  2. Buka aplikasi dan buka Chats — pesan masuk akan muncul di daftar percakapan.
  3. Jika Agen AI menangani channel ini, Anda akan melihatnya membalas secara otomatis pesan uji tersebut.

Setelah terhubung dengan webhook yang diatur dan tombol-tombol di atas sudah benar, akun LINE Anda akan muncul sebagai Connected di halaman Channels dan AI akan merespons pesan masuk.

Biaya

LINE adalah channel gratis di aplikasi — tidak ada biaya per pesan dan tidak ada biaya koneksi bulanan dari kami. Perhatikan bahwa paket LINE sendiri memiliki batas bulanan untuk pesan push (pengiriman proaktif), yang bervariasi berdasarkan wilayah dan jenis akun. Balasan yang dikirim segera setelah pelanggan mengirim pesan kepada Anda tidak dikenakan biaya di LINE; pengiriman proaktif/siaran akan dihitung terhadap kuota paket LINE Anda.

Pesan Media

Foto, video, catatan suara, file, stiker, dan lokasi yang masuk akan dikenali sehingga AI mengetahui bahwa media telah dikirim (catatan singkat akan ditambahkan ke percakapan). Balasan AI keluar berupa teks dan gambar dalam versi ini. Balasan yang panjang akan dipotong secara otomatis agar sesuai dengan batas 5.000 karakter LINE.

Manajemen Sesi

Memeriksa Status Koneksi

Status koneksi LINE Anda ditampilkan pada kartu LINE di halaman Channels:

Status Arti
Connected Akun Resmi LINE tertaut ke akun ini
Not connected Tidak ada koneksi yang disiapkan

Kartu tersebut juga memeriksa ulang pengaturan Mode chat akun Anda setiap kali Anda membuka halaman Saluran. Jika akun LINE Anda telah dialihkan kembali ke Mode chat (yang menghentikan bot untuk menerima atau mengirim pesan), peringatan berwarna kuning akan muncul pada kartu yang meminta Anda untuk mengalihkannya kembali ke Mode bot di LINE Official Account Manager — periksa kembali tombol pada Langkah 5 di sana dan peringatan tersebut akan hilang pada kunjungan berikutnya.

Memutuskan Koneksi

Buka kartu LINE dan klik Manage, lalu klik Disconnect di panel yang terbuka dan konfirmasi Remove LINE?. Ini akan menghapus koneksi di sisi kami. Untuk sepenuhnya menghentikan LINE mengirimkan peristiwa, nonaktifkan juga Use webhook (atau hapus URL webhook) di LINE Developers Console.

Batasan

  • Satu Official Account per koneksi. Hubungkan setiap OA secara terpisah; satu OA hanya dapat ditautkan ke satu akun.
  • Pengiriman Teks + gambar. AI membalas dengan teks dan gambar; pesan “Flex”/template/carousel yang kaya tidak dikirim dalam versi ini.
  • Wilayah. LINE Official Account tidak tersedia di Uni Eropa; Anda memerlukan OA di wilayah yang didukung (misalnya Jepang, Taiwan, Thailand, Indonesia).
  • Waktu balasan. Balasan instan gratis LINE memiliki jendela waktu yang singkat; pesan yang dikirim setelahnya akan dikirim secara otomatis sebagai pesan push (yang dihitung dalam kuota).

Pemecahan Masalah

Kredensial Ditolak Saat Menghubungkan

  • Pastikan Anda membuat saluran Messaging API (bukan “LINE Login”).
  • Terbitkan ulang long-lived channel access token pada tab Messaging API dan tempelkan nilai yang baru.
  • Pastikan Anda menyalin Channel secret dari tab Basic settings (bukan Channel ID).

Bot Tidak Membalas

  • Pastikan Webhooks dalam posisi On baik di Developers Console maupun OA Manager.
  • Pastikan Webhook URL sesuai dengan yang ditampilkan di aplikasi.
  • Pastikan Response mode diatur ke Bot (bukan Chat) di OA Manager.

Pelanggan Mendapatkan Dua Balasan

  • Matikan Auto-response messages dan Greeting messages di OA Manager — balasan otomatis bawaan LINE terkirim bersamaan dengan AI.

Pesan Tidak Masuk ke Aplikasi

  • Pastikan kontak tersebut telah menambahkan Akun Resmi Anda sebagai teman (LINE hanya mengirimkan pesan dari teman).
  • Periksa kembali URL webhook dan pastikan Use webhook dalam posisi aktif.

Praktik Terbaik

  • Selesaikan pengaturan tombol di OA Manager (mode Bot, Webhooks aktif, Greeting + Auto-reply nonaktif) — sebagian besar masalah pengaturan berasal dari sini.
  • Balas dengan cepat agar balasan tetap berada dalam jendela gratis LINE dan menghemat kuota push Anda.
  • Jaga keamanan access token Anda — siapa pun yang memilikinya dapat mengirim pesan sebagai Akun Resmi Anda. Terbitkan ulang di Developers Console jika token tersebut bocor.