SSS — kendi kendine çözüm

Aşağıdaki sorunların ortak yanı: çözüm kodda değil, sizin tarafınızdaki bir ayarda ya da dış hesabın (Google, Microsoft, Shopify…) yapılandırmasındadır. Çoğunu birkaç dakikada kendiniz halledebilirsiniz. Genel arıza belirtileri için Sorun giderme'ye bakın.

OneDrive / OneNote / SharePoint bağlanmıyor · "AADSTS50020" · kişisel hesap

Neden: Haziran 2024'ten beri Microsoft, bir uygulama kaydı için bir Entra (Azure AD) dizini ister; kişisel Microsoft hesapları (MSA/OneDrive) tek-kiracılı bir uygulamayı reddeder.

• portal.azure.com → bir Entra (Azure AD) dizini oluşturun.
• App registrations → New registration; hesap türü olarak "Herhangi bir kuruluş dizini + kişisel Microsoft hesapları" (multitenant + personal) seçin.
• Bir Client ID ve bir Client secret oluşturun.
• SemAgent'ta Kendi uygulamanızla bağlan panelinde Client ID/Secret'ı girin ve Azure Dizin ID = common yazın. (Belirli bir dizin ID yazmak uygulamayı tek-kiracılıya zorlar → kişisel hesap reddedilir.)
• Panelde gösterilen Redirect URI'yi uygulamanıza birebir ekleyin.

Bağlanırken "redirect_uri_mismatch" hatası

Neden: OAuth uygulamanıza kayıtlı yönlendirme URI'si SemAgent'ınkiyle birebir aynı değil.

Çözüm: SemAgent bağlan panelindeki salt-okunur Redirect URI'yi kopyalayın ve uygulamanızın "authorized redirect URIs" alanına birebir yapıştırın — sondaki /, http/https gibi en küçük fark bile hataya yol açar.

Google Drive bağlı ama 0 doküman / seçtiğim dosyalar indekslenmiyor

Neden: "Yalnız seçtiğim dosyalar (drive.file)" modu, Picker'ı çağıran uygulamanın kendi projesinde Google Picker API'sinin açık olmasını gerektirir; değilse seçilen dosyalar 404 döner.

Çözüm: Bozuk connector'ı silin ve "Tüm Drive (drive.readonly)" moduyla yeniden bağlanın (varsayılan, en güvenilir, Picker gerekmez). drive.file'ı yalnız kendi Google Cloud projenizde Picker API'yi açtıysanız kullanın.

Google "uygulama doğrulanmadı" uyarısı veriyor

Neden: Kendi OAuth uygulamanız "Testing" (Test) modunda.

Çözüm: Bu beklenen ve yeterli bir durumdur — merkezi Google doğrulaması / CASA gerekmez. Google Auth Platform → Audience → Test users'a kendi Google hesabınızı ekleyin. Uygulama "Testing"'de kalabilir.

Notion bağlı ama içerik gelmiyor

Neden: Integration'ın ilgili sayfalara erişimi yok.

Çözüm: Notion'da sayfayı/veritabanını açın → "..." → Bağlantılar (Connections) → integration'ınızı ekleyin. Sayfayı integration ile paylaşmak zorunludur; aksi halde integration hiçbir şey görmez.

Zendesk bağlanmıyor

Neden: Parola kullanılıyor; Zendesk bir API token ister.

Çözüm: Zendesk Admin → Apps and integrations → APIs → Zendesk API → Token access'i açın; sonra e-posta + API token ile bağlanın. İçerik türünü seçin: Yardım Merkezi makaleleri / talepler (tickets) / ikisi.

Veritabanı (PostgreSQL/MySQL/SQL Server) bağlanamıyor / zaman aşımı

Neden: Veritabanı güvenlik duvarınız SemAgent'ın sunucu IP'sini engelliyor.

Çözüm: SemAgent'ın çıkış (egress) IP'si 173.212.244.210'a gelen bağlantıya izin verin (güvenlik duvarı / pg_hba.conf / bulut "authorized networks") + portu açın (5432/3306/1433) + güvenlik için salt-okunur bir kullanıcı oluşturun.

Shopify: erişim token'ım (shpat_…) artık çalışmıyor

Neden: Shopify, statik özel-uygulama admin token üretimini kaldırdı.

Çözüm: Yeni Client Credentials yöntemiyle bağlanın (özel uygulamanızdan Client ID + Secret) — panelde E-Ticaret sekmesinden yeniden bağlayın.

WooCommerce: API anahtarlarını nereden alırım?

Çözüm: WooCommerce → Ayarlar → Gelişmiş → REST API (WordPress Ayarları DEĞİL) → Anahtar ekle → izin: Okuma → Consumer Key + Consumer Secret'ı SemAgent'a yapıştırın. Kısayol: /wp-admin/admin.php?page=wc-settings&tab=advanced&section=keys.

Ajan e-posta gönderemiyor / "smtp yapılandırılmamış"

Neden: SMTP/Gmail bağlı değil ya da hesap parolası kullanılıyor.

Çözüm: E-posta (SMTP) veya Gmail (IMAP+SMTP) bağlayın; Gmail için normal parola değil, bir Uygulama Şifresi kullanın (Google hesabınızda 2 Adımlı Doğrulama açık olmalı).

Widget eski cevapları gösteriyor · kaynak satırı kayboluyor

Neden: Tarayıcı eski widget'ı önbelleğe almış.

Çözüm: Sert yenileme yapın (Ctrl/Cmd + Shift + R). Cloudflare widget HTML'ini önbelleğe almaz; sert yenileme en güncel sürümü getirir.

Tarama (crawl) boş dönüyor / site engelliyor (403)

Neden: Hedef site botları engelliyor (ör. Cloudflare).

Çözüm: O kaynak için JS-render / stealth tarama seçeneğini açın (Cloudflare korumalı sayfaları çözer). Az sayfa alındıysa Sorun giderme'deki sayfa-limiti/URL-filtresi maddesine de bakın.