Postup pro nasazení Yeastar → Dolibarr integrace

Postup pro nasazení Yeastar → Dolibarr integrace na jiném systému

1. Instalace Pythonu

Na novém systému je třeba nainstalovat Python (doporučená verze: 3.10 nebo novější).

1. Stáhni Python z oficiálního webu: https://www.python.org/downloads/
2. Při instalaci zaškrtni volbu Add Python to PATH.
3. Po instalaci otevři PowerShell a ověř instalaci příkazem:

   py --version
   

   Pokud se zobrazí Python 3.x.x, instalace proběhla úspěšně.

2. Instalace potřebných knihoven

Otevři PowerShell a spusť:

py -m pip install --no-cache-dir requests plyer pyami-asterisk

Instalují se požadované knihovny:

• requests → API komunikace s Dolibarr
• plyer → Zobrazení notifikací
• pyami-asterisk → Připojení k Yeastar AMI

Ověření instalace:

py -m pip list

Měl bys vidět requests, plyer, pyami-asterisk mezi nainstalovanými balíčky.

3. Nastavení Yeastar ústředny

Přihlas se do Yeastar PBX přes webové rozhraní (http://10.0.0.30).

1. Povol AMI v Settings → PBX → General → AMI Settings:
   • Enable AMI → Zapnuto
   • Username → dolibarr
   • Password → Tvé_heslo
   • Permitted IP → 10.0.0.1/255.255.255.0 (nebo uprav podle své sítě)
2. Ulož změny a restartuj ústřednu.

Testování připojení přes Telnet:

telnet 10.0.0.30 5038

Pokud vidíš Asterisk Call Manager, AMI funguje.

4. Nastavení Dolibarr API

V Dolibarr povol API v Nastavení → Moduly → API:

• Zapni API přístup
• Vytvoř API klíč (DOLAPIKEY) pro externí aplikace
• Zkopíruj API klíč

Test API v PowerShellu:

Invoke-WebRequest -Uri "https://intranet.mhweb.cz/api/index.php/contacts" -Headers @{ "DOLAPIKEY" = "Tvůj_API_klíč"; "Accept" = "application/json" } -Method GET

Pokud vrátí StatusCode: 200 OK, API funguje.

5. Nasazení skriptu

Ulož skript do složky C:\Users\Server\Documents\yeastar_dolibarr.py.

Nahraď v kódu správné přihlašovací údaje:

# Nastavení Yeastar AMI
AMI_HOST = "10.0.0.30"
AMI_PORT = 5038
AMI_USER = "dolibarr"
AMI_PASSWORD = "Tvé_heslo"

# Nastavení Dolibarr API
DOLIBARR_API_URL = "https://intranet.mhweb.cz/api/index.php"
DOLAPIKEY = "Tvůj_API_klíč"

Spuštění skriptu v PowerShellu:

py "C:\Users\Server\Documents\yeastar_dolibarr.py"

Pokud vidíš ✅ Připojeno k Yeastar AMI, skript běží správně.

6. Automatické spouštění skriptu při startu Windows

Přidání do Task Scheduler:

1. Otevři Plánovač úloh (Task Scheduler)
2. Vytvoř novou úlohu (Create Basic Task)
3. Nastav spouštění At Startup
4. Akce: Start a Program → py
5. Argumenty: C:\Users\Server\Documents\yeastar_dolibarr.py
6. Ulož a otestuj spuštění úlohy.

Skript se nyní spustí automaticky po restartu.

7. Ověření funkčnosti

Proveď testní hovor na Yeastar a sleduj výstup v PowerShellu.
Pokud číslo existuje v Dolibarr, zobrazí se notifikace a otevře karta zákazníka.
Pokud číslo neexistuje, vypíše ❌ Zákazník nenalezen v Dolibarr.

Skript je nyní připraven k použití na jakémkoli jiném systému.

Script yeastar_dolibarr.py každý příchozí hovor v příloze