# LINE LINE konuşmalarınızın uygulamaya akması ve bir Yapay Zeka Temsilcisinin yanıt verebilmesi için kendi **LINE Resmi Hesabınızı** bağlayın. LINE Mesajlaşma API kimlik bilgilerinizi (Kanal gizli anahtarı + erişim belirteci) yapıştırıp bir webhook URL'si ayarlayarak bağlantıyı kurarsınız; kodlama gerekmez. --- ## LINE Entegrasyonu Nedir? LINE entegrasyonu, sahip olduğunuz bir **LINE Resmi Hesabını (OA)**, LINE'ın resmi Mesajlaşma API'sini kullanarak platforma bağlar. Bu, mesajları LINE uygulamasında elle yazmak yerine otomatik olarak gönderip almak için kullanılan LINE'ın kendi sistemidir. OA'nızı arkadaş olarak ekleyen kişilerle yaptığınız birebir sohbetler uygulama içinde kullanılabilir hale gelir ve bir Yapay Zeka Temsilcisi, Yayınlar ve paylaşılan bir gelen kutusu bunlar üzerinde çalışır. Telegram veya WhatsApp Web'den farklı olarak bu **resmi** bir entegrasyondur; LINE'ın kendi Mesajlaşma API'sini kullanır, bu nedenle kararlıdır ve LINE kuralları dahilindedir. LINE'da üçüncü taraf araçlar için tek tıkla "bağlan" düğmesi bulunmadığından, kurulum sırasında OA kimlik bilgilerinizi bir kez yapıştırırsınız. > **Kullanılabilirlik.** LINE Resmi Hesapları en çok Japonya, Tayvan, Tayland ve Endonezya'da yaygındır ve **AB'de kullanılamaz**. Bu kanalı kullanmak için desteklenen bir bölgede kayıtlı bir LINE Resmi Hesabına ihtiyacınız vardır. --- ## Başlamadan Önce LINE'ın kendi konsollarında üç şey oluşturacak (veya kullanacaksınız). Bu, yaklaşık 5 dakikalık tek seferlik bir kurulumdur. 1. Bir **LINE Resmi Hesabı** ([LINE Resmi Hesap Yöneticisi](https://manager.line.biz) üzerinden oluşturulmuş). Henüz bir hesabınız yoksa, LINE İş Kimliğinizle giriş yapın ve **yeni bir hesap oluşturun**; bir ad verin ve kısa formu doldurun. 2. Bu OA için bir **Mesajlaşma API kanalı**. En kolay yol, bunu OA Yöneticisi içinden etkinleştirmektir (aşağıdaki 1. Adıma bakın); kanalı önce Geliştirici Konsolunda elle oluşturmanız gerekmez. İstendiğinde mevcut bir **sağlayıcı** seçin veya yeni bir tane oluşturun. 3. Bu kanaldan, uygulamaya yapıştıracağınız üç değer: - **Kanal Kimliği** (Temel ayarlar sekmesi) — isteğe bağlı, yalnızca bilgilendirme amaçlı - **Kanal gizli anahtarı** (Temel ayarlar sekmesi) - **Kanal erişim belirteci** — **Mesajlaşma API** sekmesinde oluşturduğunuz uzun ömürlü bir belirteç Standart (doğrulanmamış) bir Resmi Hesap için herhangi bir ticari belge gerekmez; sadece bir LINE İş Kimliği yeterlidir. Doğrulama (mavi rozet) isteğe bağlıdır ve yalnızca bazı bölgelerde sunulur. --- ## LINE Kurulumu ### 1. Adım: Resmi Hesabınız için Messaging API'yi Etkinleştirin 1. [LINE Resmi Hesap Yöneticisi](https://manager.line.biz) oturumu açın (veya önce yeni bir Resmi Hesap oluşturun). 2. OA'nızı açın. 3. **Ayarlar**'a (sağ üst köşe) tıklayın. 4. Ayarlar menüsünde **Mesajlaşma API**'sine tıklayın. 5. Durum **Devre Dışı** olarak başlar; etkinleştirmek için tıklayın. 6. Bu kanal için **sağlayıcıyı** (sahibi olan şirket/geliştirici) seçin. Henüz bir sağlayıcınız yoksa, **yeni bir sağlayıcı oluşturun** ve onaylayın. ### 2. Adım: Geliştirici Konsolu'ndan Kimlik Bilgilerinizi Alın Mesajlaşma API'sini etkinleştirmek, [LINE Geliştirici Konsolu](https://developers.line.biz/console/) içindeki sağlayıcınızın altında bir kanal oluşturur. 1. **Geliştirici hesabını / sağlayıcıyı** açın. 2. **Mesajlaşma API kanalına** tıklayın. 3. **Temel ayarlar** sekmesini açın ve **Kanal Kimliğinizi** ve **Kanal gizli anahtarınızı** kopyalayın. 4. **Mesajlaşma API** sekmesini açın, uzun ömürlü bir **Kanal erişim belirteci** oluşturun (veya yeniden oluşturun) ve kopyalayın. > Bu değerleri elinizin altında bulundurun; bir sonraki adımda bunları uygulamaya yapıştıracaksınız. ### 3. Adım: Uygulamada LINE'ı Bağlayın 1. Sol kenar çubuğunda, en altta bulunan **Settings** (Ayarlar) öğesine tıklayın. 2. Ayarlar sol panelinde, **Channels** (Kanallar) altında **Channels** (Kanallar) öğesine tıklayın. 3. **LINE** kartını bulun ve **Connect** (Bağlan) düğmesine tıklayın. 4. İsteğe bağlı olarak **Channel ID** (Kanal Kimliği) bilginizi yapıştırın — yalnızca bilgilendirme amaçlıdır. 5. **Channel secret** (Kanal gizli anahtarı) bilginizi yapıştırın. 6. **Channel access token** (Kanal erişim belirteci) bilginizi yapıştırın. 7. **Connect** (Bağlan) düğmesine tıklayın. 8. Uygulama, kimlik bilgilerini LINE ile doğrular ve **"Connected to: \"** (Bağlandı: \) mesajını gösterir. Kimlik bilgileri yanlışsa bir hata alırsınız; bu durumda LINE Developers Console üzerinden erişim belirtecini yeniden oluşturun ve tekrar deneyin. ### 4. Adım: LINE'da Webhook URL'sini Ayarlayın Bağlandıktan sonra, uygulama bir **webhook URL'si** içeren bir **LINE'da kurulumu tamamla** bölümü gösterir; bunu kopyalayın. (Webhook URL'si sadece bir web adresidir; bunu LINE'a yapıştırmak, LINE'a yeni mesajları otomatik olarak nereye göndereceğini söyler.) Ardından, Mesajlaşma API kanalınız için **LINE Geliştirici Konsolunda**: 1. **Mesajlaşma API** sekmesini açın. 2. URL'yi **Webhook URL** alanına yapıştırın. 3. **Güncelle**'ye tıklayın. 4. **Webhook kullan** seçeneğini **AÇIK** konuma getirin. ### 5. Adım: Resmi Hesap Yöneticisi Ayarlarını Düzeltin (Önemli) Varsayılan olarak, bir LINE OA sohbetleri ve *otomatik yanıtları* kendisi yönetir; bu da mesajların yapay zekaya ulaşmasını engeller. [LINE Resmi Hesap Yöneticisi](https://manager.line.biz) bölümüne geri dönün, OA ayarlarınızı açın ve şunları ayarlayın: | Ayar | Gerekli değer | Neden | |---|---|---| | **Sohbet** | **Açık** | Sohbetin akması için sohbeti açar (sohbet filtresini kullanmanızı sağlar). | | **Yanıt modu** | **Bot** | API'nizin (Yapay Zeka Temsilciniz) mesajları işlemesini sağlar. "Sohbet" modu mesajları yutar. | | **Yanıt saatleri / Otomatik yanıt mesajları** | **Kapalı** | Yapay zekanın yanıtları işlemesi için LINE'ın kendi otomatik yanıtlarını devre dışı bırakır ("çift yanıt" sorununun 1 numaralı nedenidir). | | **Karşılama mesajları** | **Kapalı** | LINE'ın kendi otomatik karşılama mesajının yapay zeka ile çakışmasını önler. | | **Webhook'lar** | **Açık** | LINE'ın mesajları uygulamaya iletmesi için. | > Uygulama, hesabınızın **Chat mode** (Sohbet modu) olduğunu uyarırsa, buradan **Bot mode** (Bot modu) seçeneğine geçin; aksi takdirde bot mesaj alamaz veya gönderemez. ### 6. Adım: Botu Test Edin 1. Farklı bir telefondan (örneğin kendi LINE uygulamanızdan), Resmi Hesabınızı arkadaş olarak ekleyin ve **ona bir mesaj gönderin**. 2. Uygulamayı açın ve **Sohbetler**'e gidin; gelen mesaj sohbet listesinde görünür. 3. Bu kanalı bir Yapay Zeka Temsilcisi yönetiyorsa, test mesajına **otomatik olarak yanıt verdiğini** göreceksiniz. Webhook ayarlandıktan ve yukarıdaki anahtarlar doğru konuma getirildikten sonra, LINE hesabınız Kanallar sayfasında **Bağlı** olarak görünür ve yapay zeka gelen mesajlara yanıt verir. --- ## Maliyet LINE, uygulamada **ücretsiz** bir kanaldır; mesaj başına ücret veya bizden aylık bağlantı ücreti alınmaz. **LINE'ın kendi planlarının**, bölgeye ve hesap türüne göre değişen *push* (proaktif gönderim) mesajları için kendi aylık limitleri olduğunu unutmayın. Bir müşteri size mesaj attıktan kısa bir süre sonra gönderilen yanıtlar LINE'da ücretsizdir; proaktif/yayın gönderimleri LINE planınızın kotasından düşer. --- ## Medya Mesajları Gelen fotoğraflar, videolar, sesli notlar, dosyalar, çıkartmalar ve konumlar tanınır, böylece yapay zeka medya gönderildiğini anlar (sohbete kısa bir not eklenir). Giden yapay zeka yanıtları bu sürümde **metin ve görsellerden** oluşur. Uzun yanıtlar, LINE'ın 5.000 karakter sınırına göre otomatik olarak kırpılır. --- ## Oturum Yönetimi ### Bağlantı Durumunu Kontrol Etme LINE bağlantı durumunuz, **Kanallar** sayfasındaki **LINE** kartında gösterilir: | Durum | Anlamı | |---|---| | **Bağlı** | Bir LINE Resmi Hesabı bu hesaba bağlıdır | | **Bağlı değil** | Hiçbir bağlantı kurulmamış | Kart ayrıca, Kanallar sayfasını her açtığınızda hesabınızın **Sohbet modu** ayarını yeniden kontrol eder. LINE hesabınız tekrar Sohbet moduna alındıysa (bu, botun mesaj almasını veya göndermesini durdurur), kart üzerinde LINE Resmi Hesap Yöneticisi'nde tekrar **Bot modu**na geçmeniz gerektiğini belirten sarı bir uyarı görünür; 5. Adımdaki geçiş düğmelerini orada tekrar kontrol ettiğinizde uyarı bir sonraki ziyarette kaybolacaktır. ### Bağlantıyı Kesme **LINE** kartını açın ve **Yönet**'e tıklayın, ardından açılan panelde **Bağlantıyı kes**'e tıklayın ve **LINE kaldırılsın mı?** sorusunu onaylayın. Bu işlem, bizim tarafımızdaki bağlantıyı kaldırır. LINE'ın etkinlik göndermeyi tamamen durdurması için, LINE Geliştirici Konsolu'nda **Web kancasını kullan** seçeneğini de kapatın (veya web kancası URL'sini silin). --- ## Sınırlamalar - **Bağlantı başına bir Resmi Hesap.** Her OA'yı ayrı ayrı bağlayın; bir OA yalnızca bir hesaba bağlanabilir. - **Metin + görsel gönderimi.** Yapay zeka metin ve görsellerle yanıt verir; zengin "Flex"/şablon/karusel mesajları bu sürümde gönderilmez. - **Bölge.** LINE Resmi Hesapları AB'de kullanılamaz; desteklenen bir bölgede (örneğin Japonya, Tayvan, Tayland, Endonezya) bir OA'ya ihtiyacınız vardır. - **Yanıt zamanlaması.** LINE'ın ücretsiz anlık yanıtları için kısa bir zaman penceresi vardır; daha sonra gönderilen mesajlar otomatik olarak (kota dahilinde) push mesajı olarak iletilir. --- ## Sorun Giderme ### Bağlanırken Kimlik Bilgileri Reddedildi - ("LINE Login" değil) bir **Messaging API** kanalı oluşturduğunuzdan emin olun. - Messaging API sekmesinden **uzun ömürlü bir kanal erişim belirteci (long-lived channel access token)** yeniden oluşturun ve yeni değeri yapıştırın. - **Kanal gizli anahtarını (Channel secret)** (Kanal Kimliğini değil) Temel ayarlar sekmesinden kopyaladığınızı doğrulayın. ### Bot Yanıt Vermiyor - Hem Geliştirici Konsolunda hem de OA Yöneticisinde **Webhooks** özelliğinin **Açık** olduğunu doğrulayın. - **Webhook URL** adresinin uygulamada gösterilenle eşleştiğini doğrulayın. - OA Yöneticisinde **Yanıt modunun** (Sohbet değil) **Bot** olarak ayarlandığını doğrulayın. ### Müşteriye İki Yanıt Gidiyor - OA Yöneticisinde **Otomatik yanıt mesajlarını** ve **Karşılama mesajlarını** **Kapalı** konuma getirin; LINE'ın yerleşik otomatik yanıtları yapay zeka ile birlikte gönderiliyor. ### Mesajlar Uygulamaya Ulaşmıyor - Kişinin **Resmi Hesabınızı arkadaş olarak eklediğini** doğrulayın (LINE yalnızca arkadaşlardan gelen mesajları iletir). - Webhook URL'sini ve **Webhook kullan** seçeneğinin açık olduğunu tekrar kontrol edin. --- ## En İyi Uygulamalar - **OA Yöneticisi ayarlarını tamamlayın** (Bot modu, Webhook'lar açık, Karşılama + Otomatik yanıt kapalı) — kurulum sorunlarının çoğu bunlardan kaynaklanır. - Yanıtları LINE'ın ücretsiz penceresi içinde tutmak ve push kotanızı korumak için **hızlı yanıt verin**. - **Erişim belirtecinizi güvende tutun** — ona sahip olan herkes Resmi Hesabınız adına gönderim yapabilir. Sızması durumunda Geliştirici Konsolundan yeniden oluşturun.