# 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](https://manager.line.biz)). 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](https://manager.line.biz) (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](https://developers.line.biz/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: \"**. 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](https://manager.line.biz), 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.