Sohbetler & satış
Sizinle konuşan insanlara yanıt verdiğiniz, gönderilerinizdeki ürünleri sattığınız ve AI asistanlarının kullanıcılarına alıntılayacağı içeriği yazdığınız tek bir yer.
Kimin işine yarar
- Çok sayıda DM, yorum ve bahsetme alan ve bunlara daha hızlı yanıt vermek isteyen markalar ve içerik üreticileri.
- Bir gönderiden doğrudan doğru ürüne yönlendirmek isteyen online satıcılar.
- İnsanlar AI asistanlarından öneri istediğinde görünmek isteyen ekipler.
Neler yapabilirsin
- Bağlı hesaplarınızdan gelen tüm DM, yorum ve bahsetmeleri uygulamalar arasında gezinmeden tek bir gelen kutusunda görün.
- AI'nın markanızın ses tonuyla gönderime hazır bir yanıt yazmasına izin verin; siz sadece kontrol edip gönderin.
- Reklamlarınızdaki riskli veya markaya uymayan yorumları otomatik yakalayın, böylece zararlı hiçbir şey fark edilmeden geçmesin.
- Bir fotoğraftaki doğru ürünleri etiketleyin ki takipçileriniz gösterdiğiniz şeyi bulabilsin.
- AI asistanları tarafından alıntılanmak üzere tasarlanmış SSS, karşılaştırma ve yanıt içerikleri yazın.
- İnsanlar konunuzla ilgili soru sorduğunda AI asistanlarının markanızın adını anıp anmadığını kontrol edin.
Nasıl başlanır
Gelen kutunuzu açın
Gelen DM, yorum ve bahsetmelerinizi tek listede görmek için Gelen Kutusu ekranına gidin. Gelen kutusu boşsa önce bir hesap bağlayın — Telegram sayfasına bakın.
AI ile yanıt taslağı oluşturun
Bir mesaj seçin ve AI'dan markanızın ses tonuyla bir yanıt isteyin. Kontrol edin, sonra gönderin. Telegram için yanıt doğrudan gider; diğer ağlarda taslak kaydedilir, böylece kendiniz gönderebilirsiniz.
Bir gönderide ürün etiketleyin
Mağaza ekranında ürün listenizi bir kez içeri aktarın, ardından AI'nın bir görselde hangi ürünleri etiketleyeceğini önermesine izin verin.
AI asistanları tarafından atıf alın
AEO ekranında bir konu etrafında içerik yazın, ardından AI asistanlarının markanızdan bahsedip bahsetmediğini görmek için bir kontrol çalıştırın.
TIP
AI yanıtları, ürün etiketleme ve AEO kredi kullanır. Bakiyenin nasıl çalıştığını görmek için Krediler sayfasına bakın.
Geliştiriciler için
Tüm uç noktalar çalışma alanı kapsamındadır ve kimlik doğrulanmış bir oturum gerektirir; ölçülen AI eylemleri çalışma alanının ai_credits sayacını düşer.
Birleşik Gelen Kutusu
Bağlı ağlardan gelen DM'ler, yorumlar ve bahsetmeler, InboundMessage modeline dayanan tek bir kuyrukta toplanır (/inbox sayfası). Her öğe network, kind (dm / comment / mention), thread_id, author_*, ham text ve bir status (open → drafted → replied / handled / hidden) taşır. Öğeler, kaynak external_id değerine göre çalışma alanı + ağ bazında tekilleştirilir.
İki gelen-veri yolu mevcuttur:
- Gerçek Telegram senkronizasyonu —
POST /engage/telegram/sync, kullanıcının bağlı her Telegram botundagetUpdatesçağırır ve yenimessage/channel_postgüncellemelerini içeri alır. Özel sohbetlerdm, grup/kanal gönderilericommentolur. - Genel gelen-veri —
POST /engage/ingest, herhangi bir kaynaktan tek bir gelen öğeyi kabul eder (networkvetextzorunlu).
POST /engage/:id/draft, çalışma alanının Brand DNA ses tonunu kullanarak öz ve markaya uygun bir yanıt üretir ve bunu ai_draft alanında saklar. Ağ API'si göndermeyi desteklediğinde POST /engage/:id/reply yanıtı geri gönderir — bugün Telegram teslimatı bağlıdır (bağlı bot token'ı + thread_id üzerinden); diğer ağlarda taslak kaydedilir ve öğe manuel gönderim için replied olarak işaretlenir.
| Metot | Uç Nokta | Amaç | Maliyet |
|---|---|---|---|
| GET | /engage/inbox?status= | Gelen öğeleri listele (en yeni önce, en fazla 200) | — |
| POST | /engage/ingest | Tek gelen öğeyi içeri al (network, text zorunlu) | — |
| POST | /engage/telegram/sync | Bağlı Telegram botlarından yeni güncellemeleri çek | — |
| POST | /engage/:id/draft | AI marka sesli yanıt taslağı | 1 kredi |
| POST | /engage/:id/reply | API izin verdiğinde yanıt gönder (bugün Telegram) | — |
| POST | /engage/:id/status | Durum ayarla (open/drafted/replied/handled/hidden) | — |
Reklam Yorum Koruması
İçeri alma sırasında, DM olmayan her öğe (yorumlar ve bahsetmeler) fail-closed Marka Güvenliği servisinden geçirilir. Güvenlik kontrolü başarısız olursa — ya da kontrolün kendisi hata verirse — öğe işaretlenir: bir safety_score ile safety_flagged: true. Fail-closed (kapalı arızalanma), bir koruma kesintisinin güvensiz bir reklam yorumunu hiçbir zaman sessizce geçirmemesi anlamına gelir; işaretli öğeler incelenmek üzere gelen kutusunda görünür ve gizlenebilir.
Alışveriş Editörü
Bir ürün kataloğu içeri aktarın, ardından Qevron görü (vision) bir görselde görünen ürünleri eşleştirsin ve ağ kurallarına uygun etiketler önersin (/shop sayfası).
POST /shop/import— satır içi CSV ya da JSON dizi metninden veya bir feed URL'sinden (güvenli şekilde çekilir, JSON veya CSV) içeri aktar. Satırlarexternal_id(veyatitle) ile katalogda upsert edilir; yanıtimported/updatedsayılarını döndürür. İçeri aktarma başına en fazla 5.000 satır.POST /shop/suggest-tags— görseli Qevron görü ile betimler, katalog başlıklarıyla eşleştirir ve etiketlenecek ürünleri ağın limitine kadar döndürür.
| Ağ değeri | Etiket limiti |
|---|---|
instagram_image | 5 |
instagram_carousel | 20 |
tiktok | 10 |
facebook | 30 |
| (varsayılan) | 5 |
suggest-tags, imageUrl veya imageFileId ile boş olmayan bir katalog gerektirir; 2 kredi harcar.
AEO İçerik Üretimi + Atıf Radarı
Yanıt Motoru Optimizasyonu (AEO), AI yanıt motorları tarafından atıf alınmak üzere tasarlanmış varlıklar üretir (/aeo sayfası).
POST /ai/aeo/generate— birtopic/targetQueryiçin üç varlık türünden birini üretir:comparison(markdown karşılaştırma tablosu + sonuç cümlesi),faq(6–8 yapılandırılmış Soru/Yanıt çifti) veyaanswer(gerçek-yoğun, alıntılanabilir 120–180 kelimelik yanıt). Her varlık schema.org JSON-LD (FAQ içinFAQPage, diğer hallerdeArticle) ve birllms.txtparçasıyla gelir. Çıktı Brand DNA ses tonunu kullanır. 5 kredi harcar.POST /ai/aeo/citation-check— Atıf Radarı,querydeğerinizi bir yanıt motorunun yapacağı gibi modele sorar, ardından markanızın adının geçip geçmediğini ve ne kadar belirgin olduğunu raporlar: marka, atıf yapılan markaların ilk 3'ünde yer alıyorsaprominencedeğerihigh, daha aşağıda atıf alıyorsalow, hiç yoksanoneolur. TümbrandsMentionedlistesi ve modelinansweryanıtı döndürülür. 2 kredi harcar.