Your AI Connector Docs

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 ü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 belirteciMesajlaş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 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 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: <OA adınız>” (Bağlandı: <OA adınız>) 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 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 moduna 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.