Přeskočit obsah

Google Integrace

Modul Google Integrace propojuje AutoCRM s Google Calendar, Google Contacts a Gmail. Přináší obousměrnou synchronizaci událostí, bezpečnou správu kontaktů a moderní OAuth2 přihlášení k e-mailovým schránkám – bez ukládání hesel do CRM.


Přehled modulu

flowchart LR
    CRM[AutoCRM
    Schůzky/Volání
    Kontakty/Leady] <--> GCal[Google Calendar]
    CRM <--> GCon[Google Contacts]
    CRM --> GGmail[Gmail IMAP/SMTP
    OAuth2]

    classDef crm fill:#f7f7f7,stroke:#111;
    classDef g fill:#fff,stroke:#4285F4;
    class CRM crm;
    class GCal,GCon,GGmail g;

Kdy modul použít

  • potřebujete mít obchodní kalendář a kontakty dostupné i v mobilních aplikacích Google,
  • chcete posílat a přijímat poštu z Gmailu bez „méně bezpečných aplikací“,
  • požadujete auditovatelný a spravovatelný datový tok mezi CRM a Google ekosystémem.

Klíčové funkce

  • Kalendář: obousměrná synchronizace schůzek/volání (výběr směru a kalendářů, kontrola duplicit přes googleCalendarEventId).
  • Kontakty: synchronizace vybrané Google skupiny; ruční push z detailu nebo hromadně.
  • Gmail: moderní OAuth2 IMAP/SMTP, panel s informací o propojení v detailu poštovního účtu.

Hlavní objekty

Entita Popis API
Externí účet Google OAuth tokeny a uživatelská nastavení pro kalendář, kontakty, Gmail. ExternalAccount
Google kalendář Lokální katalog Google kalendářů a jejich ID. GoogleCalendar
Přirazení kalendáře uživateli Typ (hlavní/monitorovaný), role a tokeny pro sync. GoogleCalendarUser
Přirazení Google kontaktu Spojení kontaktu/leadu s kartou v Google (resourceName, etag). GoogleContactsPair

Toky synchronizace

flowchart TD
    A[Uživatel připojí účet
    (OAuth2)] --> B[Externí účet Google]
    B --> C[Job
    "SynchronizeEventsWithGoogleCalendar"
    */10 min]
    C <--> D[Schůzky / Volání]
    C <--> E[Google Calendar]
    B --> F[Push to Google kontakty]
    F <--> G[Google People API]
  1. Uživatel připojí účet v Externí účty → Google.
  2. Job každých 10 minut synchronizuje schůzky/volání dle směru a vybraných kalendářů.
  3. Kontakty/Leady lze poslat do Google ručně (akce „Push to Google“) do zvolené skupiny.
  4. Gmail používá OAuth2 pro IMAP/SMTP; panel je viditelný jen pro Gmail hosty.

Rychlý start

  1. Admin: vytvořte OAuth Client v Google Cloud Console a vyplňte clientId/clientSecret v Správa → Integrace → Google.
  2. Admin: ověřte, že je naplánován job SynchronizeEventsWithGoogleCalendar (*/10 min).
  3. Uživatel: připojte svůj účet v Externí účty → Google, povolte produkty (Kalendář/Kontakty/Gmail) a vyberte hlavní kalendář/skupinu.
  4. Kontrola: vytvořte schůzku v CRM a ověřte její vznik v Google kalendáři; případně spusťte ruční push kontaktu.

Další sekce

  • Používání – jak připojit účet a nastavit synchronizaci.
  • Správa – registrace aplikace v Google Cloud a globální nastavení.
  • Reference – datový model, pole, joby a podmínky zobrazení panelů.