Trendyol Soru Cevaplarını Kendi Sitenize Aktarma: Uçtan Uca Teknik Rehber

Trendyol mağazanızda satış yaptıysanız, ürün sayfalarınızın altında birikmiş bir bilgi hazinesi var demektir: müşterilerin sorduğu sorular ve sizin verdiğiniz yanıtlar. Bu içerik, sizin yazdığınız ürün açıklamasından çok daha değerlidir; çünkü müşterinin gerçekten ne merak ettiğini gösterir. Buna rağmen çoğu satıcıda bu veri Trendyol'un içinde kilitli kalır ve kendi sitesinin ürün sayfası bomboş durur. Oysa bu veri taşınabilir bir varlıktır ve asıl soru şudur: Trendyol soru cevapları siteye nasıl aktarılır?

Bu rehber, Trendyol soru-cevap verisini kendi e-ticaret sitenize taşımanın tamamını anlatıyor: API akışının gerçek detayları, ürün eşleştirme problemi, cevaplanmamış soruların yönetimi, moderasyon kuralları, schema işaretlemesinin 2026 itibarıyla değişen durumu ve Ikas, Shopify, Ticimax, T-Soft altyapılarındaki pratik farklar. Pazarlama dili değil, uygulanabilir adımlar.

Trendyol soru cevapları siteye nasıl aktarılır?

Kısa cevap dört adımdan oluşur: sorular ve yanıtlar Trendyol Satıcı API'sindeki soru-cevap servisinden çekilir, barkod üzerinden kendi kataloğunuzdaki ürüne bağlanır, moderasyondan geçirilir ve yalnızca yanıtlanmış olanlar ürün sayfasında yayınlanır. Bu dört adımın her birinin kendi tuzakları var; rehberin geri kalanı bunları tek tek açıyor. Önce şunu netleştirelim: bu içerik neden taşınmaya değer?

Trendyol soru-cevap verisi neden değerli?

Soru-cevap içeriğinin değeri üç ayrı yerden gelir ve bunları birbirine karıştırmamak gerekir.

1. İtiraz karşılama. Bir müşterinin sepete eklemeden önce takıldığı şey genelde ürünün özelliği değil, belirsizliktir: bu kablo şu modelle uyumlu mu, kumaş tüylenir mi, 42 beden dar mı kalır, fatura kesiliyor mu. Bu itirazlar sizin ürün açıklamanızda yoktur ama Trendyol sorularınızda vardır. Aynı soruyu sitenizde de görünür kılmak, satın alma kararındaki tereddüdü sayfayı terk etmeden çözer.

2. Uzun kuyruk arama trafiği. Müşteri soruları doğal dille yazılır ve tam olarak insanların Google'a yazdığı biçime benzer. Bu ürün bulaşık makinesinde yıkanır mı gibi bir soru, ürün açıklamanızın hiçbir zaman yakalayamayacağı bir aramadır. Bu içerik ürün sayfanızda gerçek HTML olarak bulunduğunda, sayfa çok daha geniş bir sorgu kümesine cevap verir hale gelir.

3. Destek yükünün azalması. Aynı sorunun WhatsApp'tan, telefondan ve iletişim formundan tekrar tekrar gelmesinin sebebi genelde cevabın sayfada olmamasıdır. Trendyol'da zaten yazdığınız yanıtları sitenize taşımak, yeni içerik üretmeden bu yükü düşürür.

Burada dürüst olmak gerekir: soru-cevap aktarımı tek başına sihirli bir dönüşüm artışı getirmez. Etkisi, sorular ilgili ürün sayfasında ve okunabilir biçimde durduğunda ortaya çıkar. Alakasız soruların yığıldığı bir blok, hiç olmamasından daha kötüdür.

Soru-cevap ile yorum aktarımı aynı şey değil

İki modül sık sık karıştırılır ama veri modelleri, moderasyon ihtiyaçları ve SEO davranışları farklıdır.

Pratikte iki modülü aynı anda kurmak mantıklıdır ama ayrı bileşenler olarak kurgulanmalıdır. Yorum tarafı için Trendyol Yorum Modülü, soru-cevap tarafı için Trendyol Soru Cevap Modülü aynı senkronizasyon altyapısını paylaşsa bile ürün sayfasında iki ayrı blok olarak durmalıdır.

Trendyol Satıcı API'sinde soru-cevap akışı nasıl çalışır?

Trendyol, satıcı entegrasyonları için soru-cevap uç noktalarını ayrı bir servis altında sunar. Soruları listelemek için kullanılan uç nokta şu biçimdedir:

GET https://apigw.trendyol.com/integration/qna/sellers/{sellerId}/questions/filter

Bu uç noktanın pratikte işinizi belirleyen davranışları şunlardır:

• Tarih penceresi sınırlıdır. Tarih parametresi göndermezseniz yalnızca son bir haftalık kayıtlar döner. startDate ve endDate gönderdiğinizde ise aralık en fazla iki hafta olabilir. Yani geçmiş üç yılın sorularını tek istekte çekemezsiniz; geçmişi ikişer haftalık pencerelerle taramanız gerekir.
• Sayfalama sıfırdan başlar. page parametresi 0 ile başlar, size varsayılan olarak 20 ve üst sınır 50 civarındadır. Sayfa sayısını yanıttaki toplam bilgisine göre döngüye almanız gerekir.
• Sıralama alanı seçilebilir. orderByField için oluşturma tarihi veya son değişiklik tarihi kullanılabilir. Artımlı senkronizasyonda son değişiklik tarihine göre sıralamak, yanıtı sonradan düzenlenen kayıtları yakalamanızı sağlar.
• Barkod ile filtreleme vardır. Tek bir ürünün sorularını yeniden çekmek istediğinizde tüm listeyi taramak zorunda kalmazsınız.

Yanıt gövdesinde her soru için soru metni, müşteri bilgisi, kullanıcı adının gösterilip gösterilmeyeceğini belirten bir bayrak, durum alanı, oluşturma zamanı, ürün adı, ürün görseli, ürün bağlantısı ve varsa yanıt nesnesi bulunur. Reddedilmiş bir yanıt varsa o da ayrı bir alanda döner.

Durum alanları ve her birinin anlamı

Sitenizde neyi yayınlayacağınıza karar veren asıl alan budur. Bu tabloyu entegrasyonun kalbi gibi düşünün.

Kural basit ama sıkça ihlal edilir: siteye yalnızca ANSWERED kayıtlar gider. Yanıtsız soruyu ürün sayfasına basmak, ziyaretçiye bu satıcı sorulara cevap vermiyor mesajı verir ve elinizdeki en iyi ikna aracını olumsuza çevirir.

Yanıt gönderme tarafı

Aynı servis, soruyu API üzerinden yanıtlamaya da izin verir:

POST https://apigw.trendyol.com/integration/qna/sellers/{sellerId}/questions/{id}/answers

Gövde tek bir metin alanından oluşur. Bilmeniz gereken sınırlar: yanıt metni en az 10, en fazla 2000 karakter olmalıdır; yasaklı kelime içeren yanıtlar reddedilir ve soru tekrar yanıt bekler duruma döner; yalnızca yanıt bekleyen durumdaki sorular yanıtlanabilir; yanıtlanmayan sorular birkaç iş günü içinde yanıtsız durumuna geçer.

Bu, tek yönlü bir aktarımın ötesine geçme imkanı verir. Kendi panelinizden yanıt yazıp hem Trendyol'a hem sitenize aynı anda işleyebilirsiniz. Yalnız burada dikkat: sitenizde yayınladığınız yanıt ile Trendyol'daki yanıt farklılaşırsa müşteri bunu fark eder. Tek kaynak ilkesini koruyun.

Senkronizasyon mimarisi: soru cevapları siteye adım adım nasıl aktarılır?

1. Kimlik bilgilerini güvenli saklayın. Satıcı API anahtarları asla tarayıcıya inen bir script içinde bulunmamalıdır. Çekme işlemi sunucu tarafında çalışan bir servis tarafından yapılmalı, ön yüz yalnızca kendi API'nizden veri okumalıdır. Bu, entegrasyonlarda en sık yapılan güvenlik hatasıdır.
2. Geçmişi ikişer haftalık pencerelerle tarayın. İlk kurulumda mağazanın açılış tarihinden bugüne kadar pencereleri döngüye alın, her pencerede sayfalama yapın. Bu işlem birkaç bin soru için dakikalar sürebilir; arka plan görevi olarak çalıştırın, kullanıcıyı bekletmeyin.
3. Artımlı senkronizasyon kurun. İlk yüklemeden sonra saatte ya da birkaç saatte bir son değişiklik tarihine göre kısa pencereler çekmek yeterlidir. Yanıtlar sonradan düzenlenebildiği için sadece yeni kayıtları değil, güncellenen kayıtları da yakalamalısınız.
4. Soru kimliği üzerinden upsert yapın. Kayıtları eklerken benzersiz anahtar olarak Trendyol soru kimliğini kullanın. Aksi halde her senkronizasyonda aynı sorular çoğalır. Durum alanı da her seferinde güncellenmelidir; bir yanıt reddedilirse sitedeki kaydı yayından kaldırmanız gerekir.
5. Ürün eşleştirmesini barkod üzerinden kurun. Bir sonraki bölümün konusu; entegrasyonun en zor kısmı burasıdır.
6. Moderasyon katmanını araya koyun. Çekilen kayıt doğrudan yayına gitmez; kural setinden geçer ve gerekiyorsa manuel onay kuyruğuna düşer.
7. Ön yüze hazır veri sunun. Ürün sayfası, Trendyol'a değil sizin kendi uç noktanıza sorar. Böylece hem hız kontrol edilebilir hem de Trendyol tarafındaki bir kesinti sitenizi etkilemez.
8. Hata ve limit yönetimi ekleyin. İstek limitine takıldığınızda üstel bekleme ile tekrar deneyin, kalıcı hataları loglayın. Sessizce boş dönen bir senkronizasyon, çalışan bir senkronizasyondan ayırt edilemezse aylarca fark edilmez.

En sinir bozucu kısım: ürün eşleştirme

Soruyu çektiniz, elinizde ürün adı ve barkod var. Peki bu soru sizin sitenizdeki hangi ürüne ait? Teoride kolay, pratikte şu durumlarla karşılaşırsınız:

• Barkod alanı boş ya da tutarsız. Bazı satıcılar Trendyol'a stok kodunu barkod alanına yazmıştır, kendi sitesinde ise farklı bir kod kullanır. Eşleşme oranı ilk denemede nadiren yüzde yüz çıkar.
• Varyant seviyesi farkı. Trendyol'da her renk-beden kombinasyonu ayrı bir barkoddur. Kendi sitenizde ise soru genelde ana ürün sayfasında gösterilmelidir. Yani varyant barkodunu ana ürüne yukarı doğru eşlemeniz gerekir. Aksi halde aynı ürünün siyah ve beyaz varyantına gelen sorular birbirinden habersiz iki listede kalır.
• Ürünü sitede yok. Trendyol'da sattığınız ama sitenizde listelemediğiniz ürünlerin soruları gelir. Bunlar için bir eşleşmedi kovası tutun ve ürün sonradan eklendiğinde otomatik bağlansın.
• Aynı ürünün birden fazla kaydı. Sitenizde mükerrer ürün varsa soru hangisine gidecek? Kanonik ürün kararını entegrasyon değil, sizin katalog düzeniniz vermelidir.

Uygulanabilir yöntem: önce barkod ile birebir eşleştirin, eşleşmeyenler için stok kodu ile ikinci tur deneyin, kalanları ürün adı benzerliğiyle öneri olarak panele düşürün ve son kararı insana bıraktırın. Otomatik isim eşleştirmeye tam güvenmek, soruların yanlış ürün sayfasında görünmesi gibi düzeltmesi zor bir hataya yol açar.

Cevaplanmamış soruların yönetimi

Aktarım projesinin beklenmedik faydası genelde burada ortaya çıkar. Trendyol panelinde yanıt bekleyen sorular kolayca gözden kaçar; oysa yanıt süresi sınırlıdır ve süresi dolan soru kalıcı olarak yanıtsız kalır.

Doğru kurgu şudur: yanıt bekleyen sorular siteye yayınlanmaz ama sizin yönetim panelinizde bir görev listesi olarak görünür. Bu listeye şunları ekleyin:

• Sorunun kaç saattir beklediği ve kalan süre
• Aynı ürüne daha önce verilmiş benzer yanıtlar (kopyalayıp uyarlamak için)
• Sık sorulan kalıplar için hazır yanıt şablonları
• Reddedilmiş yanıtların gerekçesiyle birlikte listesi

Hazır şablon kullanırken tek uyarı: birebir aynı metni onlarca soruya yapıştırmayın. Hem yasaklı kelime filtresine takılma riski artar hem de sitenize aktardığınızda ürün sayfalarınız birbirinin kopyası bloklarla dolar. Şablonu iskelet olarak kullanıp ürüne özel bir cümle ekleyin.

Soruları ürün sayfasında nereye koymalı?

Konumlandırma, aktarımın kendisi kadar önemlidir. Sahada işe yarayan yaklaşım:

1. Ana blok, ürün açıklamasının altında ve yorumların yanında. Sekmeli bir yapı kullanıyorsanız Sorular sekmesini Yorumlar sekmesinin hemen yanına koyun; kullanıcılar bu ikisini birlikte arar.
2. İlk 3-5 soru açık gelsin, gerisi genişletilebilir olsun. Otuz sorunun tamamını açık basmak sayfayı okunmaz hale getirir. Kapalı akordeon içinde tutulan içeriğin de arama motorları tarafından okunabildiğini unutmayın; sorun görünürlük değil, kullanıcı deneyimidir.
3. En değerli soruları yukarı taşıyın. Sıralamayı sadece tarihe bırakmayın. Uyumluluk, beden, malzeme, garanti gibi karar verdiren sorular en üstte olmalı. Basit bir anahtar kelime puanlaması bile kronolojik sıralamadan iyi sonuç verir.
4. Kategori ve ana sayfada göstermeyin. Soru-cevap, ürün kararı anına ait bir içeriktir. Listeleme sayfalarına taşımak sadece sayfa ağırlığı ekler.
5. Soru sayısı sıfırsa bloğu hiç basmayın. Boş bir Henüz soru yok kutusu, sayfada güven değil eksiklik hissi bırakır.

Performans tarafında iki kural: içerik ilk ekranın altında olduğu için tembel yükleme uygundur, ancak blok yüklenirken yer kaplayacak alanı önceden ayırın. Aksi halde içerik geldiğinde sayfa zıplar ve düzen kayması ölçütünüz bozulur. İkincisi, bu veriyi her sayfa açılışında Trendyol'dan değil kendi veritabanınızdan sunun; aradaki fark yüz milisaniyelerle ölçülür.

Moderasyon ve alakasız soru filtreleme

Trendyol soruları filtresiz haliyle yayınlanacak kıvamda değildir. Gerçek verilerde şu türler bolca bulunur:

• Kişisel veri içeren sorular. Telefon numarası, sipariş numarası, adres parçaları, e-posta. Bunlar hem KVKK açısından risklidir hem de sayfada anlamsız durur.
• Sipariş takibi soruları. Kargom nerede, ne zaman gelir gibi tek bir siparişe ait sorular başka müşteri için bilgi değeri taşımaz.
• Fiyat ve indirim pazarlığı. Sitenizdeki fiyat Trendyol fiyatından farklıysa bu sorular doğrudan kafa karıştırır.
• Rakip veya platform adı geçen sorular. Kendi sitenizde başka bir pazaryerinin adının geçmesi genelde istenmez.
• Tek kelimelik ve anlamsız sorular. Merhaba, ???, bilgi gibi girdiler.
• Tekrar edenler. Aynı ürüne otuz kez sorulan aynı soru, sayfada bir kez görünmelidir.

Pratik bir filtre seti şöyle kurulur: önce düzenli ifadelerle telefon, e-posta ve sipariş numarası kalıplarını yakalayıp otomatik gizleyin. Ardından yasak kelime listesiyle rakip ve platform adlarını işaretleyin. Minimum karakter eşiği koyun. Son olarak benzerlik karşılaştırmasıyla tekrar edenleri gruplayın ve en iyi yanıtı taşıyanı gösterin.

Türkçe metinde bir teknik ayrıntı: karşılaştırma yaparken metni küçük harfe çevirirken Türkçe karakter kurallarını gözetin. Standart küçültme işlemi büyük I harfini yanlış dönüştürerek kelime eşleşmelerini kaçırabilir. Bu, filtre listelerinin sessizce çalışmamasının klasik sebebidir.

Kişisel veri tarafında ek bir nokta: API yanıtında kullanıcı adının gösterilip gösterilmeyeceğini belirten bir bayrak gelir. Bu tercihe uyun. Müşteri adının görünmesini istemediği bir soruyu kendi sitenizde isimle yayınlamak, hem platform kurallarına hem veri koruma ilkelerine aykırıdır. En güvenli yaklaşım, ad-soyadı kısaltarak göstermek ya da hiç göstermemektir.

FAQPage schema ile işaretleme ve gerçek riskleri

Bu konuda internetteki rehberlerin çoğu güncelliğini yitirmiş durumda, o yüzden net konuşalım.

Google, FAQ zengin sonuçlarını 2023 Ağustos'ta yalnızca tanınmış kamu ve sağlık sitelerine daraltmış, ardından 2026 Mayıs'ında Google Arama'dan tamamen kaldırmıştır. Yani FAQPage işaretlemesi eklemek artık arama sonucunuzun altında açılır kapanır soru listesi çıkarmaz. Bunu vaat eden bir çözüm görürseniz güncel değildir.

Peki işaretleme tamamen anlamsız mı? Hayır, ama beklentiyi doğru kurmak gerekir:

• FAQPage hâlâ geçerli bir schema.org tipidir ve kullanılmayan yapısal veri sitenize zarar vermez; mevcut işaretlemeyi kaldırmanız gerekmez.
• Asıl faydası bugün makine okunabilirliğidir. Soru-cevap çiftlerini açıkça etiketlemek, içeriğinizi ayrıştıran yapay zeka tabanlı arama araçları ve dahili arama sistemleri için işi kolaylaştırır.
• Zengin sonuç beklentisiyle sayfaya alakasız soru doldurmak, karşılığında hiçbir görsel kazanç sağlamadan sayfanızı şişirir.

Bir tip seçimi tuzağı daha var: FAQPage, sayfanın sahibi tarafından sorulup yanıtlanan soru listeleri için tanımlanmıştır. Kullanıcıların soru sorup birden fazla kişinin yanıtladığı sayfalar için QAPage tipi vardır, ancak QAPage tek bir soruya odaklı sayfalar için tasarlanmıştır ve onlarca sorunun listelendiği bir ürün sayfasına doğal olarak oturmaz. Pratik sonuç: ürün sayfasındaki soru-cevap bloğunu işaretleyecekseniz, yanıtları sizin yazdığınız ve içeriğin kalıcı olduğu durumda FAQPage kullanmak savunulabilir; ama işaretlemeyi sayfada gerçekten görünen soru ve yanıtlarla birebir aynı tutun. Sayfada olmayan bir metni yapısal veride belirtmek, yapısal veri politikalarının açıkça yasakladığı bir uygulamadır ve manuel işlem riski taşır.

Özet tavsiye: işaretlemeyi ekleyin, sayfadakiyle birebir aynı tutun, moderasyondan geçmiş yalnızca yanıtlanmış soruları dahil edin ve zengin sonuç beklemeyin.

Altyapıya göre uygulama notları

Aynı entegrasyon dört altyapıda dört farklı şekilde hayata geçer. Fark, verinin sayfaya nasıl geldiğinde ortaya çıkar.

Genel kural: içeriği sunucu tarafında basabiliyorsanız basın. Shopify'da metafield, T-Soft'ta tema dosyası bu imkanı verir. JavaScript ile enjekte edilen içerik de taranabilir, ancak sunucu tarafında basılan HTML hem daha hızlıdır hem de hata payı düşüktür. Ikas ve Ticimax tarafında pratikte script yaklaşımı daha yaygındır; bu durumda içeriğin geç yüklenmesinden kaynaklı düzen kaymasını önlemeye özen gösterin.

Kurulumdan sonra neye bakmalı?

Modülü kurup unutmak yaygın hatadır. İlk otuz gün şu dört ölçümü takip edin:

1. Eşleşme oranı. Çekilen sorulardan kaçı bir ürüne bağlandı? Yüzde 90'ın altındaysa barkod eşlemesinde sorun var demektir.
2. Yayın oranı. Bağlananlardan kaçı moderasyondan geçip yayınlandı? Çok düşükse filtreniz agresif, çok yüksekse gevşektir.
3. Blok etkileşimi. Soru bloğunu açan ziyaretçi oranı ve sayfada kalma süresi. Etkileşim yoksa konumlandırma yanlıştır.
4. Yanıt bekleyen soru sayısı. Bu sayı sürekli artıyorsa modül çalışıyor ama süreç çalışmıyordur; bu tek başına düzeltilmesi en kârlı metriktir.

Bir de gözle kontrol edin: rastgele beş ürün sayfası açıp sorulara okuyucu gözüyle bakın. Alakasız bir soru gördüyseniz filtreye bir kural daha eklenmesi gerekiyor demektir.

Sonuç: soru cevapları siteye aktarırken neye dikkat etmeli?

Trendyol soru cevaplarını siteye aktarmak teknik olarak orta zorlukta, ama içerik disiplini açısından ciddi bir iştir. API tarafı birkaç uç noktadan ibarettir; asıl işi ürün eşleştirme, moderasyon ve konumlandırma belirler. Yalnızca yanıtlanmış soruları taşıyan, kişisel veriyi temizleyen, doğru ürüne bağlayan ve karar verdiren soruları öne çıkaran bir kurulum, ürün sayfalarınızı hem müşteri hem arama motorları için belirgin biçimde daha bilgilendirici hale getirir.

Kendi ekibinizle kurmak isterseniz bu rehberdeki adımlar yeterlidir. Hazır çalışan bir kurulum tercih ederseniz STools Digital tarafındaki Trendyol Soru Cevap Modülü Ikas, Shopify, Ticimax ve T-Soft altyapılarında aynı akışı sağlar. Sorularınız için destek@stools.digital adresinden ulaşabilirsiniz.