Zpracování e-mailů

UCS umožňuje zpracování e-mailů v režimu kontaktního centra, tzn. několik e-mailových schránek je obsluhováno agenty, vč. podpory skillů, jazykových dovedností, vedení komunikace v CRM, atp.

Architektura

Objekt	Význam
E-mail queue	Zpracování e-mailů probíhá v jedné nebo více frontách.
E-mail source	Provádí výběr e-mailů ze schránky a jejich doručení do fronty.
E-mail sender	Provádí odesílání odpovědí na e-maily.

Příjem e-mailů

Každý E-mail source vybírá právě jednu schránku pomocí protokolu IMAP nebo POP3 a doručuje e-maily právě do jedné fronty.

Google OAuth

Preferovaná metoda přihlášení ke schránce je pomocí mechanizmu OAauth (IMAP XOAuth). Samotné povolení přihlášení ke schránce se provádí až prostřednictvím UCS, kdy se provede přihlášení za příslušný Google účet. Nastavení se provádí v Google Could Console:

1. APIs & Services
2. Přidejte nový projekt pomocí tlačítka Add Project
3. Vyberte Overview v levém menu and na zobrazené stránce kliněte na Configure
   • App name: UCS IMAP and SMTP XOAUTH
   • User support email: it@firma.cz
   • Audience: Internal
   • Contact Information: it@firma.cz
4. Přidání dokočete kliknutím na tlačítko Create
5. V levém menu vyberte Clients
6. V horní nabídce klikněte na + Create client
   • Application type: Web application
   • Name: UCS
   • Authorized JavaScript origins: https://ucs.firma.cz (pozor, nesmí končit lomítkem)
   • Authorized redirect URIs: https://ucs.firma.cz/login/oauth2/google
7. Uložte si Client ID a Client secret z dialogu OAuth client created.
8. V sekci Data Access klikněte na tlačítko Add or remove scopes
9. Vyberte Manually add scopes: https://mail.google.com/ (poté klikněte na Add to table and then Update)

Následně přejdětě do administrace UCS:

1. Vyberte ☰ System → SSO providers.
2. Klikněte na + add SSO provider a zadejte parametry:
   • Type: Google OAuth
   • Client ID: 123456789-copiedClientId.apps.googleusercontent.com
   • Client secret: GABCDEF-copiedClientSecretFromGoogleCloudConsoel
   • Scope: https://mail.google.com/
3. Klikněte na Insert.
4. V seznamu SSO providerů klikněte na 🔑 a proveďte přihlášení uživatelským účtem e-mailové schránky.
5. Zapamatujte si ID providera Google OAuth (při editaci se zobrazuje v titulku dialogu).
6. Přejděte do ☰ Messaging → Email sources.
7. Klikněte na + add email source a zadejte parametry:
   • Server type: IMAP
   • Server address: imap.gmail.com
   • Service port: 993
   • Use SSL connection: ☑
   • Username: email.schranky@firma.cz
   • Password: http://127.0.0.1:8080/api/v1.0/auth/token/2 (poslední číslici 2 změňte za ID Google OAuth SSO providera).
8. Klikněte na Insert.

info

Pokud budete vybírat více schránek, pak je nutné vytvořit více Google OAuth SSO providerů, které budou mít společné údaje Client ID a Client secret (v Google bude existovat pouze jeden OAuth projekt). V UCS bude pro každou schránku založen Google OAuth SSO provider na kterém se provede přihlášení pomocí 🔑 právě k jedné dané scrhánce.

Odesílání e-mailů

Pro odesílání e-mailů pro každou jednu adresu se založí jeden E-mail sender, který je možné využít ve více frontách.

Google OAuth

Preferovaná metoda ověření odesilatele e-mailu se provádí pomocí mechanizmu OAauth (SMTP XOAuth). Využije se existující Google E-mail source nebo se přidá stejným postupem.

1. Přejděte do ☰ Messaging → Email senders.
2. Klikněte na + add email sender a zadejte parametry:
   • Server type: STARTTLS
   • Server address: smtp.gmail.com
   • Service port: 587
   • Sender username: email.schranky@firma.cz
   • Sender password: http://127.0.0.1:8080/api/v1.0/auth/token/2 (poslední číslici 2 změňte za ID Google OAuth SSO providera).
   • Sender e-mail address: email.schranky@firma.cz
3. Klikněte na Insert.