Gmail

Gmail umožňuje bezpečnou práci s Gmail účtem přes oficiální Gmail API. Integrace poskytuje čtení, tvorbu a odesílání e-mailů, které lze kombinovat s GPT modely a firemními workflows.

Rychlé připojení

Pro vytvoření stačí kliknout na Add Connection, vybrat Gmail a stránka se automaticky přesměruje na Google přihlášení. Po přihlášení je účet propojen.

Available Operations

1. CreateDraft

Vytvoří nový koncept e-mailu (draft) v Gmail schránce.

Parameter	Type	Required	Description
body	String	Yes	Text e-mailu (plain)
subject	String	Yes	Předmět e-mailu
to	String	Yes	E-mailová adresa
attachmentsJson	String	Ne	Volitelné JSON pole příloh předané jako řetězec. Viz předání přílohy ve workflow.

Use cases: automatizované generování e-mailů AI modelem, příprava ke schválení, šablony/návrhy.

2. SendEmailAsync

Odešle e-mail přímo z Gmail účtu.

Parameter	Type	Required	Description
body	String	Yes	Text e-mailu
subject	String	Yes	Předmět e-mailu
to	String	Yes	Adresa příjemce
attachmentsJson	String	Ne	Volitelné JSON pole příloh předané jako řetězec. Viz předání přílohy ve workflow.

Use cases: automatické notifikace, sales/marketing sekvence, follow-upy, reporty generované AI.

3. ListInboxAsync

Získá seznam nejnovějších zpráv v inboxu.

Parameter	Type	Required	Description
includeSpamTrash	Bool	No	Zahrnout spam a koš
maxResults	Int	No	Počet vrácených zpráv

Use cases: AI agenti pro e-mail, sumarizace inboxu, kategorizace a routing, detekce prioritních zpráv.

4. GetMessageAsync

Získá kompletní obsah konkrétní zprávy včetně metadat.

Parameter	Type	Required	Description
messageId	String	Yes	ID zprávy v Gmail API

Use cases: analýza obsahu pomocí GPT, extrakce dat (objednávky, kontakty, SLA), rekonstrukce threadů, kontext pro automatické odpovědi.

5. ListAttachmentsAsync

Vypíše přílohy zprávy. Ke stažení použijte vrácený identifikátor přílohy; samotný název souboru jej nenahrazuje.

Parametr	Typ	Povinný	Popis
messageId	String	Ano	ID zprávy v Gmailu obsahující přílohy

6. DownloadAttachmentAsync

Stáhne jednu přílohu. Vyberte, zda potřebujete čitelný text, původní soubor, nebo obojí.

Parametr	Typ	Povinný	Popis
messageId	String	Ano	ID zprávy v Gmailu obsahující přílohu
attachmentId	String	Ano	Identifikátor přílohy vrácený funkcí ListAttachmentsAsync
mode	String	Ne	text (výchozí), file nebo both

Režim	Vrácená data	Extrakce textu přes FileReader	Limit přílohy
text (výchozí)	Extrahovaný text v Content	Ano	25 MiB
file	Původní soubor v FileBase64	Ne	2 MiB
both	Původní soubor a extrahovaný text, pokud je dostupný	Ano	2 MiB

file vrací původní bajty přílohy zakódované v Base64. Po dekódování získáte nezměněný PDF, obrázek nebo ZIP, nikoli text extrahovaný z PDF. Stávající workflow bez parametru mode nadále používají text.

Výstup stále obsahuje název souboru, MIME typ a velikost. V souborových režimech popisuje ExtractionStatus výsledek získávání textu:

Stav	Význam
notRequested	Extrakce textu nebyla požadována (režim file).
succeeded	Extrakce textu se podařila.
unavailable	Extrahovaný text není dostupný.
failed	Extrakce textu selhala.

V režimu both neúspěšná extrakce textu nezahodí původní soubor. Odpověď se ale stále musí vejít do limitů popsaných níže.

Předání přílohy ve workflow

Například stáhněte fakturu ze zprávy a přiložte původní PDF k novému konceptu:

1. Zavolejte ListAttachmentsAsync s původním messageId a vyberte přílohu.
2. Zavolejte DownloadAttachmentAsync se stejným messageId, vráceným attachmentId a parametrem mode nastaveným na file.
3. Z výstupu stahování StructuredOutput převezměte FileName, MimeType a FileBase64.
4. Namapujte tato pole do jedné položky JSON pole a předejte jej jako volitelný řetězec attachmentsJson do CreateDraft nebo SendEmailAsync.

Pole výstupu stahování	Pole položky v attachmentsJson
FileName	fileName (povinné)
MimeType	mimeType (volitelné)
FileBase64	fileBase64 (povinné)

Následuje ukázka datového formátu, nikoli syntaxe workflow editoru. Představuje malý textový soubor s obsahem Hello. U skutečné přílohy použijte stažené hodnoty a pole serializujte do řetězce attachmentsJson.

[
  {
    "fileName": "hello.txt",
    "mimeType": "text/plain",
    "fileBase64": "SGVsbG8="
  }
]

Base64 je pouze ve StructuredOutput, nikoli v LlmText. Workflow jej může předat přímo, aniž by ho LLM opisovalo nebo dekódovalo. Jde o popis datového kontraktu; workflow musí výstup výslovně namapovat do vstupu následující operace. Vytvoření konceptu e-mail neodešle.

Limity příloh a ukládání

• Jedna příloha: file a both přijímají nejvýše 2 MiB; text zachovává limit 25 MiB.
• Odpověď stahování: souborové režimy navíc kontrolují přibližně 3 MiB pro textové části odpovědi. V režimu both může limit překročit i menší soubor, pokud z něj vznikne velké množství extrahovaného textu.
• Společné odeslání: Iterator zpracuje přílohy jednotlivě, ale neodstraní limit následného společného požadavku. Dvě přílohy po 2 MiB vytvoří přes 5 MiB samotného Base64. To překračuje výchozí přijímací limit gRPC 4 MiB, pokud přijímající služba nemá jiné nastavení. Tyto režimy stahování nastavení nezvyšují. Jde o limit přenosu, oddělený od limitů samotného Gmailu. Viz dokumentace konfigurace gRPC od Microsoftu.
• Cílové API: přímé předání funguje pouze tehdy, když cílové API přijímá Base64 v JSON. Tyto režimy nepřidávají multipart/form-data, binární HTTP upload ani obecnou podporu souborových vstupů.
• Ukládání souborů: celý soubor cestuje jako Base64 řetězec v JSON. Tyto režimy nepřidávají Azure Blob Storage, odkaz ke stažení ani opakovaně použitelný fileRef.
• Historie workflow: Base64 se může uložit jako součást historie výstupů workflow. Bez Azure tedy neznamená, že se příloha nikde neukládá.

Capabilities Enabled by Gmail Integration

• AI-enhanced drafting: generování návrhů e-mailů z kontextu a firemních dat.
• AI inbox agent: automatické odpovědi, štítkování, prioritizace, sumarizace threadů.
• Automation workflows: follow-upy, eskalace, onboarding sekvence, klientská komunikace.
• Data extraction: strukturovaná data z e-mailů, převod do ticketing/CRM/ERP, návaznosti na interní systémy.

Requirements for Integration

1. Google Cloud Project: aktivované Gmail API, vytvořený OAuth 2.0 Client ID, autorizované redirect URL pro Siesta AI.
2. OAuth 2.0 Authorization: uživatel udělí přístup; typické scope:
   • https://www.googleapis.com/auth/gmail.readonly
   • https://www.googleapis.com/auth/gmail.modify
   • https://www.googleapis.com/auth/gmail.send
3. Secure token storage: tokeny jsou šifrované, s automatickou rotací refresh tokenů.
4. Google API quotas & rate limits: minimalizujte volání GetMessageAsync, batchujte inbox operace, cacheujte metadata.
5. Governance & controls: validace e-mailů před odesláním, whitelisting adres/domén, audit logy, schvalovací workflows.

Security Considerations

• E-maily ani metadata se neukládají bez explicitního účelu.
• Přístupové tokeny jsou šifrovány a pravidelně obnovovány.
• Každá operace je auditovatelná; Siesta AI neodesílá e-mail bez schválení nebo politiky organizace.

Jak se připojit (OAuth)

1. Add Connection -> vyber Gmail (stejný výběr pro Gmail/Google Calendar/Google Search).

2. Přihlášení přes Google (OAuth login).
   

3. Potvrď název integrace (interní jméno v Siesta AI).
   

4. Souhlas s oprávněními (scopy dle Gmail integrace).
   

Závěr

Integrace Gmailu dává Siesta AI spolehlivý a bezpečný způsob, jak automatizovat firemní komunikaci. Kombinace Gmail API a AI orchestrace zrychluje práci s e-maily, umožňuje analýzu příchozích informací a automatizuje rutinní úkoly.

Kontrola OAuth připojení

Při expiraci autorizace nebo chybějícím scope nechá vlastník účet znovu připojit a před potvrzeným odesláním otestuje read operaci. Kontrola health a reautorizace oddělí credential, scope, síťovou a funkční chybu.