# Başlangıç

Panele giriş, cihaz seçimi ve hesap bilgileri

# Dashboard (Ana Ekran)

Dashboard, panele girdiğinizde açılan ana ekrandır ve işletmenizin **canlı görünümünü** tek sayfada toplar: şu an kaç misafir bağlı, kampanyalar ne getiriyor, misafirler kim, yasal loglama sağlıklı mı. Veriler **20 saniyede bir** otomatik yenilenir.

> **Bu ekranı nasıl açarım?** Panele giriş yaptığınızda doğrudan açılır. Başka bir sayfadaysanız sol menüden **Dashboard**'a dönebilirsiniz.

![Dashboard ana ekranı](https://help.useroam.com/uploads/images/gallery/2026-08/index.png)

Sayfanın en üstünde işletme adınız, güncel tarih ve *"Canlı — 20 sn'de bir yenilenir"* göstergesi bulunur.

---

## 1. Canlı özet kartları

Üst şeritteki dört kart anlık durumu gösterir:

- **Şu an bağlı misafir:** O anda ağınızda oturumu açık cihaz sayısı. Salonun ne kadar dolu olduğunu gösteren en hızlı sinyaldir.
- **Bugünkü oturum:** Gün başından beri açılan toplam oturum sayısı.
- **Bu hafta tekil misafir:** Bu hafta ağa bağlanan *farklı* misafir sayısı (aynı kişi birden çok kez bağlansa da bir sayılır).
- **Medyan kalış (30g):** Son 30 günde misafirlerin ortalama değil *ortanca* kalış süresi. Ortanca kullanıldığı için tek bir çok uzun oturum sonucu çarpıtmaz.

---

## 2. Useroam AI · Otopilot

Yapay zekâ katmanının özetidir. Kartın üstünde çalışma kipi (*AKTİF · yarı otomatik*) ve **onay bekleyen öneri** sayısı yazar.

Altında Otopilot'un son işlemleri listelenir; her satır ya **Yapıldı** ya da **Onay bekliyor** durumundadır. Örnek satırlar: *"Anket puanlarında yükseliş fark ettim"*, *"8 anket yanıtını okudum"*, *"66 uykuda misafiriniz için geri çağırma hazırladım"*.

**Önerileri incele** butonu sizi **Bumerang → Useroam AI · Otopilot** sayfasına götürür; onay bekleyen işlemleri orada onaylar veya reddedersiniz.

> **Yarı otomatik ne demek?** Otopilot analiz ve hazırlığı kendi yapar, ancak misafire gidecek gönderimler için sizin onayınızı bekler.

---

## 3. Bumerang performans şeridi

Pazarlama katmanının beş özet göstergesi:

- **Aktif kampanya:** Şu an yayında olan kampanya sayısı.
- **Gönderim · 30g:** Son 30 günde misafirlere gönderilen mesaj sayısı.
- **Tıklama · 30g:** Bu gönderimlerdeki bağlantılara yapılan tıklama sayısı.
- **Geri dönen misafir:** Gönderim sonrası işletmeye tekrar gelen misafir sayısı ve oranı.
- **Net kazanım · 30g:** Kampanyaların getirdiği tahmini net ciro (₺).

### Bumerang döngüsü

Gönderimden geri dönüşe kadar olan huniyi gösterir: **Gönderim → Tıklama → Dönüş**. Altındaki cümle sonucu sade biçimde özetler: *"Her 100 gönderimden X'i misafiri işletmenize geri getirdi."* **Komuta merkezi** butonu Bumerang özet sayfasına gider.

### En iyi kampanyalar

Son 30 günün kampanyalarını **dönüşe göre** sıralar; her satırda kampanya adı, gönderim ve dönüş sayısı yer alır. Hangi teklifin gerçekten işe yaradığını buradan görürsünüz.

---

## 4. Ziyaret ve misafir davranışı

- **Ziyaret trendi:** Son 30 günün tekil ziyaretçi ve oturum grafiği; altında dönem toplamı yazar.
- **Yeni / Dönen misafir:** Misafirlerinizin yüzde kaçının tekrar geldiğini gösterir. Sadakat çalışmalarının en doğrudan ölçüsüdür. **Detaylı analitik** butonu **Analiz ve Raporlar → Ziyaret Analitiği** sayfasını açar.
- **Saat × gün yoğunluk haritası:** Haftanın günleri (Pzt–Paz) ile saatleri (0–21) kesiştiren ısı haritası. Üstte *"En yoğun zamanınız"* yazar. Personel planlaması ve kampanya gönderim saatini seçmek için kullanılır.

---

## 5. Son 5 Bağlantı

En son giriş yapan beş misafiri, telefon numaraları **maskelenmiş** biçimde (örn. `55******62`) ve durumlarıyla (*Giriş Yapıldı*) listeler. **Tüm bağlantılar** bağlantısı tam listeyi açar.

---

## 6. Misafir profili

- **Kayıtlı misafir sayısı** ve cinsiyet dağılımı (Erkek / Kadın / Belirtmemiş).
- **Nereden geliyorlar?** Kayıtlı misafirlerin ilk 5 ili ve sayıları.
- **Kayıt kanalı:** Misafirlerin hangi yolla giriş yaptığı (SMS / WhatsApp). Hangi portal modülünün gerçekte kullanıldığını gösterir.

---

## 7. Yasal loglama ve sistem durumu

- **5651 canlı log akışı:** Cihazınızdan gelen logların anlık akışı. *"Log verisi alınamadı"* yazıyorsa firewall tarafındaki syslog ayarını kontrol edin.
- **5651 imzalama:** **Bekleyen**, **İmzalanan** ve **İmzalanacak** (yüzde ve toplam kota, örn. %0 · 10 GB) değerleri ile **Sonraki İmzalama** geri sayımı. Kota dolmaya yaklaşırsa **Ayarlar → Bildirimler** sayfasındaki %90 uyarısını açık tutun.
- **Lisans:** Durum (Aktif) ve bitiş tarihi.
- **Cihaz:** Bağlı güvenlik duvarının markası ve adresi (örn. *Sophos 10.255.255.1*).

---

> **İlgili sayfalar:** **Bumerang → Özet**, **Analiz ve Raporlar → Ziyaret Analitiği**, **Analiz ve Raporlar → 5651 Logları**, **Ayarlar → Cihaz Ayarları**.

# Cihaz Seçimi

Cihaz Seçimi ekranı, hesabınıza bağlı **güvenlik duvarı / lokasyon** kayıtlarını listeler. Birden fazla şubesi olan işletmelerde hangi lokasyonun panelinde çalışacağınızı buradan seçersiniz; yaptığınız tüm ayarlar seçtiğiniz cihaza uygulanır.

> **Bu ekranı nasıl açarım?** Sağ üstteki hesap menüsünden **Cihaz Seçimi**'ni açın. Tek cihazı olan hesaplarda giriş sonrası doğrudan o cihazla devam edilir.

![Cihaz Seçimi ekranı](https://help.useroam.com/uploads/images/gallery/2026-08/select-device.png)

---

## Görünüm ve arama

- **Kart / Liste:** Cihazların kart görünümünde mi yoksa satır listesinde mi gösterileceğini seçer. Çok sayıda lokasyonda liste görünümü daha hızlı taranır.
- **Arama:** Cihaz adı veya adresine göre anlık filtreleme yapar.
- **Önceki / Sonraki:** Cihaz sayısı bir sayfaya sığmadığında sayfalar arasında gezinir. Altta "1 sonuç • 1–1" biçiminde toplam gösterilir.

---

## Cihaz kartında görünen bilgiler

- **Cihaz adı:** Panelde tanımladığınız isim (örn. *Useroam Demo*).
- **Cihaz adresi:** Cihazın WAN / yönetim IP adresi (örn. `10.255.255.1`).
- **Firewall:** Algılanan marka (örn. *Sophos*). Kurulum rehberi ve API entegrasyonu bu markaya göre belirlenir.
- **Salt-Okunur** etiketi: Bu cihaz üzerinde yalnızca görüntüleme yetkiniz olduğunu, değişiklik yapamayacağınızı belirtir.

Bir cihaza tıkladığınızda panel o cihazın verileriyle yeniden yüklenir.

---

## Yeni Cihaz

**Yeni Cihaz** butonu yeni bir güvenlik duvarı kaydı açar. Sistem lisansınızı otomatik seçer; siz **cihaz tipini** (kurulum rehberi bulunan markalar: Sophos, Fortinet, Palo Alto, Mikrotik, Ruijie), **cihaz adresini** (WAN IP) ve gerekiyorsa **5651 Loglama** ile **cihaz seri numarası** alanlarını doldurursunuz.

> **Sonraki adım:** Cihazı ekledikten sonra firewall tarafındaki yapılandırma için **Kurulum Rehberleri** altındaki markanıza ait sayfayı izleyin. RADIUS şifresi ve portal şablonu **Ayarlar → Cihaz Ayarları** sayfasındadır.

# Profilim (Hesap Bilgileri)

Profilim ekranı, panele giriş yapan kullanıcının kendi hesabını yönettiği yerdir: kişisel ve firma bilgileri, panel dili, şifre ve iki adımlı doğrulama. Başka kullanıcıları yönetmek için **Ayarlar → Yöneticiler** ekranını kullanın.

> **Bu ekranı nasıl açarım?** Sağ üstteki hesap menüsünden **Profilim**'i seçin.

![Profilim ekranı](https://help.useroam.com/uploads/images/gallery/2026-08/accounts-info.png)

---

## 1. Bilgilerim

- **Ad** ve **Soyad.**
- **E-Posta:** Bildirimlerin gönderileceği adres.
- **Panel Dili:** *Türkçe* veya *English*. Kaydettiğinizde hemen ve her girişte uygulanır.
- **Firma Adresi:** Sözleşmelerde taraf adresi olarak kullanılır.
- **KEP Adresi:** Tebligata esas elektronik adres. Zorunlu değildir.
- **Cep Telefonu:** Yanındaki **Doğrula** düğmesi numaraya doğrulama kodu gönderir. Ekranda o an doğrulanmış numara yazar; değiştirmek için yeni numarayı girip tekrar **Doğrula** dersiniz.
- **Kullanıcı Adı (Giriş):** Panele giriş adresiniz. **Değiştirilemez.**

Değişiklikler **Kaydet** ile yazılır.

---

## 2. Şifre Değiştir

Üç alan vardır: **Mevcut Şifre**, **Yeni Şifre** (en az 8 karakter) ve **Yeni Şifre (Tekrar)**. **Şifreyi Güncelle** düğmesi değişikliği uygular.

---

## 3. 2FA Yönetimi

İki adımlı doğrulama (Authenticator uygulaması) hesabınızın güvenliğini artırır. Sekme, doğrulamanın o an açık olup olmadığını yazar.

Telefonunuzu değiştirdiyseniz veya Authenticator erişiminizi kaybettiyseniz doğrulamayı sıfırlayıp yeniden kurabilirsiniz:

1. **Mevcut Şifre (doğrulama)** alanına şifrenizi girin.
2. **Sıfırlamak istediğimi onaylıyorum** kutucuğunu işaretleyin.
3. **2FA'yı Sıfırla** düğmesine basın.

Sıfırladıktan sonra **bir sonraki girişinizde yeni QR kod** istenir; Authenticator uygulamasına yeniden tanıtırsınız.

---

## 4. API Anahtarları

REST API erişimi için token üretilen sekmedir; ayrı bir sayfada anlatılmıştır.

---

> **İlgili sayfalar:** **Başlangıç → API Anahtarları**; **Ayarlar → Yöneticiler**, **Yönetici Profilleri**.

# API Anahtarları

API Anahtarları, Useroam'un **REST API**'sine dışarıdan erişmek için token ürettiğiniz sekmedir. Otomasyon araçları (n8n gibi), kendi mobil uygulamanız veya bir entegrasyon buradan üretilen anahtarla panele bağlanır.

> **Bu ekranı nasıl açarım?** **Profilim** ekranını açıp **API Anahtarları** sekmesine geçin.

---

## 1. Yeni anahtar oluşturma

**Yeni Anahtar** düğmesi üç alanlı bir pencere açar:

- **Etiket:** Anahtarın nerede kullanıldığını ayırt etmenizi sağlar — ör. *n8n entegrasyonu*, *Mobile App*, *Test*. Anahtarı iptal etmeniz gerektiğinde hangisi olduğunu bu addan bulursunuz.
- **IP Whitelist:** Anahtarın kullanılabileceği adresler. Tek adres, ağ bloğu (*10.0.0.0/24*) veya virgülle ayrılmış liste yazılabilir. **Her token belirli IP'lerle sınırlandırılır** — bu alanı doldurmak güvenliğin ana katmanıdır.
- **Geçerlilik (gün):** Anahtarın kaç gün sonra sona ereceği.

**Oluştur** anahtarı üretir, **Vazgeç** pencereyi kapatır.

> **Anahtarı oluşturulduğu anda kopyalayın.** Token'lar güvenlik gereği sonradan açık hâlde gösterilmez; kaybederseniz yenisini üretmeniz gerekir.

---

## 2. Anahtar listesi

Üretilmiş anahtarlar tabloda listelenir:

- **Etiket:** Verdiğiniz ad.
- **Anahtar:** Token'ın kısaltılmış hâli.
- **IP Whitelist:** İzin verilen adresler.
- **Oluşturulma** ve **Bitiş:** Üretim ve son kullanma tarihi.
- **Son Kullanım:** Anahtarın en son ne zaman kullanıldığı. Hiç kullanılmamış bir anahtar, unutulmuş bir entegrasyon demektir — silmek en doğrusu.
- **Kullanım:** Toplam çağrı sayısı.
- **Durum:** Anahtarın aktif olup olmadığı.

---

## 3. Endpoint listesi

Sayfanın altında API'nin sunduğu uç noktalar **Endpoint** ve **Açıklama** sütunlarıyla listelenir. Hangi veriye nereden ulaşacağınızı buradan görür, **Nasıl kullanılır?** bağlantısından ayrıntılı belgeye geçersiniz.

---

> **İlgili sayfalar:** **Başlangıç → Profilim (Hesap Bilgileri)**.