Funnel_Wiki/Integrace.md

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:

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.