Ações do Gmail

Automatize seus fluxos de trabalho de e-mail com ações abrangentes do Gmail. Envie e-mails, gerencie rascunhos, pesquise sua caixa de entrada e gerencie threads de e-mail — tudo dentro do SmartFlow.

---

Pré-requisitos

Antes de usar as ações do Gmail, você deve:

1. Conectar sua conta do Gmail em Canais → Gmail
2. Autorizar as permissões necessárias via Google OAuth

Veja Configuração do Canal Gmail para instruções detalhadas de conexão.

---

Gatilhos Disponíveis

📥 Rascunho de IA do Gmail

Tipo de Gatilho: CHAT_SERVICE

Acionado quando um usuário envia um e-mail para sua instância do Gmail conectada. Use isso para processar automaticamente e-mails recebidos com IA.

Campo	Descrição
Canal	Gmail
Evento	Novo e-mail recebido

Exemplo de Fluxo de Trabalho:

Rascunho de IA do Gmail (Gatilho)
    ↓
Solicitação de IA (Analisar conteúdo do e-mail)
    ↓
Criar Rascunho do Gmail (Gerar resposta da IA)

---

Ações Disponíveis

Ação	Código	Descrição
📤 Enviar E-mail do Gmail	GMAIL_SEND_EMAIL	Enviar um novo e-mail diretamente
📬 Ler E-mails do Gmail	GMAIL_READ_EMAILS	Buscar e-mails da sua caixa de entrada
📧 Obter E-mail do Gmail	GMAIL_GET_EMAIL	Obter um e-mail específico por ID
↩️ Responder E-mail do Gmail	GMAIL_REPLY	Responder a uma thread de e-mail existente
🔍 Pesquisar E-mails do Gmail	GMAIL_SEARCH	Pesquisar e-mails com a sintaxe de consulta do Gmail
✅ Marcar E-mail do Gmail como Lido	GMAIL_MARK_READ	Marcar um e-mail como lido
📝 Criar Rascunho do Gmail	GMAIL_CREATE_DRAFT	Criar um novo rascunho de e-mail
📋 Listar Rascunhos do Gmail	GMAIL_LIST_DRAFTS	Listar todos os rascunhos na sua conta
📨 Enviar Rascunho do Gmail	GMAIL_SEND_DRAFT	Enviar um rascunho existente
🗑️ Excluir Rascunho do Gmail	GMAIL_DELETE_DRAFT	Excluir um rascunho
📂 Obter Thread de E-mail	GMAIL_GET_THREAD	Recuperar toda a conversa de e-mail

---

📤 Enviar E-mail do Gmail

Envie um novo e-mail diretamente da sua conta do Gmail conectada.

Configuração

Campo	Tipo	Obrigatório	Descrição
Para	E-mail	✅	Endereço de e-mail do destinatário
Assunto	String	✅	Linha de assunto do e-mail
Corpo	String	✅	Conteúdo do e-mail (HTML suportado)
CC	E-mail	❌	Destinatários em cópia carbono
BCC	E-mail	❌	Destinatários em cópia carbono oculta

Variáveis de Saída

Variável	Tipo	Descrição
messageId	String	ID único do e-mail enviado
threadId	String	ID da thread para respostas

Exemplo

Ação: Enviar E-mail do Gmail
  Para: "{{customer_email}}"
  Assunto: "Seu pedido #{{order_id}} foi enviado!"
  Corpo: |
    Olá {{customer_name}},
    
    Ótimas notícias! Seu pedido foi enviado.
    
    Número de rastreamento: {{tracking_number}}
    
    Atenciosamente,
    A Equipe

---

📬 Ler E-mails do Gmail

Busque e-mails recentes da sua caixa de entrada com filtragem opcional.

Configuração

Campo	Tipo	Obrigatório	Descrição
Máx Resultados	Número	❌	Máximo de e-mails a serem recuperados (padrão: 10)
Rótulo	String	❌	Rótulo do Gmail para filtrar (ex: "INBOX", "UNREAD")
Consulta	String	❌	Consulta de pesquisa do Gmail

Variáveis de Saída

Variável	Tipo	Descrição
emails	Array	Lista de objetos de e-mail
emails[].id	String	ID do e-mail
emails[].subject	String	Assunto do e-mail
emails[].from	String	E-mail do remetente
emails[].snippet	String	Prévia do e-mail
emails[].date	String	Data recebida

Exemplo

Ação: Ler E-mails do Gmail
  Máx Resultados: 5
  Rótulo: "UNREAD"
  Consulta: "from:support@example.com"

---

📧 Obter E-mail do Gmail

Recupere um e-mail específico pelo seu ID com conteúdo completo.

Configuração

Campo	Tipo	Obrigatório	Descrição
ID do E-mail	String	✅	O ID da mensagem do Gmail

Variáveis de Saída

Variável	Tipo	Descrição
email	Object	Objeto completo do e-mail
email.id	String	ID do e-mail
email.threadId	String	ID da thread
email.subject	String	Assunto do e-mail
email.from	String	Remetente
email.to	String	Destinatários
email.body	String	Corpo completo do e-mail
email.date	String	Data recebida
email.attachments	Array	Lista de anexos

---

↩️ Responder E-mail do Gmail

Responda a um e-mail existente, mantendo o contexto da thread.

Configuração

Campo	Tipo	Obrigatório	Descrição
ID da Thread	String	✅	A thread para a qual responder
ID da Mensagem	String	✅	A mensagem específica para responder
Corpo	String	✅	Conteúdo da resposta
Responder a Todos	Boolean	❌	Responder a todos os destinatários (padrão: falso)

Variáveis de Saída

Variável	Tipo	Descrição
messageId	String	ID da resposta
threadId	String	ID da thread

Exemplo

Ação: Responder E-mail do Gmail
  ID da Thread: "{{email.threadId}}"
  ID da Mensagem: "{{email.id}}"
  Corpo: |
    {{ai_response}}
    
    ---
    Esta é uma resposta assistida por IA.

---

🔍 Pesquisar E-mails do Gmail

Pesquise seu Gmail usando a poderosa sintaxe de consulta do Gmail.

Configuração

Campo	Tipo	Obrigatório	Descrição
Consulta	String	✅	Consulta de pesquisa do Gmail
Máx Resultados	Número	❌	Máximo de resultados (padrão: 10)

Sintaxe de Consulta do Gmail

Consulta	Descrição
from:email@example.com	E-mails de remetente específico
to:email@example.com	E-mails para destinatário específico
subject:keyword	Assunto contém palavra-chave
is:unread	Somente e-mails não lidos
is:starred	E-mails destacados
has:attachment	E-mails com anexos
after:2025/01/01	E-mails após a data
before:2025/12/31	E-mails antes da data
label:important	E-mails com rótulo
"exact phrase"	Correspondência exata da frase

Exemplo

Ação: Pesquisar E-mails do Gmail
  Consulta: "from:{{customer_email}} is:unread subject:order"
  Máx Resultados: 5

---

✅ Marcar E-mail do Gmail como Lido

Marque um e-mail como lido no Gmail.

Configuração

Campo	Tipo	Obrigatório	Descrição
ID do E-mail	String	✅	O e-mail a ser marcado como lido

Exemplo

Ação: Marcar E-mail do Gmail como Lido
  ID do E-mail: "{{email.id}}"

---

📝 Criar Rascunho do Gmail

Crie um rascunho de e-mail para revisão humana antes de enviar.

Configuração

Campo	Tipo	Obrigatório	Descrição
Para	E-mail	✅	E-mail do destinatário
Assunto	String	✅	Assunto do e-mail
Corpo	String	✅	Conteúdo do e-mail
CC	E-mail	❌	Cópia carbono
BCC	E-mail	❌	Cópia carbono oculta
ID da Thread	String	❌	Para respostas de rascunho

Variáveis de Saída

Variável	Tipo	Descrição
draftId	String	ID do rascunho criado
messageId	String	ID da mensagem

Caso de Uso: Modo de Rascunho de IA

Gatilho: Rascunho de IA do Gmail
    ↓
Solicitação de IA:
  Prompt: "Gere uma resposta profissional para este e-mail"
  Input: "{{email.body}}"
    ↓
Criar Rascunho do Gmail:
  Para: "{{email.from}}"
  Assunto: "Re: {{email.subject}}"
  Corpo: "{{ai_response}}"

---

📋 Listar Rascunhos do Gmail

Recupere todos os rascunhos da sua conta do Gmail.

Configuração

Campo	Tipo	Obrigatório	Descrição
Máx Resultados	Número	❌	Máximo de rascunhos a listar

Variáveis de Saída

Variável	Tipo	Descrição
drafts	Array	Lista de objetos de rascunho
drafts[].id	String	ID do rascunho
drafts[].message	Object	Prévia da mensagem do rascunho

---

📨 Enviar Rascunho do Gmail

Envie um rascunho existente da sua conta do Gmail.

Configuração

Campo	Tipo	Obrigatório	Descrição
ID do Rascunho	String	✅	O rascunho a ser enviado

Variáveis de Saída

Variável	Tipo	Descrição
messageId	String	ID da mensagem enviada
threadId	String	ID do thread

---

🗑️ Excluir Rascunho do Gmail

Exclua um rascunho da sua conta do Gmail.

Configuração

Campo	Tipo	Obrigatório	Descrição
ID do Rascunho	String	✅	O rascunho a ser excluído

---

📂 Obter Thread de Email

Recupere um thread completo de conversação de email.

Configuração

Campo	Tipo	Obrigatório	Descrição
ID do Thread	String	✅	O thread a ser recuperado

Variáveis de Saída

Variável	Tipo	Descrição
thread	Object	Objeto completo do thread
thread.id	String	ID do thread
thread.messages	Array	Todas as mensagens no thread
thread.historyId	String	ID do histórico

Exemplo

Ação: Obter Thread de Email
  ID do Thread: "{{email.threadId}}"

---

Exemplos de Fluxo de Trabalho Completo

Exemplo 1: Assistente de Email AI

Processar automaticamente emails recebidos e criar respostas em rascunho geradas por AI.

Gmail AI Draft (Gatilho)
    ↓
Obter Thread de Email (Obter contexto completo)
    ↓
Solicitação AI
  - Sistema: "Você é um assistente de email útil"
  - Entrada: "{{thread.messages}}"
  - Saída: Estruturada (resposta, sentimento, urgência)
    ↓
Se Condição: urgência == "alta"
    ├── Sim: Enviar Email do Gmail (resposta imediata)
    └── Não: Criar Rascunho do Gmail (para revisão)

Exemplo 2: Pesquisa e Processamento de Email

Pesquise emails específicos e processe-os em massa.

Fluxo de Trabalho Agendado (Diariamente às 9 AM)
    ↓
Pesquisar Emails do Gmail
  Consulta: "is:unread from:customers@* after:yesterday"
    ↓
Para Cada: email em emails
    ↓
Solicitação AI (Categorizar email)
    ↓
Se Condição: categoria == "suporte"
    └── Criar Problema no JIRA

Exemplo 3: Fluxo de Trabalho de Revisão de Rascunho

Crie rascunhos, deixe humanos revisarem e, em seguida, envie.

Gmail AI Draft (Gatilho)
    ↓
Solicitação AI (Gerar resposta)
    ↓
Criar Rascunho do Gmail
    ↓
Enviar Mensagem no Slack
  "Novo rascunho pronto para revisão de {{email.from}}"

---

Melhores Práticas

1. Use o Modo de Rascunho para Emails Críticos

Para emails voltados para o cliente ou sensíveis, sempre use Criar Rascunho do Gmail em vez de Enviar Email do Gmail. Isso permite a revisão humana antes do envio.

2. Aproveite o Contexto do Thread

Use Obter Thread de Email antes de responder para garantir que sua AI tenha o contexto completo da conversa.

3. Implemente Limitação de Taxa

O Gmail possui cotas de API. Para fluxos de trabalho de alto volume:

• Adicione atrasos entre ações
• Agrupe operações quando possível
• Monitore o uso da sua cota

4. Use Consultas de Pesquisa Inteligentes

Combine operadores de consulta do Gmail para filtragem precisa:

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

5. Trate Erros de Forma Elegante

Use nós de Se Condição para verificar erros e implementar lógica de fallback.

---

Documentação Relacionada

• Configuração do Canal Gmail
• Ação Enviar Email (SMTP Genérico)
• Ação Solicitação AI
• Se Condição
• Introdução ao SmartFlow