Hızlı Başlangıç

Bu, yeni bir hesaptan ilk yayınlanmış gönderine kadar beş dakikalık yoldur.

1. Kayıt ol

app.sosyabot.com/auth/signup adresini aç. Form iki adımlı bir akıştır:

Adım 1 — E-posta. E-postanı gir. Sosyabot, GET /api/v1/auth/email-available?email=… üzerinde 400 ms debounce ile uygunluk kontrolü yapar. Adres zaten doğrulanmışsa hata görürsün; varsa ama henüz doğrulanmadıysa OTP'yi yeniden tetiklemek için tekrar kayıt olabilirsin.

Adım 2 — Hesap detayları. Şunları gir:

• Ad / soyad — her biri 2–50 karakter.
• Kullanıcı adı — 3–30 karakter, yalnızca [A-Za-z0-9._-]. Kullanıcı adı . _ - ile başlayamaz veya bitemez ve bu karakterlerden ikisi peş peşe gelemez. Canlı uygunluk kontrolü (GET /api/v1/auth/username-available?username=…) müsait olduğunu onaylar.
• Telefon — uluslararası E.164 formatı (libphonenumber-js ile doğrulanır).
• Şifre — 8–64 karakter, en az bir büyük harf, bir küçük harf ve bir rakam içermelidir. Bir güç ölçer beş kademe gösterir (veryWeak → strong).
• Şifreyi doğrula — eşleşmelidir.

Gönderme POST /api/v1/auth/signup çağrısı yapar. Başarı durumunda OTP sayfasına yönlendirilirsin.

OAuth ile giriş

Yöneticin etkinleştirdiyse, e-posta adımında Google ile devam et ve GitHub ile devam et butonları görünür. Bunlar ${API_URL}/auth/oauth/google veya /auth/oauth/github'a yönlendirir ve ilk girişte OTP akışını atlar.

2. E-postanı doğrula

Sosyabot kayıt olduğun adrese 6 haneli bir OTP gönderir. Varsayılan TTL 5 dakika ve varsayılan deneme limiti 3'tür; her ikisi de çalışma alanı bazında yapılandırılabilir.

Kodu /auth/otp üzerinde gir ve POST /api/v1/auth/verify gönder. Başarı durumunda backend:

1. Hesabını isVerified = true olarak işaretler.
2. Varsayılan bir çalışma alanı oluşturur (para birimi TRY, locale tr, 3 günlük denemeli FREE plan) — yalnızca daha önce bir tane yoksa.
3. httpOnly, secure, sameSite=strict cookie içinde token adıyla bir JWT verir.
4. Seni /app'e (veya bir tane varsa bekleyen davete) yönlendirir.

OTP süresi doldu

Kod TTL'i geçerse OTP sayfasındaki Tekrar gönder'e tıkla. Endpoint rate-limit'lidir (otpLimiter: 15 dakikada 20 istek), bu yüzden defalarca yeniden göndermek sonunda engellenir.

3. Onboarding sihirbazını çalıştır

Doğrulamadan sonra /app'e ilk geldiğinde Sosyabot seni /app/onboarding'e yönlendirir — beş adımlı bir sihirbaz. Tam tur Onboarding'de; kısa hâli:

1. Karşılama — ürünle tanış.
2. İlk kanalını bağla — sihirbazdan normal şekilde çıkmak için en az bir hesap gerekir. Buton seni Bağlantılar sayfasına atar; OAuth turunu tamamlarsın ve geri dönersin.
3. AI genel bakış — bilgilendirme, giriş yok.
4. İlk gönderini yaz — bir açıklama yapıştır, Şimdi yayınla veya Taslak olarak kaydet seç ve sihirbaz accounts: [firstChannelId], category: "profile", type: "text" ile POST /api/v1/posts gönderir.
5. Bitti — Panele git'e tıklamak PATCH /api/v1/users/me/onboarding { completed: true } çağırır ve sonunda seni /app'e indirir.

4. Zamanla ve izle

Artık Pano içindesin. Widget'lar zamanlanmış kuyruğu, son etkinlikleri ve etkileşim trendini kapsar. Daha fazla gönderi hazırlamak için Yayınlama'yı, daha fazla kanal eklemek için Bağlantılar'ı aç.

Sorun giderme

OTP hiç gelmedi

SMTP'yi Yönetim → SMTP altında doğrula ve test e-postasını yeniden gönder.

Rate-limit'e takıldım

Auth route'ları 15 dakikada 10 istek, OTP 15 dakikada 20 istek ile sınırlı. Bekle veya yöneticine başvur.

Şifremi unuttum

Giriş sayfasından **Şifremi unuttum**'u seçerek e-posta ile sıfırlama linki al.

Çalışma alanı değiştirmem gerek

`/app`'in sol üstündeki çalışma alanı seçicisini kullan.