Listmonk
Listmonk instance'ına API key veya basic auth. Sosyabot bir kullanıcı olarak değil, servis hesabı olarak hareket eder — aynı kimlik bilgileri her çalışma alanı kullanıcısına hizmet verir.
Kimlik bir bakışta
| Alan | Değer |
|---|---|
| Kimlik modeli | OAuth 2.0 |
| Gerekli ENV | LISTMONK_BASE_URL, LISTMONK_API_KEY, LISTMONK_USERNAME, LISTMONK_PASSWORD |
| Callback URL | ${BASE_URL}(callback yok — seçili list ID'leriyle POST /api/v1/social/listmonk/connect) |
| Scope'lar / izinler | Listmonk admin API: lists:read, campaigns:write |
| Otomatik token yenileme | Hayır — süresi dolduğunda manuel reconnect |
ENV detayları
Ya LISTMONK_API_KEY (tercih edilen) ya da hem LISTMONK_USERNAME + LISTMONK_PASSWORD ver. LISTMONK_BASE_URL zorunludur ve Listmonk admin API kökünü gösterir.
Nasıl bağlanılır
LISTMONK_*ENV'i yapılandır (ve.env'i değiştirdiysen./service.sh'i yeniden başlat).- Bağlantılar → Listmonk → Bağlan'ı aç.
- Yayın yapmak için bir veya daha fazla list seç.
Token yenileme
Statik kimlik bilgileri. ENV'i (veya admin-panel override'ı) güncelleyip API sürecini yeniden başlatarak rotasyon yap.
Notlar
- Listmonk tüm çalışma alanı kullanıcıları tarafından paylaşılan global bir entegrasyondur — kullanıcı bazlı OAuth yoktur. Çalışma alanındaki bir Listmonk kanalı bağlayan herkes yapılandırılmış kimlik bilgilerini yeniden kullanır.
- Connect formu, mevcut list'leri
GET /api/v1/social/listmonk/listsile listeler ve birini veya birkaçını seçmene izin verir. Kanal IDlistmonk:<list-id-1>,<list-id-2>'dir. - Yayın,
content_type: html(varsayılan) ile bir kampanya oluşturur vePUT /api/campaigns/<id>/statusilerunningstatüsünde kuyruğa alır.
Sorun giderme
Kanal needs_reconnect gösteriyorsa, access token Listmonk tarafından reddedilmiştir. Yaygın sebepler:
- Kullanıcı Sosyabot'un yetkilendirmesini platform üzerinden iptal etmiştir.
- Platform token'ı geçersiz kılmıştır (şifre değişikliği, güvenlik olayı).
- OAuth uygulama kimlik bilgileriniz değişmiştir ve mevcut token'lar artık eşleşmiyordur.
Yukarıdaki bağlantı akışını yeniden çalıştır. Çalışma alanı genelinde checklist için Sorun Giderme'ye bak.