# 📘 Gebruikershandleiding — Bobex Communication Center

> Stap-voor-stap gids voor operatoren, managers en beheerders (niet voor ontwikkelaars).

---

## 🚪 1. Inloggen

URL: **http://51.68.45.142:5000**

- **E-mail**: bv. `admin@bobex.local` (laat leeg om het gedeelde wachtwoord te gebruiken)
- **Wachtwoord**: ontvangen van je admin
- Kies een taal bovenaan: **FR / NL / EN / AR**

> 🛡️ Alle API-oproepen vereisen een token. Niemand kan data zien zonder account.

---

## 🗺️ 2. Plan van het dashboard

| Icoon | Sectie | Wat het doet |
|---|---|---|
| 📊 | **Dashboard** | KPI's + 4 live grafieken |
| 📞 | **Oproepen** | Tabel met alle oproepen + AI-analyse |
| 🧠 | **Klanten** | Lichte CRM met geheugen per nummer |
| 🔀 | **Toestellen** | Beheer interne nummers (101–104) |
| 📈 | **AI-analyse** | Periodieke rapporten via AI |
| 🚨 | **Meldingen** | Automatisch (negatief sentiment, herhaalde doorschakelingen…) |
| 📑 | **Kennisbank** | FAQ die in de AI-prompt wordt geïnjecteerd |
| 🔄 | **Doorschakelingen** | Leaderboard per toestel |
| ⚙️ | **Instellingen** | Openingsuren + beschikbaarheid agenten |
| 👥 | **Gebruikers** | Beheer accounts *(alleen admin)* |
| 📚 | **Geschiedenis** | Alle bewaarde gesprekken |

---

## 📞 3. Oproepverloop

1. Klant belt **+322 886 0449**
2. Tweetalige begroeting: *"Bonjour, goeiedag…"*
3. AI detecteert de taal en gaat erin door (FR/NL/EN/AR/…)
4. Als de klant iemand specifiek vraagt:
   - *"Ik wil met de manager spreken"* / *"المدير"*
   - AI zegt: *"Ik verbind u door, een moment"*
   - Doorgeschakeld naar **Toestel 104** (manager)
5. Manager neemt op → directe conversatie
6. Audio + transcript + stats worden automatisch opgeslagen

---

## 🧠 4. Klantensectie (CRM)

### Klant bekijken
1. Open **Klanten**
2. Kies links → volledig profiel rechts
3. Je ziet:
   - 📊 Totaal oproepen, spreektijd, dominante taal, sentiment
   - 🧠 **Opgeslagen feiten** die AI hergebruikt
   - 📞 Oproepgeschiedenis; per oproep:
     - **💬** Schriftelijk transcript
     - **💿** Audio-opname afspelen
     - **📝** Handmatige notities + tags
     - **🤖 Analyse** AI-rapport

### Feit toevoegen
- Bij "Opgeslagen feiten": typ wat AI moet onthouden (bv. *"voorkeur Nederlands"*)
- Kies categorie en belangrijkheid
- Druk **+**
- ✅ Bij volgende oproep weet de AI dit

### Klant bellen (Outbound)
- **📞 Bellen** in profiel
- Vraagt je toestel (bv. 104)
- Jouw telefoon belt eerst, dan belt het systeem de klant

### Transcripts doorzoeken
- Veld **🔎 Zoek in transcripts…**
- Typ een woord → modal met alle oproepen die het bevatten

---

## 🤖 5. AI-analyse (3 niveaus)

### Niveau 1 — Eén oproep analyseren
**🤖 Analyse** op een oproep → samenvatting + intentie + sentiment + kernpunten + acties + status + QA.

### Niveau 2 — Klanttraject
**📊 Traject** in een klantprofiel → terugkerende onderwerpen + tevredenheidstrend + pijnpunten + kansen + aanbevolen acties.

### Niveau 3 — Periode-rapport
**AI-analyse** → kies 24u / 7d / 30d → **Genereer** → CSAT, trending onderwerpen, suggesties voor de prompt.

### Export
- **🖨 PDF** opent print (Opslaan als PDF)
- **📋 JSON** kopieert ruwe data

---

## 🚨 6. Meldingen

Automatisch bij:
- ❗ Negatief sentiment
- ❗ Zelfde beller ≥3× doorgeschakeld binnen 24u
- ❗ Lange oproep (>10 min)
- ❗ Technische fout

Een **🔴 badge** verschijnt in de sidebar. Klik **✓** om te bevestigen.

---

## 📑 7. Kennisbank

Hier sla je Q/A op die de AI automatisch gebruikt.

1. Sectie **Kennisbank**
2. Typ vraag + antwoord
3. Kies categorie + prioriteit
4. Druk **+**
5. ✅ Volgende oproep: AI gebruikt je antwoord natuurlijk

Items kunnen **OFF/ON** zonder verwijderen.

---

## ⏰ 8. Instellingen

### Openingsuren
- Per dag: openings- + sluitingstijd
- ✅/❌ om de dag te activeren
- **Buiten openingsuren**: AI meldt dat het kantoor gesloten is en schakelt niet door

### Beschikbaarheid
Wanneer agent op verlof is:
1. Vind het toestel (bv. 104)
2. Vink "Beschikbaar" uit
3. Typ een reden
4. Stel retourdatum in
- ✅ AI schakelt niet door tot die datum

---

## 🔀 9. Toestellen

- Inline bewerken (naam/rol/omschrijving) → auto-saved
- ON/OFF per toestel
- **+ Toevoegen** voor een nieuwe (ook in Zadarma configureren)

⚠ Naamwijziging: hernoem 104 van "Manager" naar "Baas" → volgende oproep: als klant zegt "baas", AI schakelt correct door.

---

## 👥 10. Gebruikers (alleen admin)

### Rollen
| Rol | Rechten |
|---|---|
| **admin** | Alles + gebruikersbeheer + instellingen |
| **operator** | Lezen + schrijven CRM/notities + doorschakelingen |
| **viewer** | Alleen lezen |

### Medewerker toevoegen
Formulier bovenaan: e-mail + naam + wachtwoord + rol + taal → **+**

### Wachtwoord resetten
**🔑** knop op de gebruikersrij

### Uitschakelen / verwijderen
- "Actief" uitvinken om te schorsen
- **×** om te verwijderen (niet jezelf)

---

## 📚 11. Geschiedenis

Alle bewaarde gesprekken:
- 🔎 Zoek op nummer of vrije tekst
- 📅 Datumfilters
- ⬇ JSON-export
- 🗑️ Eén of alle verwijderen
- **💬** volledig transcript, **🤖** AI-analyse

---

## 💰 12. Kosten

In **Systeemoverzicht** op het dashboard:
- Totaal (USD), stem vs analyse
- 24u / 7d / 30d
- Totale audio-minuten

Tarieven:
- **Stem (Bobex AI Live audio)**: ~ $0,029 / minuut
- **Analyse (Bobex AI)**: ~ $0,003 / rapport

Aanpasbaar via env-variabelen.

---

## 🔐 13. Beveiliging

- Wachtwoord op login
- Sessietoken met 24u sliding TTL
- Doorschakelingen beperkt tot 101–104 (strikte whitelist)
- Isolatie per beller (AI kan geen andere klantdata lezen)
- Wachtwoorden opgeslagen als scrypt-hashes

---

## 🆘 14. Veelvoorkomende problemen

| Symptoom | Oplossing |
|---|---|
| Kan niet inloggen | Vraag admin om wachtwoord-reset |
| Rapport in verkeerde taal | Wissel taal *vóór* genereren |
| Dashboard lijkt vast | `Ctrl+Shift+R` (hard refresh) |
| Geen audio-opname | Bestand wordt aan einde van oproep aangemaakt |
| AI herinnert zich klant niet | Controleer of nummer niet "unknown" is |

---

## 📞 Support

- **WhatsApp**: +32 …
- **E-mail**: tech@bobex.com

---

*Laatste update: 26-05-2026 — versie 2.1 (multi-tenant, MP3-opnames, PWA)*