Dokumentace k InTouch CRM

Tmavý režim

Google integrace ​

Pro propojení InTouch CRM se službami Google (Gmail, Google Calendar, Google Contacts, Google Maps) je třeba zaregistrovat CRM jako aplikaci v Google API Console a získat autentizační klíče. Tuto registraci provádí administrátor jednou — poté už mohou jednotliví uživatelé přihlašovat své Google účty přímo z CRM.

K čemu to slouží ​

Google se všemi moderními API (OAuth2) vyžaduje, aby každá aplikace, která se k nim připojuje, byla zaregistrovaná pod konkrétním projektem. Tato registrace:

  • Identifikuje CRM vůči Google službám.
  • Nastavuje oprávnění, která CRM smí využít.
  • Umožní uživatelům přihlásit své Google účty do CRM pomocí tlačítka Přihlásit se Google účtem.

Co je potřeba registrovat ​

  1. Projekt v Google Cloud — střešní obal pro integrace.
  2. OAuth Client ID — pro přihlašování uživatelů a čtení Gmailu.
  3. Public API Key — pro Google Maps (geokódování, zobrazení kontaktů na mapě).
  4. Povolení konkrétních API — Gmail, Calendar, Tasks, People, Maps.

Registrace projektu ​

  1. Přejděte na Google API Console a přihlaste se Google účtem, pod kterým chcete projekt spravovat.
  2. Pokud ještě nemáte žádný projekt, Google zobrazí uvítací obrazovku — klepněte na CREATE PROJECT.
  3. Vyplňte název projektu (například "InTouch CRM"). Pole Location není třeba nastavovat.
  4. Potvrďte tlačítkem CREATE.

Při vytváření projektu Google vyžaduje zvolit typ aplikace. Vyberte External (aplikace pro externí uživatele).

Ověření aplikace

Po vytvoření projektu nežádejte o ověření aplikace — je to placená služba Google a pro běžné firemní CRM ji nepotřebujete. Nevýhoda: při autorizaci služeb se uživatelům neověřený projekt hlásí jako potenciálně nebezpečný. Stačí kliknout na Pokračovat.

Jako poslední krok po vytvoření projektu projekt publikujte — klepněte na PUBLISH APP.

OAuth Client ID (pro přihlašování a Gmail) ​

Pokud máte projekt založený a publikovaný, můžete k němu přidat OAuth Client ID:

  1. V horním menu konzole klepněte na Create Credentials → OAuth Client ID.
  2. Application type — zvolte Web application.
  3. Name — doporučujeme InTouch CRM.
  4. Authorized JavaScript URIs — doména, na které běží vaše CRM (zkopírujte ji z Aplikační nastavení → Rozšířené → Adresa javascript aplikace).
  5. Authorized Redirect URIs — zkopírujte z Aplikační nastavení → Rozšířené → Adresa web aplikace.
  6. Uložte.

Po vytvoření si otevřete detail vygenerovaného Client ID a zkopírujte hodnoty Client ID a Client Secret.

V CRM je vložte do Nastavení → Aplikační nastavení → Rozšířené do polí Google Client ID a Google Client Secret.

Po tomto kroku budou moci uživatelé přihlásit svůj Gmail účet do CRM přes Nastavení → E-mailové účty → Přihlásit se Google účtem.

Public API Key (pro Google Maps) ​

Pro zobrazování kontaktů na mapě a zjišťování GPS souřadnic z adresy:

  1. V konzoli v levém panelu zvolte APIs Manager → Library.
  2. Vyhledejte a povolte:
    • Google Maps JavaScript API — pro zobrazení kontaktů na mapě.
    • Google Maps Geocoding API — pro převod adresa → souřadnice.
  3. Přejděte na Credentials → Create Credentials → API key.
  4. Volitelně omezte klíč na HTTP referrery (doménu vašeho CRM).

Vygenerovaný klíč vložte v CRM do Aplikační nastavení → Rozšířené → Google Public API KEY.

Povolení Calendar / Tasks / Contacts API ​

Pro synchronizaci kalendáře, úkolů a kontaktů povolte v APIs Manager → Library tato tři API:

  • Google Tasks API — pro synchronizaci úkolů.
  • Google Calendar API — pro synchronizaci kalendáře.
  • Google People API — pro synchronizaci kontaktů.

U každého klepněte na Enable. Úspěšně povolené API poznáte podle odznaku API enabled.

Viz také ​