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ındaykengetUpdatesvesetWebhook409 Conflict: … while the hosted flow is active; turn the flow off in Atölye firstdöner; webhook kuruluyken de akış yayınlanamaz. Kodla devam etmek istersen önce Atölye'den akışı kapat.
Nasıl çalışır?#
- Bir Başlangıç düğümü koy ve neyle tetikleneceğini seç.
- Ardına mesaj, bileşen, seçenek, form… düğümlerini ekle ve çıkışlarını bir sonrakine bağla.
- Önizle ile test ortamında dene (sen ve test kullanıcıların taslağı görür).
- 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üğüm | Ne 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 |
| Mesaj | Metin gönderir (≤ 4.096, {{değişken}} içerebilir) | sonra |
| Bileşen | Bir yerel bileşen gönderir (+ düz metin karşılığı) | sonra |
| Seçenekler | Soru + 2–8 düğme; kullanıcının seçimini bekler | her seçeneğin kendi çıkışı |
| Form | Gö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ır | gö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ış |
| Bekle | Bir süre (1 sn – 7 gün) ya da günün bir saati (09:00, Türkiye saati) kadar bekler | sonra |
| Bağlantı | Kendi sunucuna imzalı bir POST atar (aşağıda) | başarılı, hata, zaman aşımı |
| Değişken | Bir değişkene değer yazar (≤ 1.024) | sonra |
| Bitir | Konuş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}}(trya daen). - 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#
| Konu | Sınır |
|---|---|
| Akış büyüklüğü | ≤ 200 düğüm, ≤ 400 bağlantı, ≤ 20 başlangıç |
| Tek adım | 5 sn (aşan adım akışı o düğümde durdurur) |
| Tek çalıştırma | ≤ 100 adım (kullanıcıdan girdi beklemeden art arda) |
| Bekle | 1 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önderim | Uygulamaya 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.