Geliştirici paneli inkiveta.com

inkiveta uygulamaları

Sohbet botları, inkiveta'nın içinde çalışan küçük programlardır. Kullanıcı bir sohbet botuyla, bir arkadaşıyla yazışır gibi yazışır. Botun kendisi ise senin sunucunda çalışan koddur; inkiveta ile HTTPS istekleri üzerinden konuşur. Bu isteklerin arayüzüne Bot API denir.

inkiveta'da sohbet botları ve mini uygulamalar kullanıcıya "uygulama" olarak görünür ve alt çubuktaki Keşfet sekmesinde yer alır; uygulamanın kullanıcıya attığı mesajlar kişi sohbetleriyle birlikte Sohbetler listesine düşer. Bu belgelerde de genel ad "uygulama"dır; teknik arayüzün adı ise Bot API'dir.

inkiveta Bot API'si Telegram Bot API 10.4 ile uyumludur. Telegram için yazılmış bir bot, kullandığı kütüphanede sunucu adresi değiştirilerek inkiveta'da çalıştırılabilir. Nasıl yapıldığı Telegram'dan taşıma sayfasında anlatılıyor.

Uygulamalarla neler yapılabilir?#

Web sitesinin yerini almak#

Randevu almak, sipariş vermek, masa ayırtmak gibi işler bir web sitesine gitmeden sohbetin içinde yapılabilir. Takvim, saat seçici, sepet ve form gibi arayüz parçaları uygulamada hazır bulunur. Sen yalnız veriyi gönderirsin, inkiveta onu kendi tasarımıyla çizer. Bunlara yerel bileşenler diyoruz; şu an 57 tane var.

Kendi arayüzünü açmak#

Hazır parçalar yetmezse kendi web sayfanı Mini App olarak uygulamanın içinde tam ekran açabilirsin. Telegram Mini App'leri için yazılmış kod burada da çalışır.

Ödeme almak#

Dijital ürün, abonelik ve ücretli içerik satılabilir. Kullanıcı inkiveta'daki Ink bakiyesiyle öder, sen ödemenin sonucunu bir güncelleme olarak alırsın. Ayrıntılar Ödemeler sayfasında.

Bildirim göndermek#

Sipariş durumu, randevu hatırlatması ya da günlük bülten göndermek için. Kullanıcı her uygulamanın bildirimlerini ayrı ayarlayabilir; acil olmayan mesajları günde bir özet olarak almayı seçebilir. Neye ne zaman yazabileceğin kurallar sayfasında yazıyor.

Yapay zekâ ile sohbet#

Bir dil modelinin yanıtı, üretildikçe aynı mesaj balonunda büyütülerek gösterilebilir. Kullanıcı isterse üretimi yarıda kesebilir. Zengin içerik sayfasına bak.

Oyun#

HTML5 oyunları uygulaman üzerinden açılır, skorları sohbet botun kaydeder. Oyunlar bölümüne bak. Çok oyunculu, gerçek zamanlı oyunlar için Mini App'teki oyuncular bir oyun odasına bağlanır; istersen sunucun odada hakemlik yapar.

Kod yazmadan sohbet botu kurmak#

Sık sorulan sorular, basit bir başvuru formu ya da canlı desteğe aktarma gibi işler için sunucu gerekmez. Bunlar Atölye'deki akış editöründe kutular birbirine bağlanarak kurulur ve inkiveta'nın sunucularında çalışır.

Sohbet botu nasıl çalışır?#

Kullanıcı uygulamana bir şey yazdığında ya da bir düğmeye bastığında inkiveta bunu bir güncelleme (update) olarak kaydeder. Botun güncellemeleri iki yoldan biriyle alır: ya inkiveta onları senin belirlediğin adrese gönderir (webhook), ya da programın belirli aralıklarla kendisi sorar (getUpdates). Bot yanıt vermek için sendMessage gibi yöntemleri çağırır:

bashcurl "https://app.inkiveta.com/bot<token>/sendMessage" -d chat_id=4185489292941965 -d text="Merhaba"

Her istekte uygulamanın token'ı kullanılır. Token'ı bilen biri uygulamanı tamamen yönetebilir, bu yüzden onu bir parola gibi saklamalısın.

NeAdres
APIhttps://app.inkiveta.com/bot<token>/<YÖNTEM>
Dosya indirmehttps://app.inkiveta.com/file/bot<token>/<file_path>
Test ortamıhttps://app.inkiveta.com/bot<test_token>/test/<YÖNTEM>
Uygulamanın paylaşım bağlantısıhttps://inkiveta.com/@<kullanici_adi> (uzun biçim https://app.inkiveta.com/bot/<kullanici_adi> de geçerli)

Güncellemelerin ayrıntısı Güncellemeleri almak sayfasında.

Uygulamalar normal hesaplardan nasıl ayrılır?#

  • Uygulamalar yalnız birebir sohbette çalışır. Gruplara ve kanallara eklenemezler.
  • Bir uygulama, kullanıcı onu başlatmadan ona yazamaz. Kullanıcı ayrıca uygulamanın kendiliğinden mesaj atmasını kapatabilir.
  • Uygulama kullanıcıyı yalnız kendisine özel bir kimlikle görür. Aynı kişi iki farklı uygulamada iki farklı kimlikle görünür. Telefon numarası uygulamaya iletilmez.
  • Uygulama sohbetleri uçtan uca şifreli değildir. Kullanıcı bunu uygulamayı başlatmadan önce profil sayfasında görür.
  • Kullanıcı istediği an verilerinin silinmesini isteyebilir. Uygulama sahibi bu isteği 30 gün içinde yerine getirmek zorundadır (Gizlilik).

Uygulama nasıl oluşturulur?#

Uygulamada Keşfet → Kendi uygulamanı yap yolunu izle. Bu ekrana Atölye diyoruz. Bir kullanıcı adı ve görünen ad seç, sunucunun bulunduğu ülkeyi belirt ve şartları onayla. İşlem bitince ekranda uygulamanın token'ı görünür. Telefon numarası doğrulanmış her hesap bir uygulama açabilir; Ink+ üyeleri beşe kadar açabilir.

Adım adım anlatım ve çalışan örnek kod İlk sohbet botun sayfasında. Uygulamanı gerçek kullanıcılara açmadan önce ayrı bir token'la test ortamında deneyebilirsin.

Buradan sonra#

Sorun yaşarsan [email protected] adresine ya da uygulamada Atölye → Destek'e yazabilirsin.