MS Graph (e-mail)

MS Graph je napojení TAS na Microsoft 365 schránky: umí z příchozí pošty zakládat případy a umí přes Graph (nebo přes SMTP s OAuth2) odesílat poštu z TAS. Nastavuje ho administrátor v Cronech a v Konfiguraci; vyžaduje registraci aplikace v Microsoft Entra ID. EWS (starší napojení na Exchange Web Services) v 5.19.12 už v TAS není – jedinou podporovanou cestou je MS Graph.

Zakládání případů z příchozí pošty

O stahování pošty a zakládání případů se starají dva crony – smí běžet jen jeden z nich najednou, TAS to sám hlídá a druhý cron zablokuje:

CronPoznámka
Create Processes from MS Graph mailsStarší varianta.
Create Processes from MS Graph mails (v2)Nástupce, doporučený pro nové nasazení. Při upgradu instalace, která používala starší cron, TAS automaticky založí v2 variantu se stejným nastavením, ale needaktivní – aktivujete ji sami, až ověříte, že nastavení sedí.

Samostatný cron MsGraphCheckUnprocessedMailsCron hlídá, jestli ve schránce nezůstává nezpracovaná pošta, například kvůli chybě při zpracování.

Nastavení cronu v2

ParametrVýznam
amountOfEmailByRunKolik e-mailů cron zpracuje za jeden běh (výchozí 100).
runSummary.log / .sendEmail / .emailAddressesZda se má běh zalogovat a/nebo poslat souhrnný e-mail, a komu.
items[]Jedna položka = jedna sledovaná schránka/složka; cron jich může mít nastaveno víc najednou.
items[].auth.emailAddressAdresa schránky, ze které se čte.
items[].auth.tenantId, .clientId, .clientSecretÚdaje aplikace registrované v Entra ID (viz níže). Platí jen pro type: "secret".
items[].auth.typesecret (aplikace s Client secretem) nebo dedicated (interaktivní přihlášení bez uloženého secretu).
items[].auth.scopeRozsah oprávnění; když zůstane prázdný, použije se https://graph.microsoft.com/.default (všechna aplikační oprávnění, která administrátor Entra ID aplikaci schválil).
items[].folders.in.id / .out.idID složky, ze které se čte, a kam se zprávy po zpracování přesunou.
items[].process.user_id, .tproc_id, .header_idJako jaký uživatel a do jaké šablony/hlavičky se případ založí.
items[].mapping, .headerMappingMapování polí e-mailu (předmět, tělo, odesílatel, přílohy) na proměnné případu.
items[].messageClass.enabled, .allowedPrefixes, .ignoredClassesOmezení na typ zprávy (např. vynechání automatických odpovědí).
items[].config.setEmailProcessedOnErrorZda se e-mail i po chybě označí jako zpracovaný, aby se cron nezasekl na stejné zprávě.
items[].config.ignoreAllAttachments / .ignoreSpecificAttachments / .ignoredAttachmentTypes / .ignoreInlineAttachmentsŘízení toho, které přílohy se k případu připojí.
items[].config.attachEmailAsPdfPřiloží samotný e-mail jako PDF.
items[].config.useEmailObjectInDataHolderZpřístupní celý e-mail jako objekt pro výpočty šablony místo mapování na jednotlivé proměnné.
Objevení ID složek
ID složek schránky pro folders.in/folders.out zjistíte voláním administrátorského endpointu POST /ms-graph/discover-folders, nemusíte je hledat ručně přes Graph Explorer.

Registrace aplikace v Entra ID

Cron potřebuje aplikaci registrovanou v Microsoft Entra ID s aplikačním oprávněním ke čtení (a případně zápisu) pošty cílové schránky, schváleným administrátorem tenantu. Z registrace potřebujete tenantId, clientId a clientSecret (u varianty secret).

Client secret patří do Trezoru
Do pole clientSecret v parametrech cronu nepište hodnotu napřímo – uložte ji jako tajný klíč do Trezoru a odkažte se na ni {{vault:nazev-klice}}. Stejně postupujte u Client secretu pro odesílání pošty níže.

Odesílání pošty přes Graph nebo SMTP s OAuth2

Odchozí pošta se nastavuje v Konfiguraci (sekce pro e-mail), nezávisle na cronech výše. TAS podporuje dva na sobě nezávislé způsoby:

Typ (integrations.mail.type)Jak fungujeKlíčové parametry
msgraphPošta se posílá přímo přes Graph API (/sendMail), ne přes SMTP.tenantId, clientId, clientSecret, sender, volitelně scope (výchozí .default).
oauth2Klasický SMTP server, ale místo hesla se používá krátkodobý OAuth2 token (obecný mechanismus, nejen pro Microsoft 365).host, port, basicAuth.user (schránka), oauth2.host (token endpoint), oauth2.clientId, oauth2.clientSecret, oauth2.grantType, oauth2.scope.

Obě sady parametrů lze nastavit i proměnnými prostředí (TAS_MAIL_SMTP_TYPE, TAS_MAIL_MSGRAPH_* pro první typ, TAS_MAIL_SMTP_* a TAS_MAIL_OAUTH2_* pro druhý) – podrobnosti k editaci v Konfiguraci popisuje článek Konfigurace.

Související: Crony, Konfigurace, Trezor, Autentizace.

MS Graph - příprava schránky - Legacy
Team assistant (opens in a new tab)

Powered by HelpDocs (opens in a new tab)