Başlangıç

Widget'ı sitene ekle, görünümünü kendine göre ayarla, ilk ziyaretçini karşıla.

Widget'ı sitene ekleme

Tek satırlık kodu sitene yapıştır; kurulum kendiliğinden doğrulanır.

Panelde Ayarlar → Kurulum sekmesindeki kodu kopyalayıp sitendeki her sayfanın </body> etiketinden hemen önce yapıştırman yeterli. Kod asenkron yüklenir, sayfanın açılma hızını etkilemez.

HTML
<script src="https://revochat.app/widget.js"
        data-revo-chat="SITE_ANAHTARIN" async></script>

Kodu yapıştırdıktan sonra siteni bir kez açman yeterli: widget senin alan adından ilk kez bağlandığında Kurulum ekranındaki adım kendiliğinden tamamlanır. Bunun için basman gereken bir düğme yok.

Bizim barındırdığımız sohbet sayfasını (revochat.app/chat/…) açmak kurulum sayılmaz — o adım yalnızca gerçekten senin sitende çalıştığını doğrular.
  • WordPress: Görünüm → Tema Dosya Düzenleyici → footer.php, ya da bir “header/footer kodu ekle” eklentisi.
  • Shopify: Online Store → Themes → Edit code → theme.liquid, </body> öncesi.
  • Wix / Squarespace: site ayarlarındaki “özel kod / custom code” alanına, tüm sayfalar için.
  • Next.js / React: kök layout'a <script> olarak, defer/async ile.

KVKK gereği widget, ziyaretçi balonu açana kadar kayıt tutmaz: canlı ziyaretçi listesinde görünmez, sayfa geçişleri izlenmez, tarayıcıya kalıcı kimlik yazılmaz. Balon yine görünür; ziyaretçi açtığı an sohbet normal başlar.

Çerez onayı aracı (Cookiebot, CookieYes, Google Consent Mode…) kullanıyorsan, ziyaretçi onay verdiğinde aşağıdaki çağrıyı yap; onay verenler için takip ve proaktif mesajlar sohbetten önce de çalışır. Onay geri alınırsa consent(false) kalıcı kimliği siler.

JavaScript
RevoChat.consent(true);   // onay verildi
RevoChat.consent(false);  // onay geri alındı

Üyelerini RevoChat.identify ile tanıtıyorsan kimlik doğrulamayı aç: Ayarlar → Kurulum → Kimlik doğrulama'dan anahtar oluştur, anahtarı yalnız sunucunda sakla ve e-postayı orada imzala. İmzalı e-posta panelde yeşil onay işaretiyle görünür, webhook'larda visitorEmailVerified: true gelir. İmzasız e-posta (ziyaretçinin kendi yazdığı dahil) kaydedilir ama doğrulanmamış sayılır.

Node.js
const hash = crypto.createHmac("sha256", KIMLIK_ANAHTARI).update(uye.email).digest("hex");
// sayfada:
RevoChat.identify({ email: uye.email, name: uye.ad, hash });
Onayı zaten aldığın sayfalarda (ör. üye girişi sonrası) script etiketine data-consent="granted" ekleyebilirsin. Herkesi onay beklemeden takip etmek istersen Ayarlar → Mesai ve yönlendirme → Gizlilik bölümündeki “Ziyaretçileri sohbetten önce de takip et” seçeneği var; bu durumda sitendeki çerez metni bunu kapsamalı.

Widget'ın görünümünü ayarlama

Renk, konum, karşılama mesajı, dil ve sık sorulan soru çipleri.

Ayarlar → Görünüm sekmesinden widget'ın tamamını kendi markana göre ayarlarsın. Değişiklikler kaydettiğin anda yayına girer, kodu tekrar yapıştırman gerekmez.

  • Ana renk: balon ve mesaj baloncuklarının markana uyması için.
  • Balon konumu: sağ alt (varsayılan) veya sol alt — sitende sağ altta başka bir öğe varsa.
  • Karşılama mesajı: sohbet açıldığında ziyaretçinin gördüğü ilk cümle.
  • Çevrimdışı mesajı: temsilci yokken ve bot kapalıyken gösterilir.
  • Widget dili: ziyaretçinin tarayıcı diline göre otomatik, ya da sabit (İngilizce, Türkçe, İspanyolca, Portekizce, Almanca, Fransızca, İtalyanca, Felemenkçe, Rusça).
  • Sık sorulan sorular: karşılama ekranında çip olarak çıkar; ziyaretçi tıklayınca sohbet o soruyla başlar.
Tek sayfada dili sabitlemek istersen script etiketine data-lang="en" ekleyebilirsin.

Widget'ını başka sitede kullanılmaya karşı koruma

İzinli alan adları listesiyle gömme anahtarını kendi sitelerine kilitle.

Gömme anahtarı sayfanın kaynağında herkese görünür — bu normaldir, gizli olması gereken bir şey değildir. Ama birinin anahtarı kopyalayıp kendi sitesinde kullanmasını istemiyorsan Ayarlar → Kurulum → İzinli Alan Adları listesini doldur.

  • Liste boşken kısıt yoktur (özellik isteğe bağlıdır).
  • Virgülle ayır: site.com, magaza.site.com
  • Joker destekli: *.site.com yazmak hem alt alan adlarını hem site.com'un kendisini kapsar.
  • Listede olmayan bir adresten gelen bağlantı reddedilir; ziyaretçiye hata gösterilmez, widget hiç çizilmez.

Sitesi olmayanlar için hazır sohbet sayfası

Kod yapıştırmadan, paylaşılabilir bir bağlantıyla destek verme.

Her sitenin, kendi başına açılan bir sohbet sayfası vardır. Bağlantıyı sosyal medya profiline, e-posta imzana veya QR koda koyabilirsin; ziyaretçi tıkladığında tam ekran sohbet açılır ve konuşma aynı gelen kutuna düşer.

Bağlantı
https://revochat.app/chat/SITE_ANAHTARIN