Temel Kavramlar

Sosyabot küçük bir isim kümesi etrafında döner. Bunlar oturduğunda dokümanların geri kalanı hızlıca okunur.

Çalışma alanı (workspace)

Çalışma alanı üst düzey kiracıdır. Faturalandırma, kanallar, üyeler, gönderiler, AI kredileri ve özellik anahtarları buraya bağlıdır. Bir kullanıcı birçok çalışma alanına ait olabilir; çalışma alanı seçicisi (/app'in sol üstü) hangisinin "aktif" olduğunu belirler.

Yeni bir hesap, kayıt anında Türk pazarına yapılandırılmış bir varsayılan çalışma alanı alır: para birimi TRY, locale tr, 3 günlük denemeli FREE plan. Bunların herhangi birini Takım & Çalışma Alanı altından değiştir.

Bir çalışma alanındaki roller owner, admin, editor ve viewer'dır. Roller & İzinler'e bak.

Kanal (channel)

Kanal (eski UI'da bazen account olarak da geçer) bağlanmış bir sosyal profilden biridir — bir X handle'ı, bir Instagram business hesabı, bir Discord sunucusu vb. Her kanalın kendine özgü:

• Sağlayıcı (x, instagram, bluesky, telegram, …)
• Kimlik durumu (OAuth token + refresh token, ya app password, ya bot token)
• Saat dilimi (zamanlama yaparken editör tarafından kullanılır)
• Filigran ve açıklama varsayılanları

Arka plan worker'ları Threads, Pinterest, YouTube ve Reddit için token'ları süreleri dolmadan yeniler; başarısız yenilemeler kanalı needs_reconnect olarak işaretler. Bağlantılar Genel Bakış'a bak.

Gönderi (post)

Gönderi yayın birimidir. Şunları taşır:

• Hedef kanal listesi (aynı içerik birçok kanala dağıtılır).
• Bir gövde (caption), bir type (text, image, video, mixed), Dosya Kütüphanesi'ne media[] referansları ve labels[].
• Bir category (profile, reel, story vb. — platforma bağlıdır).
• Bir post_by değeri (0 şimdi yayınla, 3 ileri tarihli zamanla) ve time_posts[] (her kanal için bir zaman damgası — kanallar farklı saat dilimlerindeyse farklı olabilir).

Yaşam döngüsü durumları: draft → scheduled → queued → sent (ya da failed). failed durumundaki bir gönderi editörden tekrar denenebilir; platform API'sinden gelen hata sebebi inline gösterilir.

Zamanlama (schedule)

Zamanlama, bir kanala ve o kanalın saat dilimine sabitlenmiş ileri bir andır. Tek seferlik zamanlamalar sadece bir zaman damgasıdır. Tekrarlı zamanlamalar rrule söz dizimini kullanır — takvim uygulamanın kullandığı aynı iCalendar standardı.

Editörün Boş slot bul butonu, kanalın mevcut kuyruğuna ve çalışma alanının sessiz saatlerine göre bir sonraki boş slotu önerir.

Kampanya (campaign)

Kampanya ilgili gönderileri gruplar. Ürün lansmanları, içerik serileri, haftalık özetler veya reklamla desteklenen anlar için kullan. Kampanya seviyesindeki analitik, her üye gönderi üzerinden gösterim, etkileşim ve kısa link tıklamalarını toplar — Kampanya Performansı'na bak.

Etiket (label)

Etiket, gönderilere uygulanan serbest formlu bir etikettir. Yayın listesini, analitiği ve API sorgularını etikete göre filtrele. Etiketler çalışma alanı kapsamlıdır ve yöneticiler bir marka paleti önceden ekleyebilir; böylece takım arkadaşları "tutorial" için on çeşit varyant uydurmaz.

Ajan (agent)

Ajan, belirli bir kadansta — saatlik, günlük veya haftalık — çalışan otonom bir AI worker'dır. Promptu, kanal kümesini, kadansı ve (opsiyonel olarak) kaynak sinyalini (RSS feed, son N gönderi, özel sorgu) yapılandırırsın ve ajan, aiAgents.queue.ts BullMQ worker'ı üzerinden gözetimsiz biçimde gönderiyi kuyruğa alır.

Ajanlar, manuel prompt çağrılarında olduğu gibi her çalıştırmada AI kredilerini düşer.

Kredi (credit)

Kredi AI kullanım birimidir. Görsel üretimi, video üretimi, prompt çalıştırmaları ve inline yardım hepsi kredi harcar. Modeller kayıt defterindeki her model, yöneticinin ayarladığı çağrı başı bir çarpan taşır. Kotalar çalışma alanının fatura döngüsünde yenilenir; tüketimi Krediler altından izle.

Rol (role)

Rol bir izin paketidir. Dört rol yaygın erişim örüntülerini kapsar:

• Owner — faturalandırma, plan, tüm yönetim özellikleri.
• Admin — çalışma alanı ayarları, kullanıcılar, entegrasyonlar.
• Editor — hazırla, zamanla, AI çalıştır.
• Viewer — yalnız okuma.

Kiracı kapsam denetimi API katmanında uygulanır, böylece rol kontrolleri elle hazırlanmış bir istekle aşılamaz. Roller & İzinler'e bak.

Token / API anahtarı

İki tür programatik kimlik bilgisi:

• Kişisel API token — Hesap → API Token'ları altından üretilir. Bearer header. Sahibinin rolünü taşır.
• Webhook imza secret'ı — bir webhook kaydettiğinde verilir. Sosyabot her giden isteği HMAC-SHA256 ile imzalar; sen kendi tarafında doğrularsın. Webhook'lar'a bak.

Her ikisi de çalışma alanı kapsamlı ve iptal edilebilirdir.

Sıradaki

Bağlantılar

Editör

Yapay Zekâ