Gmail-toiminnot

Automatisoi sähköpostityöskentelysi kattavilla Gmail-toiminnoilla. Lähetä sähköposteja, hallitse luonnoksia, etsi saapuneet viestit ja käsittele sähköpostikeskusteluja — kaikki SmartFlow'ssa.

---

Esivaatimukset

Ennen Gmail-toimintojen käyttöä sinun on:

1. Yhdistettävä Gmail-tilisi kohdassa Kanavat → Gmail
2. Valtuutettava tarvittavat oikeudet Google OAuthin kautta

Katso Gmail-kanavan asetukset saadaksesi yksityiskohtaiset ohjeet yhteyden muodostamiseen.

---

Saatavilla olevat laukaisimet

📥 Gmail AI Luonnos

Laukaisijatyyppi: CHAT_SERVICE

Laukaistaan, kun käyttäjä lähettää sähköpostin liitettyyn Gmail-instanssiisi. Käytä tätä automaattiseen saapuvien sähköpostien käsittelyyn AI:n avulla.

Kenttä	Kuvaus
Kanava	Gmail
Tapahtuma	Uusi sähköposti vastaanotettu

Esimerkki työnkulusta:

Gmail AI Luonnos (Laukaisin)
    ↓
AI-pyyntö (Analysoi sähköpostin sisältö)
    ↓
Luo Gmail-luonnos (Generoi AI-vastaus)

---

Saatavilla olevat toiminnot

Toiminto	Koodi	Kuvaus
📤 Lähetä Gmail-sähköposti	GMAIL_SEND_EMAIL	Lähetä uusi sähköposti suoraan
📬 Lue Gmail-sähköposteja	GMAIL_READ_EMAILS	Hae sähköposteja saapuneista
📧 Hae Gmail-sähköposti	GMAIL_GET_EMAIL	Hae tietty sähköposti ID:n perusteella
↩️ Vastaa Gmail-sähköpostiin	GMAIL_REPLY	Vastaa olemassa olevaan sähköpostikeskusteluun
🔍 Etsi Gmail-sähköposteja	GMAIL_SEARCH	Etsi sähköposteja Gmailin kyselysyntaksilla
✅ Merkitse Gmail-sähköposti luetuksi	GMAIL_MARK_READ	Merkitse sähköposti luetuksi
📝 Luo Gmail-luonnos	GMAIL_CREATE_DRAFT	Luo uusi sähköpostiluonnos
📋 Listaa Gmail-luonnokset	GMAIL_LIST_DRAFTS	Listaa kaikki luonnokset tililtäsi
📨 Lähetä Gmail-luonnos	GMAIL_SEND_DRAFT	Lähetä olemassa oleva luonnos
🗑️ Poista Gmail-luonnos	GMAIL_DELETE_DRAFT	Poista luonnos
📂 Hae sähköpostikeskustelu	GMAIL_GET_THREAD	Hae koko sähköpostikeskustelu

---

📤 Lähetä Gmail-sähköposti

Lähetä uusi sähköposti suoraan liitetystä Gmail-tilistäsi.

Konfigurointi

Kenttä	Tyyppi	Pakollinen	Kuvaus
Vastaanottaja	Sähköposti	✅	Vastaanottajan sähköpostiosoite
Aihe	Merkkijono	✅	Sähköpostin aihe
Sisältö	Merkkijono	✅	Sähköpostin sisältö (HTML tuettu)
CC	Sähköposti	❌	Kopiot vastaanottajista
BCC	Sähköposti	❌	Piilokopiot vastaanottajista

Tulostusmuuttujat

Muuttuja	Tyyppi	Kuvaus
messageId	Merkkijono	Lähetetyn sähköpostin ainutlaatuinen ID
threadId	Merkkijono	Keskustelun ID vastauksille

Esimerkki

Toiminto: Lähetä Gmail-sähköposti
  Vastaanottaja: "{{customer_email}}"
  Aihe: "Tilauksesi #{{order_id}} on lähetetty!"
  Sisältö: |
    Hei {{customer_name}},
    
    Hyviä uutisia! Tilauksesi on lähetetty.
    
    Seurantanumero: {{tracking_number}}
    
    Parhain terveisin,
    Tiimi

---

📬 Lue Gmail-sähköposteja

Hae äskettäisiä sähköposteja saapuneista valinnaisella suodattamisella.

Konfigurointi

Kenttä	Tyyppi	Pakollinen	Kuvaus
Maksimi tulokset	Numero	❌	Enimmäismäärä haettavia sähköposteja (oletus: 10)
Tunniste	Merkkijono	❌	Gmail-tunniste suodattamiseen (esim. "SAAPUNEET", "LUETTAVAT")
Kysely	Merkkijono	❌	Gmail-hakukysely

Tulostusmuuttujat

Muuttuja	Tyyppi	Kuvaus
emails	Taulukko	Lista sähköpostiesineistä
emails[].id	Merkkijono	Sähköpostin ID
emails[].subject	Merkkijono	Sähköpostin aihe
emails[].from	Merkkijono	Lähettäjän sähköposti
emails[].snippet	Merkkijono	Sähköpostin esikatselu
emails[].date	Merkkijono	Vastaanottopäivämäärä

Esimerkki

Toiminto: Lue Gmail-sähköposteja
  Maksimi tulokset: 5
  Tunniste: "LUETTAVAT"
  Kysely: "from:support@example.com"

---

📧 Hae Gmail-sähköposti

Hae tietty sähköposti sen ID:n perusteella täydellä sisällöllä.

Konfigurointi

Kenttä	Tyyppi	Pakollinen	Kuvaus
Sähköpostin ID	Merkkijono	✅	Gmail-viestin ID

Tulostusmuuttujat

Muuttuja	Tyyppi	Kuvaus
email	Objekti	Täysi sähköpostiesine
email.id	Merkkijono	Sähköpostin ID
email.threadId	Merkkijono	Keskustelun ID
email.subject	Merkkijono	Sähköpostin aihe
email.from	Merkkijono	Lähettäjä
email.to	Merkkijono	Vastaanottajat
email.body	Merkkijono	Täysi sähköpostin sisältö
email.date	Merkkijono	Vastaanottopäivämäärä
email.attachments	Taulukko	Lista liitteistä

---

↩️ Vastaa Gmail-sähköpostiin

Vastaa olemassa olevaan sähköpostiin säilyttäen keskustelun konteksti.

Konfigurointi

Kenttä	Tyyppi	Pakollinen	Kuvaus
Keskustelun ID	Merkkijono	✅	Keskustelu, johon vastataan
Viestin ID	Merkkijono	✅	Tietty viesti, johon vastataan
Sisältö	Merkkijono	✅	Vastaussisältö
Vastaa kaikille	Boolean	❌	Vastaa kaikille vastaanottajille (oletus: false)

Tulostusmuuttujat

Muuttuja	Tyyppi	Kuvaus
messageId	Merkkijono	Vastauksen ID
threadId	Merkkijono	Keskustelun ID

Esimerkki

Toiminto: Vastaa Gmail-sähköpostiin
  Keskustelun ID: "{{email.threadId}}"
  Viestin ID: "{{email.id}}"
  Sisältö: |
    {{ai_response}}
    
    ---
    Tämä on AI-avustettu vastaus.

---

🔍 Etsi Gmail-sähköposteja

Etsi Gmailistasi Gmailin tehokkaalla kyselysyntaksilla.

Konfigurointi

Kenttä	Tyyppi	Pakollinen	Kuvaus
Kysely	Merkkijono	✅	Gmail-hakukysely
Maksimi tulokset	Numero	❌	Enimmäistulokset (oletus: 10)

Gmailin kyselysyntaksi

Kysely	Kuvaus
from:email@example.com	Sähköpostit tietyltä lähettäjältä
to:email@example.com	Sähköpostit tietyille vastaanottajille
subject:keyword	Aihe sisältää avainsanan
is:unread	Vain lukemattomat sähköpostit
is:starred	Tähtimerkityt sähköpostit
has:attachment	Sähköpostit, joissa on liitteitä
after:2025/01/01	Sähköpostit päivämäärän jälkeen
before:2025/12/31	Sähköpostit päivämäärää ennen
label:important	Sähköpostit, joissa on tunniste
"exact phrase"	Tarkka lauseen osuma

Esimerkki

Toiminto: Etsi Gmail-sähköposteja
  Kysely: "from:{{customer_email}} is:unread subject:order"
  Maksimi tulokset: 5

---

✅ Merkitse Gmail-sähköposti luetuksi

Merkitse sähköposti luetuksi Gmailissa.

Konfigurointi

Kenttä	Tyyppi	Pakollinen	Kuvaus
Sähköpostin ID	Merkkijono	✅	Sähköposti, joka merkitään luetuksi

Esimerkki

Toiminto: Merkitse Gmail-sähköposti luetuksi
  Sähköpostin ID: "{{email.id}}"

---

📝 Luo Gmail-luonnos

Luo luonnossähköposti ihmisen tarkistettavaksi ennen lähettämistä.

Konfigurointi

Kenttä	Tyyppi	Pakollinen	Kuvaus
Vastaanottaja	Sähköposti	✅	Vastaanottajan sähköposti
Aihe	Merkkijono	✅	Sähköpostin aihe
Sisältö	Merkkijono	✅	Sähköpostin sisältö
CC	Sähköposti	❌	Kopiot
BCC	Sähköposti	❌	Piilokopiot
Keskustelun ID	Merkkijono	❌	Luonnosvastauksille

Tulostusmuuttujat

Muuttuja	Tyyppi	Kuvaus
draftId	Merkkijono	Luodun luonnoksen ID
messageId	Merkkijono	Viestin ID

Käyttötapa: AI-luonnostila

Laukaisin: Gmail AI Luonnos
    ↓
AI-pyyntö:
  Kehotus: "Generoi ammattimainen vastaus tähän sähköpostiin"
  Syöte: "{{email.body}}"
    ↓
Luo Gmail-luonnos:
  Vastaanottaja: "{{email.from}}"
  Aihe: "Re: {{email.subject}}"
  Sisältö: "{{ai_response}}"

---

📋 Listaa Gmail-luonnokset

Hae kaikki luonnokset Gmail-tililtäsi.

Konfigurointi

Kenttä	Tyyppi	Pakollinen	Kuvaus
Maksimi tulokset	Numero	❌	Enimmäislukemattomat luonnokset

Tulostusmuuttujat

Muuttuja	Tyyppi	Kuvaus
drafts	Taulukko	Lista luonnosobjekteista
drafts[].id	Merkkijono	Luonnoksen ID
drafts[].message	Objekti	Luonnosviestin esikatselu

---

📨 Lähetä Gmail Luonnos

Lähetä olemassa oleva luonnos Gmailistasi.

Konfiguraatio

Kenttä	Tyyppi	Pakollinen	Kuvaus
Luonnos ID	Merkkijono	✅	Lähetettävä luonnos

Tulostettavat Muuttujat

Muuttuja	Tyyppi	Kuvaus
messageId	Merkkijono	Lähetetyn viestin ID
threadId	Merkkijono	Thread ID

---

🗑️ Poista Gmail Luonnos

Poista luonnos Gmail-tililtäsi.

Konfiguraatio

Kenttä	Tyyppi	Pakollinen	Kuvaus
Luonnos ID	Merkkijono	✅	Poistettava luonnos

---

📂 Hae Sähköpostikeskustelu

Hae täydellinen sähköpostikeskustelu.

Konfiguraatio

Kenttä	Tyyppi	Pakollinen	Kuvaus
Thread ID	Merkkijono	✅	Haettava keskustelu

Tulostettavat Muuttujat

Muuttuja	Tyyppi	Kuvaus
thread	Objekti	Täydellinen thread-objekti
thread.id	Merkkijono	Thread ID
thread.messages	Taulukko	Kaikki viestit keskustelussa
thread.historyId	Merkkijono	Historia ID

Esimerkki

Toimenpide: Hae Sähköpostikeskustelu
  Thread ID: "{{email.threadId}}"

---

Kokonaiset Työnkulku Esimerkit

Esimerkki 1: AI Sähköpostiavustaja

Käsittele saapuvia sähköposteja automaattisesti ja luo AI: n generoimia luonnosvastauksia.

Gmail AI Luonnos (Käynnistin)
    ↓
Hae Sähköpostikeskustelu (Hae koko konteksti)
    ↓
AI Pyyntö
  - Järjestelmä: "Olet avulias sähköpostiavustaja"
  - Syöte: "{{thread.messages}}"
  - Tuotos: Rakenteellinen (vastaus, tunne, kiireellisyys)
    ↓
Jos Ehto: kiireellisyys == "korkea"
    ├── Kyllä: Lähetä Gmail Sähköposti (välitön vastaus)
    └── Ei: Luo Gmail Luonnos (tarkistettavaksi)

Esimerkki 2: Sähköpostin Haku & Käsittely

Hae tiettyjä sähköposteja ja käsittele niitä suurina erinä.

Aikataulutettu Työnkulku (Päivittäin klo 9)
    ↓
Hae Gmail Sähköposteja
  Kysely: "is:unread from:customers@* after:yesterday"
    ↓
Jokaiselle: sähköposti sähköposteissa
    ↓
AI Pyyntö (Luokittele sähköposti)
    ↓
Jos Ehto: kategoria == "tuki"
    └── Luo JIRA Ongelma

Esimerkki 3: Luonnoksen Tarkistus Työnkulku

Luo luonnoksia, anna ihmisten tarkistaa, sitten lähetä.

Gmail AI Luonnos (Käynnistin)
    ↓
AI Pyyntö (Generoi vastaus)
    ↓
Luo Gmail Luonnos
    ↓
Lähetä Slack Viesti
  "Uusi luonnos valmis tarkistettavaksi käyttäjältä {{email.from}}"

---

Parhaat Käytännöt

1. Käytä Luonnos Tilaa Kriittisille Sähköposteille

Asiakkaalle suunnatuissa tai arkaluontoisissa sähköposteissa käytä aina Luo Gmail Luonnos sen sijaan, että käyttäisit Lähetä Gmail Sähköposti. Tämä mahdollistaa ihmisten tarkistuksen ennen lähettämistä.

2. Hyödynnä Keskustelun Konteksti

Käytä Hae Sähköpostikeskustelu ennen vastaamista varmistaaksesi, että AI: llasi on koko keskustelun konteksti.

3. Ota Käyttöön Nopeusrajoitukset

Gmaililla on API-kvotat. Suurten työnkulkujen osalta:

• Lisää viiveitä toimintojen välille
• Käsittele toiminnot erissä, kun se on mahdollista
• Seuraa kvotan käyttöäsi

4. Käytä Älykkäitä Hakukyselyitä

Yhdistä Gmailin kyselyoperaattoreita tarkkaa suodatusta varten:

from:vip-customer@* is:unread subject:(urgent OR critical) after:2025/01/01

5. Käsittele Virheitä Sujuvasti

Käytä Jos Ehto -solmuja virheiden tarkistamiseen ja varajärjestelmän toteuttamiseen.

---

Liittyvä Dokumentaatio

• Gmail Kanavan Asetus
• Lähetä Sähköposti Toiminto (Yleinen SMTP)
• AI Pyyntö Toiminto
• Jos Ehto
• SmartFlow Johdanto