84 lines
2.3 KiB
Markdown
84 lines
2.3 KiB
Markdown
# Integrace
|
||
|
||
## SmartEmailing
|
||
|
||
CRM/mailing systém SmartEmailing.
|
||
|
||
**Klient:** `App\Services\Integrations\SmartEmailingClient`
|
||
|
||
**Synchronizace kontaktů:** `SmartEmailingContactsSyncService`
|
||
|
||
**Akce z automací:**
|
||
- `SmartEmailingAddToListDriver` – přidání kontaktu do listu
|
||
- `SmartEmailingAddTagDriver` – přidání tagu
|
||
- `SmartEmailingUnsubscribeDriver` – odhlášení kontaktu
|
||
|
||
**Webhook příjem:** `POST /api/integrations/smartemailing/webhook` → `SmartEmailingWebhookController`
|
||
|
||
**Healthcheck:** `SmartEmailingHealthcheck` – kontrola dostupnosti API
|
||
|
||
---
|
||
|
||
## Vario ERP
|
||
|
||
ERP systém pro správu firem, kontaktů, kategorií a produktů. Komunikace přes **SOAP**.
|
||
|
||
**Klient:** `App\Services\Vario\VarioSoapClient`
|
||
|
||
**Sync commandy:**
|
||
|
||
| Command | Popis |
|
||
|---------|-------|
|
||
| `vario:sync` | Master sync (spouští ostatní) |
|
||
| `vario:sync-contacts` | Sync kontaktů |
|
||
| `vario:sync-companies` | Sync firem |
|
||
| `vario:sync-categories` | Sync kategorií produktů |
|
||
| `vario:sync-phonebooks` | Sync telefonních seznamů |
|
||
| `vario:sync-product` | Sync jednotlivého produktu |
|
||
|
||
**Klíčové třídy:**
|
||
- `VarioImporter` – orchestrace importu
|
||
- `VarioContactMapper` / `VarioCompanyMapper` – mapování polí
|
||
- `VarioSnapshotBuilder` – snapshot dat pro porovnání změn
|
||
- `VarioDatapackParser` – parsování datapaku ze SOAP odpovědi
|
||
|
||
**Admin UI:** `/admin/vario/doklady` – prohlížení a parsování Vario dokladů
|
||
|
||
---
|
||
|
||
## PBX (telefonní ústředna)
|
||
|
||
**Klient:** `App\Services\Pbx\PbxClient`
|
||
|
||
**Telefonní seznamy:** `Phonebook`, `PhonebookEntry`, `PhonebookContact` modely
|
||
|
||
**Sync:** `PushPhonebookToPbxJob` – nahraje telefonní seznam do PBX
|
||
|
||
**Admin UI:** `/admin/phonebooks` – prohlížeč telefonních seznamů
|
||
|
||
---
|
||
|
||
## Microsoft Graph (Email)
|
||
|
||
Alternativní odesílač emailů přes Microsoft 365 API.
|
||
|
||
**Service:** `App\Services\MicrosoftGraph\MicrosoftGraphMailService`
|
||
|
||
**Konfigurace v .env:**
|
||
```env
|
||
MICROSOFT_GRAPH_TENANT_ID=
|
||
MICROSOFT_GRAPH_CLIENT_ID=
|
||
MICROSOFT_GRAPH_CLIENT_SECRET=
|
||
MICROSOFT_GRAPH_FROM_ADDRESS=
|
||
```
|
||
|
||
---
|
||
|
||
## Logování integrací
|
||
|
||
Všechny integrace logují výsledky do `IntegrationLog` (`integration_logs` tabulka). Přehled dostupný v admin UI na `/admin/integrations/logs/{log}`.
|
||
|
||
`IntegrationLogger` je helper pro jednotné logování úspěchů a chyb.
|
||
|
||
Stav integrace (poslední sync, chyby) ukládá `IntegrationState` model.
|