Přeskočit obsah

Reference: Outlook Integrace

Podrobný přehled datových vazeb a automatizace modulu Outlook. Zaměřuje se na správu integrace, plánované joby a toky dat do/z Microsoft 365/Outlook.com.

Architektura a toky

flowchart LR
    U["Uživatel připojí Microsoft účet<br/>OAuth 2.0"] --> EA["Externí účet Outlook"]
    EA --> CalJob["Job 'SyncOutlookCalendar'<br/>*/10 minut"]
    CalJob <--> CRMEvents["Schůzky & Volání v CRM"]
    CalJob <--> Graph["Microsoft Graph / Outlook Calendar"]
    EA --> ContactsPush["Akce 'Push to Outlook'"]
    ContactsPush --> People["Outlook Contacts API"]
    EA --> MailOAuth["OAuth2 IMAP/SMTP<br/>Outlook/Office365"]

Datové objekty a vazby

Objekt Účel Napojení
Externí účet Outlook (ExternalAccount) Uchovává OAuth tokeny a uživatelská nastavení pro kalendáře/kontakty/e-mail. Vazba na uživatele; integrace Outlook.
Schůzky / Volání Primární entity, které se synchronizují do kalendáře Outlooku. Aktualizuje je job SyncOutlookCalendar.
Kontakty / Leady Lze ručně odeslat do Outlooku přes akci "Push to Outlook". Volá endpoint OutlookContacts/action/push.
E-mailové účty IMAP/SMTP konfigurace využívá moderní OAuth; panel "Outlook" se zobrazuje jen pokud server obsahuje office365. nebo .outlook.com. Řízeno outlook:inbound-email-dynamic-handler.

Konfigurační pole

  • Integrační údaje (admin): clientId, clientSecret, tenant z registrace aplikace v Azure AD (Microsoft Entra ID). Zadává se v administraci Integrace → Outlook.
  • Uživatelský profil: připojení účtu přes Externí účty → Outlook; po připojení se aktivují panely pro kalendář/kontakty/e-mail.

Automatizace a joby

  • SyncOutlookCalendar (cron: */10 * * * *) – synchronizuje události mezi CRM a kalendářem Outlook. Job se vytvoří při instalaci modulu a smaže při odinstalaci.
  • Akce Push to Outlook – dostupná z detailu/hromadných akcí Kontaktů/Leadů; využívá endpoint OutlookContacts/action/push.
  • Dynamický panel Outlook na kartě poštovního účtu se zobrazí jen v detailním režimu a pouze při detekci hostitele office365. nebo .outlook.com.

Bezpečnost a omezení

  • Autentizace probíhá přes OAuth 2.0 (Microsoft identity platform); hesla se v CRM neukládají.
  • V edit režimu formuláře e-mailového účtu jsou outlook panely skryty, aby nerušily konfiguraci.
  • Doporučeno ponechat plánování jobu na výchozích 10 minutách; kratší intervaly mohou překročit throttling Microsoft Graph.