Dokümantasyon

Perla'yı kliniğinizin web sitesine bağlamak

Kayıttan sitenizde çalışan bir sohbete kadar. Adım adım, her yaygın platform için ekran görüntüleri ve örneklerle.

≈ 10 dakikaGeliştirici gerekmez

Nasıl çalışır

Herhangi bir şey yapıştırmadan önce anlaşılmaya değer üç şey.

Klinik profili tek doğru kaynaktır

Saatler, adres, hekimler, fiyatlarıyla hizmetler, anlaşmalı kurumlar ve devretme kurallarınız. Perla hastalara yalnızca bu verilerden yanıt verir ve hiçbir şey uydurmaz. Profil ne kadar doluysa yanıtlar o kadar keskindir.

Anahtar, widget'ı kliniğinize bağlar

Her klinik pk_live_… biçiminde kendi anahtarını alır. Bu anahtar herkese açıktır: sitenizin kaynağında durur ve bunun sakıncası yoktur. Anahtar tam olarak tek bir şeye izin verir — kliniğiniz adına sohbet etmeye, başka hiçbir şeye.

Widget sitenizden yalıtılmıştır

Sohbet, getperla.eu üzerinden sunulan kendi penceresinde (bir iframe içinde) yüklenir. Böylece sitenizin CSS'i sohbeti asla bozamaz, sohbetin CSS'i de sitenize asla dokunamaz. Tek satır kod ve iş biter.

Adım adım

Gerçek arayüzden ekran görüntüleri. Turuncu, tıklanacak yeri gösterir.

01

"Ücretsiz başlayın"a tıklayın

getperla.eu adresini açın ve sağ üst köşedeki düğmeye basın. Başlamak için kart gerekmez.

"Ücretsiz başlayın"a tıklayın
Perla ana sayfası — kayıt düğmesi sağ üstte.
02

Klinik hesabınızı oluşturun

Klinik adınızı, bir iş e-postasını ve en az 8 karakterlik bir parolayı girin. Ad, hastalarınızın gördüğü sohbet başlığında görünecek, bu yüzden insanların okumasını istediğiniz gibi yazın.

Klinik hesabınızı oluşturun
Kayıt formu: klinik adı, e-posta, parola.
03

Profili doldurun ve anahtarınızı kopyalayın

Giriş yaptıktan sonra Genel Bakış sayfasına düşersiniz. Dört kontrol maddesini tamamlayın — profil, çalışma saatleri, hekimler, hizmetler ve fiyatlar. Sonra sayfanın en altına inin: Entegrasyon anahtarı bloğunu orada bulacaksınız. Kopyala'ya basın.

Profili doldurun ve anahtarınızı kopyalayın
Panel → Genel Bakış. Anahtar sayfanın en altındadır.

Yayına almadan önce profili doldurun

Fiyat listesi veya saatler boşsa, Perla bir sayı uydurmak yerine hastaya dürüstçe resepsiyonun teyit edeceğini söyler. Bu doğru davranıştır, ama eksiksiz bir profille çok daha iyi sonuç alırsınız.

Kodu sitenize yapıştırmak

Platformunuzu seçin, tam olarak nereye gittiğini göstereyim.

Platformunuz

  1. 1Sayfa dosyanızı açın — genellikle index.html veya ortak bir şablon (footer, layout).
  2. 2Kodu doğrudan kapanış </body> etiketinden önce yapıştırın.
  3. 3Birden çok sayfanız varsa ve ortak şablon yoksa, kodu her sayfaya ekleyin.
  4. 4Kaydedin ve dosyaları sunucunuza yükleyin.
  5. Ortak bir footer dosyanız varsa oraya bir kez yapıştırmanız yeterli; sohbet her yerde görünür.
index.html
<!-- Perla -->
<script
  src="https://getperla.eu/widget.js"
  data-perla-key="pk_live_xxxxxxxxxxxxxxxxxxxxxxxx"
  defer
></script>

pk_live_… yerine panelinizdeki anahtarı yazın. Aynı kod sitenin her sayfasına eklenir.

Widget seçenekleri

Doğrudan script etiketi üzerinde ayarlanır.

ÖznitelikZorunluNe yapar
data-perla-keyEvetPanelinizdeki klinik anahtarınız. Bu olmadan widget başlamaz.
data-perla-langHayırSohbet arayüzünün dili: tr, uk, cs, en, ru veya de. Yazmazsanız klinik profilinizdeki ilk dil kullanılır. Yanıtların kendisini etkilemez — Perla her zaman hastanın yazdığı dilde yanıt verir.
deferHayırOlduğu gibi bırakın. Widget böylece ana içerikten sonra yüklenir ve sayfanın görüntülenmesini yavaşlatmaz.

Google Analytics'te dönüşüm takibi

Sohbet, Perla'nın kendi alan adındaki bir iframe içinde çalışır, bu yüzden analitiğiniz içini göremez. Widget bu nedenle önemli eylemleri sayfanızın kendisine bildirir — dataLayer'a ve varsa gtag'e. Bizim tarafımızda etkinleştirilecek bir şey yok; olaylar baştan itibaren tetiklenir.

perla_chat_openedHasta sohbet penceresini açtı
perla_message_sentHasta ilk mesajını gönderdi — her satırda değil, görüşme başına bir kez
perla_booking_requestHasta ad ve telefon numarası bıraktı — dönüşüm budur

GA4'te Google Tag Manager ile kurulum

  1. 1GTM'de bir tetikleyici oluşturun: Trigger → New → Custom Event, Event name alanına perla_booking_request.
  2. 2Bir etiket oluşturun: Tag → New → Google Analytics: GA4 Event, yapılandırma etiketinizi seçin, Event Name perla_booking_request.
  3. 3Tetikleyiciyi etikete bağlayın ve konteyneri yayımlayın (Submit → Publish).
  4. 4GA4'te Admin → Events bölümünü açın, ilk talepten sonra olayın göründüğünü doğrulayın ve ardından anahtar olay olarak işaretleyin.

Google Ads'e taşımak

  1. 1perla_booking_request olayını GA4'te anahtar olay olarak işaretleyin — aksi hâlde Ads onu göremez.
  2. 2Google Ads'te: Goals → Conversions → Import → Google Analytics 4 → perla_booking_request seçin.
  3. 3İlk gerçek talebi bekleyin: biri gerçekleşene kadar olay içe aktarma listesinde görünmez.

Olaylar hiçbir kişisel veri taşımaz — ad yok, telefon numarası yok, mesaj metni yok. Yalnızca olay adı ve bir görüşme kimliği; böylece bir dönüşümü panelinizdeki talebe eşleyebilirsiniz.

Çalıştığını kontrol etmek

Kodu yapıştırdıktan üç dakika sonra.

  1. 1

    Düğme belirdi

    Kliniğinizin sitesini yeni bir sekmede açın. Sağ alt köşede robot simgeli yuvarlak bir düğme görünmeli. Kodu yeni yapıştırdıysanız Ctrl+Shift+R (Mac'te Cmd+Shift+R) ile sayfayı zorla yenileyin.

  2. 2

    Sohbet sizin verilerinizle yanıt veriyor

    Düğmeye tıklayın ve profilinizde olan bir şeyi sorun: "Diş temizliği ne kadar?" veya "Cumartesi açık mısınız?". Yanıt, girdiğiniz bilgiyle örtüşmeli.

  3. 3

    Görüşme panelde görünüyor

    Panele dönün, Görüşmeler bölümüne bakın. Test sohbetiniz orada olmalı. Randevu almayı da deneyin — ad ve telefon verin, aynı yerde bir talep belirecek.

Perla neyi yapar, neyi yapmaz

Hastaların önünde sürpriz olmasın diye açıkça yazıyoruz.

Bugün çalışıyor

  • Fiyat, çalışma saatleri, adres, hekimler ve anlaşmalı kurumlar hakkındaki soruları yanıtlar — profilinizden
  • Hastanın dilini konuşur: Türkçe, İngilizce, Rusça, Ukraynaca, Çekçe, Almanca
  • Randevu talebi toplar: ad, telefon ve yaklaşık bir saat, ve bunu panelinizde gösterir
  • Görüşmeyi kendi kurallarınıza göre resepsiyonunuza devreder — örneğin şiddetli ağrı veya bir şikâyet
  • Resepsiyonun kapalı olduğu geceler ve hafta sonları dâhil, günün her saati çalışır

Bilinçli olarak yapmaz

  • Takviminize yazmaz — talebi bir insan telefonla teyit eder
  • Teşhis koymaz ve tedavi önermez: bu hekimin işidir, resepsiyonun değil
  • Listenizde olmayan bir fiyatı söylemez — bunun yerine resepsiyonun teyit edeceğini söyler
  • Online ödeme almaz

Sık sorulan sorular

Anahtarı sitemin kodunda tutmak güvenli mi?+

Evet. pk_live_… herkese açık bir anahtardır ve tıpkı Google Maps veya Stripe'ın yayımlanabilir anahtarı gibi sayfa kaynağında görünmek üzere tasarlanmıştır. Tam olarak tek bir şeye izin verir: kliniğiniz adına sohbet etmeye. Görüşmelerinizi okuyamaz, profilinizi değiştiremez, panelinize giremez. Ayrıca kimsenin kötüye kullanmaması için dakika başına mesaj sınırı vardır.

Widget sitemi yavaşlatır mı?+

Hayır. Dosya birkaç kilobayttır ve defer özniteliğiyle yüklenir — yani sayfa ziyaretçi için zaten görüntülendikten sonra. Sohbetin kendisi ayrı bir pencerede yüklenir ve sitenizi hiçbir zaman engellemez.

Widget görünmedi. Şimdi ne yapmalıyım?+

Üç şeyi kontrol edin. Birincisi: kod HEAD içinde değil, kapanış </body> etiketinden önce olmalı. İkincisi: Tilda ve Webflow'da kodu kaydettikten sonra siteyi ayrıca yayımlamanız gerekir. Üçüncüsü: sayfayı zorla yenileyin (Ctrl+Shift+R). Bu da işe yaramazsa tarayıcı konsolunu (F12) açın ve [Perla] ile başlayan bir mesaj arayın.

Düğmenin rengini değiştirebilir miyim?+

Evet. Panelde Widget bölümünü açın ve bir renk seçin — paletten veya kendi renginizi. Kod değişikliği olmadan sitenize hemen uygulanır.

Bir klinik için widget'ı birkaç siteye koyabilir miyim?+

Evet, tek anahtar istediğiniz sayıda sayfa ve alan adında çalışır. Tüm görüşmeler aynı panele düşer.

Hasta verileri nerede saklanıyor?+

Görüşmeler ve randevu talepleri Avrupa Birliği'ndeki sunucularda saklanır. Perla hastadan asla kart numarası, kimlik belgesi veya tıbbi geçmiş istemez — yalnızca geri arama için ad ve telefon numarası.

Bir şey oturmadı mı?

Bize yazın — birlikte çözeriz ve gerekirse widget'ı sizin için kurarız.