Bağlantılar Genel Bakış

Sosyabot'ta bir kanal, bağlanmış bir sosyal hesaptır. Birleşik depo Accounts MongoDB koleksiyonudur, anahtarı (workspace, social_network, pid)'dir. Gönderiler kanalları _id'leriyle hedefler; editör tek seferde birçok kanala dağıtır.

Üç bağlantı türü

Desteklenen her platform üç gruptan birine düşer:

1. OAuth 2.0 — çoğunluk. Sosyabot sağlayıcıya yönlendirir, kullanıcı scope'lara izin verir, sağlayıcı bir authorization code ile ${BASE_URL}/api/v1/auth/<platform>/callback'e geri döndürür. Sosyabot kodu token'larla takas eder ve saklar. Login type 1.
2. App-credentials + cookie / app-password — X (cookie connect) ve Bluesky (app password). Kullanıcı kimlik bilgilerini doğrudan gönderir; Sosyabot saklamadan önce sunucu tarafında doğrular. Login type 2.
3. Kullanıcı tarafından sağlanan bot token / API anahtarı — Telegram (BotFather token), Listmonk (admin API key veya basic auth). Callback yok, global app credential yok.

Token yenileme

Bir BullMQ worker'ı (backend/src/queues/tokenRefresh.queue.ts) zamanlanmış olarak dört platformu tarar ve 7 gün içinde süresi dolan token'ları yeniler:

• Threads — varsayılan 60 günlük TTL.
• Pinterest — varsayılan 30 günlük TTL.
• YouTube — varsayılan 1 saatlik TTL (neredeyse sürekli yenilenir).
• Reddit — kalıcı refresh token'larla varsayılan 1 saatlik TTL.

Diğer platformlar otomatik yenilenmez. Ya uzun ömürlü token verirler (LinkedIn, Slack, Mastodon, Instagram, Facebook), ya OAuth kullanmazlar (Bluesky, Telegram, Listmonk), ya da manuel reconnect'e dayanırlar (X, TikTok).

Başarısız bir yenileme account.refresh_failed webhook olayı yayar ve kanalı needs_reconnect olarak işaretler. Webhook'lar'a bak.

14 platformun tamamı

X (Twitter)

Instagram

Facebook

LinkedIn

TikTok

Threads

Bluesky

Mastodon

Pinterest

YouTube

Reddit

Discord

Slack

Telegram

Listmonk

OAuth callback URL'leri

Her OAuth platformu ${BASE_URL}/api/v1/auth/<platform>/callback altına bağlanır. OAuth uygulamalarınızı her sağlayıcıya kaydederken tam olarak bu URL'i yapılandırın. Tam liste Self-Hosting → OAuth Callback URL'leri'nde.

Bağlantıyı kesme

Bağlantılar listesi her kanalda bir Bağlantıyı Kes butonuna sahiptir. Bağlantıyı kesme:

1. Accounts kaydını siler (böylece gönderiler artık onu hedefleyemez).
2. Sağlayıcı üzerindeki token'ı iptal etmez — bunun için kullanıcı platformun yetkili uygulamalar sayfasına gider (örn. twitter.com/settings/connected_apps) ve Sosyabot'u doğrudan iptal eder.
3. Yalnızca bu kanalı hedefleyen zamanlanmış gönderileri iptal eder; çoklu hedefli gönderiler diğer kanallar için yayınlanmaya devam eder.

İlgili

Editör

OAuth Callback URL'leri

Webhook'lar