# İlk kurulum

Boş bir sunucudan çalışan bir yapay zeka ekibine. Adımlar ekranları sırayla izler.

## 1. İlk hesap (kurulum belirteci)

İlk hesabı Lumate'i kuran kişi açar. 2.16.0'dan beri herkes **e-postasıyla** giriş yapar (daha önce açılmış hesaplar
kullanıcı adlarını korur).

1. **Sunucu sürümü:** yükleyicinin sonunda yazdığı **bağlantıyı** açın. Kurulum belirtecini içinde taşır; yalnızca
   adınızı, e-postanızı ve bir parola (en az 10 karakter) yazarsınız. Bağlantıyı mı kaybettiniz? Yükleyici belirteci
   de yazdı; `sudo grep SETUP_TOKEN /opt/lumate/.env` de gösterir: adresi açın ve belirteci yazın.
   **Lumate Local:** belirteç yoktur: ilk açılış penceresi ilk hesabı oluşturur.
2. **Etkinleştirme:** kurulumda lisans anahtarı verilmiş (`--key`) bir kurulum zaten etkindir: hiçbir şey sorulmaz.
   Verilmemişse aynı form şirketin adını bir kez sorar ve OXS hesabınız **aynı e-posta ve parolayla** açılır: yalnızca
   OXS'in e-postayla gönderdiği altı haneli kodu yazarsınız (yeni hesap 14 günlük deneme başlatır). Lisans anahtarı ya da
   çevrimdışı dosya da olur; bkz. [Lisanslama](/tr/docs/licensing#activating). E-postanın başka bir parolayla OXS hesabı
   varsa Lumate bunu söyler ve o parolayı ister.
3. **Şirketi kim kuracak?**
   - **I will (ben):** aşağıdaki şirket kurulumuna geçersiniz.
   - **Someone else (başkası):** yöneticinin e-postasını yazın. Lumate onun için bir bağlantı yapar (7 gün, bir kez);
     kopyalayıp gönderin. Yönetici hesabını bu bağlantıyla açar ve şirketi kurar. Siz o şirketin **üyesi olmazsınız**:
     Lumate size müşterilerini, mesajlarını ve aramalarını göstermez (sunucunun yedekleri yine de hepsini tutar; onları
     ve sunucuya kimin erişebildiğini güvende tutun). Sizin yeriniz **Sunucu sayfasıdır** (durum, tanılama,
     güncellemeler, yedekler, lisans ve o bağlantı; bkz. [Sunucu sayfası](/tr/docs/agents#the-server-page-from-2160)).

Belirteç yalnızca ilk hesap oluşana kadar işe yarar. Bu ilk kişi **kurulum yöneticisi** olur.

## 2. Şirket (onboarding)

Şirket kurulumu üç adımdır ve her şeyi bir kez sorar:

| Adım | Ne girersiniz |
|---|---|
| **Company** | Adı (lisansınızın hesabından dolu gelir), web sitesi (Lumate şirketin ne yaptığını oradan öğrenir; isteğe bağlı) ve saat dilimi (örneğin `Asia/Dubai`: tüm programlar, arama saatleri ve raporlar bunu kullanır). Görev öneki (2–6 harf; `RIC-12` gibi görev numaralarında kullanılır) addan önerilir. |
| **Departments** | Şirketin ne yaptığı: departmanları (**Real estate**, **Any business**, **Recruiting**; ekibi kadar, ilki ana departman) ekiplerini, kişilerini ve sayfalarını getirir; ülkesi (Birleşik Arap Emirlikleri, Türkiye veya başka bir ülke) arama kurallarını belirler. **Create company** şirketi oluşturur. İkisi de sonra Settings → Departments bölümünden değiştirilebilir (bkz. [Departmanlar ve ülkeler](/tr/docs/tour#departments-and-countries)). |
| **Connections** | Claude ve OpenAI anahtarı tek ekranda, her biri çalışıp çalışmadığını söyler. Sunucu sürümünde şirketin Claude anahtarı ya da belirteci (veya sunucuda `sudo lumate claude-login`); kaynaktan kurulmuş bir sunucuda burada bir çalıştırıcı anahtarı üretilir. OpenAI anahtarı aramalar içindir. İkisini de atlayabilirsiniz: eksik olan, gelene kadar panelde yazar. |

Sonra Claude yanıt verir vermez kurulum görüşmesi açılır: Lumate şirketi sorar ve departmanlarını, ajanlarını ve
uygulamalarını önerir (bkz. [Lumate ile kurulum](/tr/docs/tour#setting-up-with-lumate-from-2110)). Verdiğiniz
departmanları ve web sitesini zaten bilir ve bir daha sormaz. Lumate Local'in ilk açılış penceresi departmanları
yalnızca **Choose departments yourself** düğmesine basarsanız (veya birlikte gelen ekip paketi belirtiyorsa) sorar.

## 3. Claude'u bağlayın (çalıştırıcı)

Çalıştırıcı şirketin kendi Claude'unu kullanır: bir Anthropic API anahtarı ya da bir Claude hesabının oturum belirteci.

- **Anthropic API anahtarı (işletmeler için önerilir):** Ticari koşullar geçerlidir ve veri eğitim için kullanılmaz. Anahtarı Anthropic Console'da oluşturun.
- **Şirketin Claude hesabı:** Sunucu sürümünde `sudo lumate claude-login` hesabı sunucuda oturum açar (bkz.
  [Sunucu sürümü](/tr/docs/install-server#what-runs)). Bir Claude hesabının uzun ömürlü belirteci de çalışır: Claude Code
  olan herhangi bir bilgisayarda **şirketin** Claude hesabıyla oturum açın ve `claude setup-token` komutunu çalıştırın;
  `sk-ant-oat01-…` yazdırır.

Nereye girilir:

- **Sunucu sürümü:** Settings → Runners → **Claude for the runners** (sahipler ve yöneticiler; şifreli saklanır, bir daha gösterilmez) ya da `sudo lumate claude-login`. İlk şirket oluşunca çalıştırıcı kendini kurar.
- **Lumate Local:** İlk açılış penceresinin Claude adımı, sonra Settings → General → Claude. Çalıştırıcı uygulamanın parçasıdır.

Settings → **Runners** çalıştırıcıyı birkaç saniye içinde çevrimiçi gösterir. Orada daha fazla anahtar üretebilir (örneğin başka bir bilgisayardaki çalıştırıcı için) ve iptal edebilirsiniz.

Deneyin: **Chats → Lumate** bölümünü açın ve "Merhaba, neler yapabilirsin?" yazın. Birkaç saniyede gelen yanıt çalıştırıcının çalıştığını gösterir.

## 4. İnsanları davet edin

**Settings → Members:**
1. Bir rol (**admin** veya **member**) seçin ve kişinin **e-postasını** yazın. Her bağlantı yalnızca o kişi içindir, bir
   kez çalışır ve 7 gün sonra geçersiz olur. Settings → Email kuruluysa Lumate e-postayla gönderir (siz de
   kopyalayabilirsiniz); değilse bağlantıyı kopyalayıp gönderin. Kişi e-postasını bir kez onaylar (ilk sayfası bunu
   önerir, ya da Settings → Your account → Email); böylece **Forgot password?** onun için çalışır.
2. Kişi bağlantıyı açar, adını ve bir parola yazar; bundan sonra o e-postayla giriş yapar. E-postanın burada zaten bir
   hesabı varsa giriş yapıp onunla katılır: kimsenin ikinci hesabı olmaz. Sonra kendisine ait olanla (masa telefonunun
   dahilisi) kısa bir karşılama görür; şirketin kurulum görüşmesini hiç görmez.
3. Rolleri değiştirmek veya kişileri çıkarmak için aynı sayfayı kullanın. En az bir sahip her zaman kalır.

| Rol | Yapabilecekleri |
|---|---|
| Sahip / Yönetici | Şirketteki her şey: ayarlar, gizli anahtarlar, numaralar, üyeler, WhatsApp, tarayıcı kuralları, ajan izinleri |
| Üye | Günlük iş: sohbetler, görevler, müşteriler, randevular, mesajlar, ilanlar |

## 5. Ses (OpenAI)

1. **Settings → Secrets** → `OPENAI_API_KEY` ekleyin: şirketin OpenAI anahtarı. Değeri şifrelenir, bir daha gösterilmez ve ajanlara hiç verilmez.
2. **Settings → Voice:**

   | Ayar | Anlamı |
   |---|---|
   | Voice model | Gerçek zamanlı ses modeli |
   | Backend model | Sesin araçlarının arkasındaki model |
   | Thinking | Sesin ne kadar düşündüğü |
   | Talks with you in | Sesin ekibinizle konuşurken kullandığı dil |
   | Calls in | Müşteri aramalarında kullandığı dil |

3. Her ajanın bir **Voice** sekmesi vardır: sesi ve konuşma şekli.

Deneyin: bir ajanın sohbetini açıp mikrofona basın ya da **Playground**'a gidin.

## 6. Telefon numaraları (isteğe bağlı)

[Telefon ve Asterisk](/tr/docs/phone) bölümünü izleyin:
- OpenAI proje kimliği;
- webhook gizli anahtarı (`OPENAI_WEBHOOK_SECRET`);
- numaralar ve her birini hangi ajanın yanıtladığı;
- aktarma numarası;
- giden aramalar için hat ve `SIP_TRUNK_PASSWORD`.

## 7. Müşteri panosu

**Settings → Board:**

| Ayar | Varsayılan | Anlamı |
|---|---|---|
| Hand to the manager after this many unanswered calls | 2 | Kart "Yöneticiye" sütununa taşınır |
| Minutes before calling again | 120 | "Cevap yok" kartının ne zaman yeniden aranacağı |
| Daily report time (company time) | 19:30 | Koordinatörün günün raporunu yazdığı saat |
| Who takes appointments by default | — | Yeni randevu isteklerinin gittiği kişi |

Panoyu hemen denemek için: **Customers → ⋯ → Add sample customers** 25 örnek müşteri ekler. Sonra aynı menüden kaldırabilirsiniz.

## 8. Bildirim telefonunuz

**Settings → Your account** → "Your phone for notifications". WhatsApp bağlıyken bu bildirimler WhatsApp'a da gelir:
- devirler ("Raj'ın size ihtiyacı var");
- randevu istekleri;
- günlük rapor;
- yeni WhatsApp mesajları (müşteri başına en fazla 30 dakikada bir).

## 9. WhatsApp (isteğe bağlı)

Settings → **WhatsApp** → QR kodla (ya da eşleştirme koduyla) bağlayın. Ayrı bir numara kullanın. Bkz. [WhatsApp](/tr/docs/whatsapp).

## 10. Ofis tarayıcısı (isteğe bağlı)

1. Settings → **Browser** → eklentiyi indirin ve ofis bilgisayarına kurun.
2. CRM'i izinli sitelere ekleyin.
3. Ofis tarayıcısına ihtiyacı olan ajanlar için, her ajanın Settings sekmesinde **Can use the office browser** seçeneğini açın. Emlak şablonundan oluşan ajanlarda (Lumate ve Araştırmacı) bu zaten açıktır; daha önce oluşturduğunuz ajanlarda açmanız gerekir.

Bkz. [Ofis tarayıcısı ve ilanlar](/tr/docs/office-browser).

## 11. Beceriler ve bilgi

- **Beceriler:** Kategorilere göre hazır katalog. Becerileri şirkete ekleyin ve ajanlara verin. GitHub'dan içe aktarmak da mümkündür.
- **Bilgi:** Ajanların öğrendikleri kaynağıyla birlikte burada görünür.

Bir ajana bir şey öğretmek için ona söylemeniz yeter ("Ofisimiz cuma günleri saat 6'da kapanır") ya da bir dosya paylaşın (fiyat listesi, broşür). Ajan hatırlar.

## Kontrol listesi

- [ ] HTTPS çalışıyor ve `SESSION_SECRET`, `SECRETS_KEY` ayarlı
- [ ] İlk hesap ve şirket var; şablonun ajanları orada
- [ ] Çalıştırıcı çevrimiçi ve Lumate bir sohbette yanıt veriyor
- [ ] Üyeler doğru rollerle davet edildi
- [ ] `OPENAI_API_KEY` kayıtlı; bir ajanla konuşma çalışıyor
- [ ] Pano ayarları ve varsayılan randevu sahibi ayarlı
- [ ] İsteğe bağlı: numaralar, WhatsApp, ofis tarayıcısı