Geliştirici paneli inkiveta.com

Kodsuz sohbet botu: Akış editörü

Sunucun ya da kod bilgin yoksa sohbet botunu Atölye → Akış ekranında kutucukları birbirine bağlayarak kurabilirsin. Akış inkiveta sunucularında çalışır; webhook, barındırma ya da token gerekmez. Randevu alma, sık sorulan sorular, sipariş formu, canlı desteğe aktarma gibi işler için yeterlidir.

Önemli: Bir uygulama aynı anda ya akışla ya kendi kodunla (webhook / getUpdates) çalışır. Akış yayındayken getUpdates ve setWebhook 409 Conflict: … while the hosted flow is active; turn the flow off in Atölye first döner; webhook kuruluyken de akış yayınlanamaz. Kodla devam etmek istersen önce Atölye'den akışı kapat.

Nasıl çalışır?#

  1. Bir Başlangıç düğümü koy ve neyle tetikleneceğini seç.
  2. Ardına mesaj, bileşen, seçenek, form… düğümlerini ekle ve çıkışlarını bir sonrakine bağla.
  3. Önizle ile test ortamında dene (sen ve test kullanıcıların taslağı görür).
  4. Yayınla — gerçek kullanıcılar yalnız yayınlanan sürümü görür. Her yayın bir sürüm olarak saklanır; eski bir sürüme tek tıkla geri dönebilirsin.

Her kullanıcının konuşması ayrı yürür: akış kullanıcının nerede kaldığını, değişkenlerini ve beklediği şeyi hatırlar.

Düğümler#

DüğümNe yaparÇıkışlar
BaşlangıçAkışın giriş noktası. Tetik: komut (randevu → /randevu), anahtar kelime (tam eşleşme, büyük/küçük harf fark etmez), derin bağlantı (?start=kampanya), ana sayfa (ana sayfadan bir seçim), varsayılan (hiçbir tetiğe uymayan metin; en çok bir tane). En çok 20 başlangıç.sonra
MesajMetin gönderir (≤ 4.096, {{değişken}} içerebilir)sonra
BileşenBir yerel bileşen gönderir (+ düz metin karşılığı)sonra
SeçeneklerSoru + 2–8 düğme; kullanıcının seçimini beklerher seçeneğin kendi çıkışı
FormGönder eylemli bir bileşen (ör. multistep_form) açar; alanlar form_<alan_id> (ya da senin seçtiğin önekle) değişkenlere yazılırgönderildi, iptal
Koşul{{değişken}} ile karşılaştırma: eşit, içerir, var, büyük, küçük (son ikisi sayısal)doğru, yanlış
BekleBir süre (1 sn – 7 gün) ya da günün bir saati (09:00, Türkiye saati) kadar beklersonra
BağlantıKendi sunucuna imzalı bir POST atar (aşağıda)başarılı, hata, zaman aşımı
DeğişkenBir değişkene değer yazar (≤ 1.024)sonra
BitirKonuşmayı bitirir; isteğe bağlı son mesaj. İnsana devret seçilirse konuşma ekibinin Destek kuyruğuna düşer ve akış o kullanıcıya yanıt vermeyi bırakır—

Kurallar:

  • Bağlanmamış bir çıkış konuşmayı orada sessizce bitirir. Editör bunları uyarı olarak gösterir.
  • Bekleme ya da kullanıcı girdisi (Bekle, Seçenekler, Form) içermeyen döngü kurulamaz.
  • Editör kaydederken her şeyi denetler: eksik alan, hatalı bağlantı, geçersiz bileşen, güvensiz adres… Hatalı akış kaydedilmez, nedeni düğümün üstünde gösterilir.

Değişkenler#

  • Metinlerde {{ad}} biçiminde kullanılır; tanımsız değişken boş yazılır.
  • Ad kuralı: küçük harf, rakam, alt çizgi; harfle başlar (^[a-z][a-z0-9_]{0,31}$). sistem_ öneki ayrılmıştır.
  • Hazır değişkenler: {{sistem_gorunen_ad}} (kullanıcı görünen adını paylaşmaya izin verdiyse) ve {{sistem_dil}} (tr ya da en).
  • Kullanıcıların akış değişkenleri, kullanıcı veri silme istediğinde anında silinir.

Yapma: Kullanıcıdan parola, kart numarası ya da doğrulama kodu isteme. Editör bu tür metinleri reddeder; kullanıcı yine de böyle bir şey yazarsa uygulama ona güvenlik uyarısı gösterir.

Bağlantı düğümü#

Akışı kendi sistemine (stok, randevu takvimi, CRM…) bağlamanın yolu. Düğüm, yazdığın https:// adresine JSON gövdeli bir POST gönderir:

httpPOST /randevu-musait-mi HTTP/1.1
Host: api.ornek.com
Content-Type: application/json
X-Inki-Bot-Id: 4711
X-Inki-Signature: t=1794355200,ed25519=Vb3k…

{"gun":"{{form_gun}}","hizmet":"{{form_hizmet}}"}
  • Gövde şablonu ≤ 8 KB; dize değerlerinde {{değişken}} kullanılır.
  • 2xx yanıt → başarılı; başka kod ya da ağ hatası → hata; 3 saniye içinde yanıt yoksa → zaman aşımı.
  • "Yanıt değişkeni" verirsen başarılı yanıtın gövdesi (geçerli JSON, ≤ 16 KB) olduğu gibi o değişkene yazılır. JSON değilse ya da daha büyükse hata çıkışı çalışır. Mesajda kullanmak istediğin değeri sunucun düz bir alan olarak döndürsün.
  • Yanıt gövdesi en çok 256 KB okunur; yönlendirme izlenmez; yalnız genel internet adreslerine gidilir (iç/özel ağ adresleri reddedilir).
  • Uygulama başına saniyede en çok 10 bağlantı isteği. Önizlemede gerçek istek de atılabilir (önizleme başına 3, dakikada 20).

İsteğin inkiveta'dan geldiğini doğrula. İmza, "<t>.<bot_id>.<gövde>" dizesinin Ed25519 imzasıdır; açık anahtar getMe yanıtındaki inki_signature_public_key alanındadır (Mini App ile aynı anahtar; test ve gerçek ortamda farklı).

pythonimport base64, time
from cryptography.hazmat.primitives.asymmetric.ed25519 import Ed25519PublicKey

def b64url(s): return base64.urlsafe_b64decode(s + "=" * (-len(s) % 4))

def inkiveta_mi(govde: bytes, bot_id: str, imza_basligi: str, acik_anahtar: str) -> bool:
    parca = dict(p.split("=", 1) for p in imza_basligi.split(","))
    t = int(parca["t"])
    if abs(time.time() - t) > 300:          # 5 dakikadan eski isteği reddet
        return False
    veri = f"{t}.{bot_id}.".encode() + govde  # gövdeyi BAYT olarak, değiştirmeden kullan
    try:
        Ed25519PublicKey.from_public_bytes(b64url(acik_anahtar)).verify(b64url(parca["ed25519"]), veri)
        return True
    except Exception:
        return False

Sınırlar#

KonuSınır
Akış büyüklüğü≤ 200 düğüm, ≤ 400 bağlantı, ≤ 20 başlangıç
Tek adım5 sn (aşan adım akışı o düğümde durdurur)
Tek çalıştırma≤ 100 adım (kullanıcıdan girdi beklemeden art arda)
Bekle1 sn – 7 gün (1 günden uzunu uyarı verir)
Bağlantı3 sn, gövde şablonu ≤ 8 KB, yanıt ≤ 256 KB, değişkene ≤ 16 KB
GönderimUygulamaya genel hız limitleri aynen geçerli

Akış da kullanıcıya yazma kurallarına uyar: kullanıcı izin vermediyse akış da ona kendiliğinden yazamaz.

Hata politikası en çok bir kezdir: kullanıcıya görünen bir adım hata alsa bile yeniden çalıştırılmaz (çift mesaj olmasın diye). Atölye → Akış'ta son hatalar düğüm adıyla görünür.