# Ofis tarayıcısı

Ajanlar, ofisteki bir bilgisayarda gerçek bir Chrome tarayıcısı kullanabilir: emlak portallarını okur, bir şeyler araştırır ve izin verdiğiniz sitelerde CRM'inizde bir insan gibi çalışır. Portallarda buldukları **ilan** olarak kaydedilir ve müşterilerle eşleştirilir.

## Nasıl çalışır

![Şema: Nasıl çalışır](/docs-diagrams/faf284fb88bda3b6.png)

- **Eklenti**, her zaman açık bir ofis bilgisayarındaki Chrome profilinde çalışır. Sunucuya dışarıya doğru bağlanır; bu yüzden bilgisayarda açılacak bir bağlantı noktası yoktur.
- **Her ajan çalışması kendi sekmesini alır.** Çalışma bitince sekme kapanır. Sizin kendi sekmelerinize hiç dokunulmaz.
- **Kurallar eklentinin içinde uygulanır,** ajanların değiştiremeyeceği yerde: hız, salt okunur siteler, gizli anahtar yok.
- **Girişler bilgisayarda kalır.** Bir site giriş istiyorsa bir kişi o Chrome profilinde bir kez oturum açar; ajanlar sonra o oturumu kullanır. Ajanlar parola yazmaz.

## Kurulum

1. **Settings → Browser → Download the extension.** Paket, 30 dakika geçerli, tek kullanımlık bir eşleştirme kodu içerir. Yeni bir indirme eski paketleri kullanılamaz yapar.
2. Ofis bilgisayarında (Chrome 116 veya daha yeni), mümkünse yalnızca Lumate için kullanılan **ayrı bir Chrome profilinde**:
   1. paketi açın (unzip);
   2. `chrome://extensions` sayfasını açın ve **Developer mode** seçeneğini açın;
   3. **Load unpacked** düğmesine tıklayın ve açtığınız klasörü seçin.
3. Eklenti kendiliğinden eşleşir. Settings → Browser, bilgisayarın adıyla birlikte **Online** gösterir.
4. Bilgisayarı açık ve Chrome'u çalışır tutun. Eklenti uyku veya ağ kopmasından sonra kendiliğinden yeniden bağlanır. Bilgisayar boştayken Chrome eklentiyi uyutabilir; eklenti her 30 saniyede uyanır ve yeniden bağlanır.

**Eklentiyi güncellemek için:** yeni bir paket indirin, eski eklentiyi `chrome://extensions` içinde kaldırın ve yenisini yükleyin.

**Bağlanmış bir bilgisayarda** (2.15.0'dan itibaren): ofis bilgisayarında bu sunucuya bağlı Lumate çalışıyorsa ve
bilgisayar bağlanmışsa (Settings → **Linked PCs**), paket indirmek gerekmez:
1. Settings → Browser → **On a linked PC**: bilgisayarı seçin ve **Use this PC**'ye basın.
2. Bilgisayar eklentiyi, tek kullanımlık bir eşleştirme koduyla, o bilgisayardaki Lumate verisine
   (`%LOCALAPPDATA%\Lumate\data\extension`) yazar ve ofis tarayıcısının Chrome profilini açar.
3. Yalnızca ilk sefer, o bilgisayardaki biri eklentiyi yükler (Chrome bunu hiçbir programa izin vermez): Lumate orada
   klasörü gösteren **Server connection** sayfasını açar. Chrome'da (mümkünse yalnızca Lumate için bir profilde)
   `chrome://extensions` sayfasını açın, **Developer mode**'u açın, **Load unpacked** ile o klasörü seçin.

Bundan sonra eklenti o bilgisayardaki Lumate ile güncellenir ve kendiliğinden yeniden eşleşir: bilgisayarı açıkken 10
dakika çevrimdışı kalırsa sunucu yeni bir kod gönderir. Bilgisayar yeniden başlayınca Lumate ofis tarayıcısını kendisi
yeniden açar. Bilgisayarın bağını kaldırmak (Settings → Linked PCs) ofis tarayıcısını ondan alır.

**Lumate Local'da** indirilecek bir paket ve elle güncellenecek bir şey yoktur: **Prepare the extension**,
eklentiyi Lumate'in veri klasöründeki bir klasöre (`data\extension`) koyar ve o klasörü bir kez yüklersiniz. Lumate'in
her güncellemesi o klasördeki eklentiyi günceller ve eklenti kendini yeniden yükler. Lumate orada taze bir eşleştirme
kodu tutar; bu yüzden eklenti yeniden başlatma veya güncellemeden sonra kendiliğinden yeniden bağlanır ve **Reconnect**
hiçbir şey yüklemeden onu yeniden eşleştirir. `app\<version>\` altındaki bir klasörü asla yüklemeyin: bağlanamaz. Bkz.
[Lumate Local](/tr/docs/install-windows#the-office-browser).

## Ajanlar neler yapabilir

| Nerede | Ajanlar yapabilir |
|---|---|
| **Herhangi bir web sitesi** | Sayfa açmak, okumak, kaydırmak, bağlantıları izlemek, aramak, filtre kullanmak, sıralamak, sayfaları değiştirmek |
| **İzinli siteler** (Settings → Browser → Allowed sites) | Bir kişinin formda yaptığı her şey: alanları doldurmak, seçenek seçmek, Save, Send veya Submit düğmesine basmak |
| **Hiçbir yerde** | Parola, ödeme veya dosya alanlarına yazmak; dosya yüklemek; `file://`, `chrome://` veya web olmayan diğer sayfaları açmak; ofis ağını (localhost, 192.168.x.x, 10.x.x.x, `.local`) açmak, o sunucu izinli bir site değilse |

**İzinli olmayan sitelerde** (salt okunur) eklenti şunları reddeder:
- kişisel veri alanlarına yazmak (ad, e-posta, telefon, mesaj);
- gönderen, randevu alan, kaydeden, paylaşan, kayıt yapan veya oturum açan her düğme;
- veri gönderen her form.

Arama ve filtreleme yine çalışır.

**İzinli siteler:**
- satır başına bir sunucu adı, örneğin `yourcompany.bitrix24.com`;
- bir sunucu adı alt alan adlarını da kapsar;
- en fazla 50.

Bir ajanın izinli bir sitede yaptığı her değişiklik, sayfa ve alanla birlikte Etkinlik günlüğüne kaydedilir.

**LinkedIn'de** izin verilen yerlerde bile her değişikliği bir kişi onaylar (aşağıda [LinkedIn](/tr/docs/office-browser#linkedin)).

## Hız

Portallar robot değil, bir insanın hızını görsün diye:
- bir sekmede sayfa yüklemeleri arasında 2–5 saniye;
- bir sitede dakikada en fazla 12 sayfa yüklemesi.

Bir sitenin sınırına ulaşılırsa ajana yavaşlaması söylenir. Bir komut 45 saniye sonra zaman aşımına uğrar.

## LinkedIn

LinkedIn Kullanıcı Sözleşmesi (bölüm 8.2) botlara ve veri kazımaya izin vermez ve LinkedIn otomatik görünen bir hesabı
kısıtlayabilir. Bu kurallar sabittir ve ajanların erişiminin dışındadır:

- **Bir insanın hızı:** en fazla 10 saniyede bir sayfa (tüm sekmeler birlikte), saatte 40 ve günde 150; adresin nasıl
  yazıldığına bakılmaksızın (`linkedin.com.`, `lnkd.in` bağlantıları). Orada açılan bir sayfa ve orada onaylanmış bir
  tıklama ya da Enter, çalışmadan önce sayılır (bir kez, açtığı sayfayla birlikte; sayfanın harekete geçmeden reddettiği
  bir eylem sayılmaz). Başka yoldan ulaşılan bir sayfa (kısa bağlantı, yönlendirme, geri gitme) ulaştığında sayılır,
  sınırı aşsa bile: yüklenmiştir, bu yüzden sekme ondan hemen çıkar ve LinkedIn'de yer açılana kadar bağlantının
  bulunduğu yerden (kısa bağlantının sitesi ya da bulunduğu sayfa) başka bir şey yüklenmez; ajana hangisi olduğu
  söylenir. LinkedIn sınırındayken sayfalar tek tek yüklenir ve bir ajanın komutları her zaman art arda çalışır.
  Sekmenin terk ettiği bir sayfadan geri gitmek reddedilir (o sayfayı yeniden yüklerdi). Eklenti sayıları ve bekleyenleri
  yeniden başlatmada da korur ve bir sayı okunamıyor ya da tutulamıyorsa LinkedIn'de durur (tutulamayan bir sayı yalnızca
  tarayıcı tutulabilmeden önce yeniden başlarsa kaybolur).
- **Her değişiklik onaylanır:** orada bir tıklama, yazma veya seçim önce ajanın konuşma dizisinde ve gelen kutusunda
  (**Inbox**; rozetinde sayılır) bir karta dönüşür; yazılacak sözlerle ve yazmanın Enter'a da basıp basmadığıyla (bir
  mesaj kutusunda bu gönderir). Bir yönetici onaylar ya da reddeder ve ajana söylenir: o konuşmadaki sonraki çalışması
  aynı sekmede, aynı sayfada devam eder. Onaylanan bir değişiklik bir kez, yarım saat içinde, aynı konuşmada, istendiği
  sayfada ve yalnızca onaylanan öğe olarak adlandırılmış bir öğede çalışır: tarayıcı harekete geçmeden önce ikisini de
  kontrol eder. Ajanlar yalnızca LinkedIn izinli siteler arasındaysa ve yalnızca okudukları bir sayfada değişiklik
  isteyebilir.
- **Güvenlik kontrolleri ajanları durdurur:** LinkedIn'in kendi güvenlik kontrolü (kontrol noktası sayfası, bir
  CAPTCHA'nın sınaması ya da "Security Verification | LinkedIn" başlıklı sayfası; bir üyenin, kuruluşun ya da ürünün
  böyle adlandırılmış kendi sayfası değilse) bağlantı nereye düşerse düşsün ve adres nasıl yazılırsa yazılsın, her ajanı
  LinkedIn'de bir gün durdurur ve yöneticilere haber verilir. Bir sayfanın söyledikleri (bir profil, bir arama, bir iş
  ilanı, başlığında bile) bunu asla yapmaz ve başka siteler bu şekilde asla durdurulmaz. Hiçbir şey oraya yazmaz.
  LinkedIn'i ofis tarayıcısında açıp sorunu çözün, sonra ajanların devam etmesine **Settings → Browser → Stopped sites**
  bölümünden izin verin.

Ajanlar LinkedIn'in aramasını ve profillerini adresleriyle açar; bu yüzden okumak için onay gerekmez.

## Duraklatma ve bağlantıyı kesme

- **Pause agents** (Settings → Browser): siz devam ettirene kadar ajanlar "ofis tarayıcısı duraklatıldı" yanıtını alır. O Chrome profilini kendiniz kullanırken bunu kullanın.
- **Disconnect:** tarayıcının erişimini kaldırır. Yeni bir paket kurana kadar (Lumate Local'da: **Reconnect**'e basana kadar) ajanlar erişimi kaybeder.
- **Ajan başına:** yalnızca **Can use the office browser** seçeneği olan ajanlar (ajan → Settings) onu kullanabilir. Emlak şablonunda Lumate ve Araştırmacıda bu vardır.

## Ajanların tarayıcı araçları

| Araç | Ne yapar |
|---|---|
| `browser_status` | Tarayıcının çevrimiçi mi duraklatılmış mı olduğu ve izinli siteler |
| `browser_open(url)` | Çalışmanın sekmesinde bir sayfa açar; metnini ve numaralı öğelerini döndürür |
| `browser_read` | Geçerli sayfayı yeniden okur |
| `browser_click(n)` | n numaralı öğeye tıklar |
| `browser_type(n, text, submit?)` | n numaralı alana yazar, istenirse Enter'a basar |
| `browser_select(n, option)` | Bir listeden seçenek seçer |
| `browser_scroll` | Uzun bir sayfanın sonraki ya da önceki bölümü |
| `browser_back` | Bir sayfa geri |
| `save_listing`, `match_listing`, `find_listings`, `mark_listing_gone` | İlan araçları, aşağıda |

Sayfalar **dışarıdan gelen veri** olarak döner. Bir sayfadaki metin ajana talimat veremez.

## İlanlar

Bir ajan bir portalda mülk bulduğunda onu `save_listing` ile kaydeder. Her bağlantı bir kez kaydedilir:
- **Yeniden görülmesi** ilanı günceller ve fiyat geçmişini korur.
- **Portaldan kalkan bir ilan**, onun kalktığını bulan ajan tarafından "artık yayında değil" olarak işaretlenir (`mark_listing_gone`).
- **Brokerların telefon numaraları** bir ilanın kendi metnine hiç girmez: başlığında, özetinde, ajansında, binasında ve bölgesinde "[number removed]" ile değiştirilir. Yalnızca bir erişim çalışması (kullanıcı rehberinde Outside brokers), bir ilan brokerının numarasını sayfadaki bir telefon ya da WhatsApp bağlantısından veya portalın "Show number" düğmesine basarak okur ve bir dış broker kartında tutar. Lumate'in Property Finder, Bayut ve Dubizzle'da basabileceği tek şey o düğmedir; onların iletişim formlarını asla doldurmaz.

| Alan | Örnek |
|---|---|
| Başlık, bağlantı, portal | "3BR Marina Gate 1", portalın sayfası, Bayut |
| Satılık ya da kiralık, tür | satılık · daire (ayrıca villa, townhouse, penthouse, arsa, ofis, diğer) |
| Fiyat (AED), yatak odası, banyo, boyut (sq ft) | 2.450.000 · 3 · 4 · 1.820 |
| Bölge, bina, teslim, ajans | Dubai Marina · Marina Gate 1 · hazır · ilan ajansı |
| Özet | Ajanın kendi sözleriyle kısa bir açıklama |

**Eşleştirme:** `match_listing` bir müşteri için ilan önerir ve neden uyduğunu söyler ("Marina'da 3 yatak odası, 2,5 milyon bütçenin altında"). Müşterinin kartında bir kişi her öneriyi işaretler:
- **Sent to the customer** ya da
- **Not interested**.

Pano 🏠 simgesini etkin önerilerin sayısıyla gösterir.

**Aramalarda:** müşteri neyin mevcut olduğunu ya da fiyatların ne olduğunu sorduğunda ses ajanları `search_listings`
kullanır. Önce kayıtlı ilanlarda, sonra canlı olarak Property Finder'da arar; bunu ofis tarayıcısında aramanın kendi
sekmesinde yapar (ajanın tarayıcıyı kullanmasına izin varsa). Arama yalnızca fiyatları, boyutları, yatak odası sayılarını
ve sayfadan kısa satırları alır; brokerların adlarını ya da numaralarını asla almaz ve yuvarlanmış bir istenen fiyat
aralığı verir. Arama başına en fazla 10 arama yapılır, 3'ü canlı; arama bitince sekme kapanır.

**Yeniden bulma:** `find_listings`, ajanların portallarda yeniden aramadan önce ekibin zaten kaydettiklerini aramasını sağlar. İnsanlar **Listings** sayfasını kullanır, bkz. [kullanıcı rehberi](/tr/docs/customers#listings).

**"Finding listings" becerisi** (emlak kataloğu) ajanlara şunları öğretir:
1. müşterinin ihtiyaçlarını okumak;
2. portalları tarayıcıda aramak;
3. uyan her ilanı kaydetmek;
4. en iyilerini nedenleriyle eşleştirmek;
5. geri bildirmek.

## Örnek

> **Siz (Araştırmacıyla sohbet):** @Sara Ahmed için Dubai Marina'da 2,5 milyonun altında satılık 3 yatak odalı daireler bul.
>
> **Araştırmacı:** bir portalın aramasını açar, filtreleri ayarlar, sonuçları okur, 6 ilan kaydeder, en iyi 3'ünü Sara ile eşleştirir ve kısa bir tablo ve bağlantılarla yanıt verir.

Sara'nın kartı şimdi 🏠 3 gösterir. İlanlar, Customers sütununda "Sara Ahmed" ile Listings sayfasındadır.

## WhatsApp Web üzerinden aramalar

Ofis hattı kapalıyken (Settings → Desk phone), Lumate bunun yerine ofis tarayıcısındaki WhatsApp Web üzerinden arayabilir:
arama listelerindeki müşteriler, Call now ve arayıcı, ve bir yönetici aramayı onayladıktan sonra dış brokerlar. Ofis
hattındaki kuralların aynısı geçerlidir: kişinin aranabilme nedeni, DNCR kontrolü ve arama saatleri.

**Kurulum**
1. **Settings → Browser → Link WhatsApp Web** (yöneticiler). WhatsApp Web, ofis tarayıcısının ajan penceresinde açılır.
   QR kodunu şirket telefonuyla okutun: WhatsApp → **Linked devices** → **Link a device**.
2. Settings → Browser sonra **Linked · calls available** der.
3. **Settings → Call center → Call through WhatsApp Web when the office line is off** varsayılan olarak açıktır.

Bağlandıktan sonra Lumate'in WhatsApp penceresi, Chrome ya da Lumate yeniden başlatıldığında ve bir güncellemeden sonra
kendiliğinden geri gelir. Hiçbir arama çıkamıyorsa Start, Call now ve sıra nedenini söyler: ofis hattı yok ve WhatsApp Web'i
neyin durdurduğu (ofis tarayıcısı çevrimdışı ya da duraklatılmış, WhatsApp Web bağlı değil, anahtar kapalı).

**Bir arama nasıl yapılır**
- Lumate'in kendi penceresi numaranın sohbetini açar ve WhatsApp'ın arama düğmesine basar. Ajanın sesi WhatsApp'ın
  mikrofonu olur, kişinin sesi de ajana gider. Bilgisayarın başında kimsenin olması gerekmez. Lumate, ofis tarayıcısında
  WhatsApp Web'in mikrofonu kullanmasına kendiliğinden izin verir (WhatsApp, mikrofon izni olmayan bir aramayı susturur);
  orada web.whatsapp.com için mikrofonu engellemeyin. Ofis tarayıcısının eşleşmesi kaldırılırsa o ayar Chrome'un kendi
  ayarına döner.
- Ajan, kişi yanıtlayınca konuşur. Lumate, WhatsApp'ın kendi arama kaydını izler: çalıyor, yanıtlandı, bitti.
- **Aynı anda bir arama.** Sonraki arama bu bittiğinde başlar.
- WhatsApp'ın ulaşamadığı bir numara (30 saniye içinde çalma yok) işaretlenir: araması ofis hattını bekler ve sıra nedenini
  söyler. Çalan ama kimsenin yanıtlamadığı bir numara, ofis hattında olduğu gibi daha sonra yeniden aranır.
- **Call center → Live** aramayı gösterir. **Listen** çalışır. **Hand over** ve **Take over now**, ofis bilgisayarındaki
  kişiye sorar: Lumate'in penceresi **Take the call** ile öne gelir ve orada biri ona basana kadar ajan hatta kalır
  (ofis bilgisayarında mikrofon olmalıdır). Bilgisayarın başındaki biri WhatsApp Web'deki paneli de kullanabilir: Hand
  over, Take over now, End call.

**Bağlı numarada çalan aramalar** (2.2.0; Settings → Call center → Incoming calls → Lumate answers calls that ring on WhatsApp açılana kadar kapalı):
Lumate'in WhatsApp penceresindeki sayfa bir sesli aramanın çaldığını görür ve arayanın kim olduğunu, WhatsApp'ın
gösterdiği gibi Lumate'e söyler. Kayıtlı bir kişi önce Lumate'te sahibi ve yöneticileri çaldırır; aksi halde ya da
Not now'dan sonra Lumate aramayı aynı sayfada kabul eder (sayfayı asla yeniden yüklemez) ve yanıtlar. Take over,
aramayı bilgisayarın kendi mikrofonuyla kabul eder. Grup ve görüntülü aramalar ve bir arama sürerken gelen ikinci arama
telefonda çalmaya devam eder. Bkz.
[WhatsApp'ınızda çalan aramalar](/tr/docs/calls#calls-that-ring-on-your-whatsapp).
- Ofis bilgisayarının hoparlörleri kişinin tarafını çalabilir. Sesi kısık tutun ya da orada kulaklık kullanın.
- Bir arama en fazla 20 dakika sürer. Lumate'in penceresi kapatılırsa ya da ofis tarayıcısı Lumate ile bağlantısını
  kaybederse arama biter.
- **Pause agents** (Settings → Browser ya da eklentinin anahtarı) yeni WhatsApp Web aramalarını da durdurur. Zaten süren
  bir arama devam eder.
- Bir yönetici **Link WhatsApp Web** ile bağlamadıkça WhatsApp Web üzerinden hiçbir şey aramaz.

**Ajanlar ve WhatsApp Web.** Ajanlar, izinli bir site olsa bile WhatsApp Web'i asla açmaz: Kişisel sohbetler orada durur.
Onu yalnızca Lumate'in arama rutini kullanır ve yalnızca aramak için.

**Sınırlar**
- WhatsApp aramaları BAE'de bağlanmaz. Yurt dışı numaralar için kullanın ya da ofis hattını tutun.
- WhatsApp sayfasını değiştirebilir. Lumate arama düğmesini simgesinden, görüntülü arama düğmesinin yanındaki yerinden ya
  da etiketinden bulur. Hiçbiri bulunamazsa ya da basmak arama başlatmazsa arama, sohbetin üst çubuğunun gösterdiklerini
  listeleyen bir nedenle başarısız olur ve kart olduğu gibi kalır (numara ulaşılamaz olarak işaretlenmez).
- WhatsApp, WhatsApp Web aramalarını hesap hesap açar. Bunlar olmayan bir hesap "Linked · this account cannot call from
  the browser yet" gösterir ve Start "WhatsApp has not turned on calls in WhatsApp Web for this WhatsApp account yet"
  der. WhatsApp Web'in arama yapamadığı bir tarayıcı "this browser cannot make WhatsApp calls" gösterir: Chrome'u ya da
  Edge'i güncelleyin.
- Bağlandıktan hemen sonra WhatsApp Web önce mesajları indirir. Bir arama bunun için bir dakikaya kadar bekler. Hiç
  çalmamış bir deneme, numaranın günlük arama hakkını harcamaz.