Todos os templates Pela equipe NappAI Enviar e-mails frios
Este fluxo automatiza o envio massivo e personalizado de promoções. Primeiro, unifica as informações de um produto (entrada manual) com um banco de dados de contatos do Google Sheets. Posteriormente, inicia um loop de processamento onde, para cada
graph TD
%%{init: {'theme': 'mc','layout': 'elk'}}%%
GSheetCellComponent-1ujen[Sheet Cells ]
style GSheetCellComponent-1ujen stroke:#a170ff
GoogleGenerativeAIModel-30xv3[Gemini]
style GoogleGenerativeAIModel-30xv3 stroke:#a170ff
GmailMesageComponent-0c0un[<div><img alt="logo" src="/_astro/gmail.CLxyIGOu.svg" style="height: 20px !important;width: 20px !important"/></div>Gmail Message]
style GmailMesageComponent-0c0un stroke:#a170ff
Prompt-dufy4[<div><img alt="logo" src="/_astro/square-terminal.BMOXc-nZ.svg" style="height: 20px !important;width: 20px !important"/></div>Prompt]
style Prompt-dufy4 stroke:#a170ff
Loop-x4kgp[Loop]
style Loop-x4kgp stroke:#a170ff
CreateData-lk556[Create Data]
style CreateData-lk556 stroke:#a170ff
Switch-4pxix[Switch]
style Switch-4pxix stroke:#a170ff
GSheetCellComponent-lry71[Sheet Cells 2]
style GSheetCellComponent-lry71 stroke:#a170ff
TextInput-qh2y0[<div><img alt="logo" src="/_astro/type.Dy26vmDy.svg" style="height: 20px !important;width: 20px !important"/></div>Text Input]
style TextInput-qh2y0 stroke:#a170ff
GoogleGenerativeAIModel-z1mmi[Gemini2]
style GoogleGenerativeAIModel-z1mmi stroke:#a170ff
Prompt-eyrkb[<div><img alt="logo" src="/_astro/square-terminal.BMOXc-nZ.svg" style="height: 20px !important;width: 20px !important"/></div>Prompt2]
style Prompt-eyrkb stroke:#a170ff
ParseData-z3lo1[<div><img alt="logo" src="/_astro/braces.Djq0PW4_.svg" style="height: 20px !important;width: 20px !important"/></div>dirección]
style ParseData-z3lo1 stroke:#a170ff
ParseData-sg4v4[<div><img alt="logo" src="/_astro/braces.Djq0PW4_.svg" style="height: 20px !important;width: 20px !important"/></div>Fin]
style ParseData-sg4v4 stroke:#a170ff
ParseData-e32rl[<div><img alt="logo" src="/_astro/braces.Djq0PW4_.svg" style="height: 20px !important;width: 20px !important"/></div>dirección2]
style ParseData-e32rl stroke:#a170ff
LoopEnd-96ajm[Loop End]
style LoopEnd-96ajm stroke:#a170ff
CreateData-lk556 -.- Loop-x4kgp
linkStyle 0 stroke:#a170ff
GSheetCellComponent-1ujen -.- Switch-4pxix
linkStyle 1 stroke:#a170ff
Switch-4pxix -.- GSheetCellComponent-lry71
linkStyle 2 stroke:#a170ff
GSheetCellComponent-lry71 -.- CreateData-lk556
linkStyle 3 stroke:#a170ff
TextInput-qh2y0 -.- CreateData-lk556
linkStyle 4 stroke:#a170ff
Loop-x4kgp -.- ParseData-z3lo1
linkStyle 5 stroke:#a170ff
Loop-x4kgp -.- ParseData-sg4v4
linkStyle 6 stroke:#a170ff
GoogleGenerativeAIModel-30xv3 -.- Prompt-eyrkb
linkStyle 7 stroke:#a170ff
Prompt-eyrkb -.- GoogleGenerativeAIModel-z1mmi
linkStyle 8 stroke:#a170ff
GoogleGenerativeAIModel-30xv3 -.- GmailMesageComponent-0c0un
linkStyle 9 stroke:#a170ff
GoogleGenerativeAIModel-z1mmi -.- GmailMesageComponent-0c0un
linkStyle 10 stroke:#a170ff
ParseData-z3lo1 -.- GmailMesageComponent-0c0un
linkStyle 11 stroke:#a170ff
Loop-x4kgp -.- ParseData-e32rl
linkStyle 12 stroke:#a170ff
ParseData-e32rl -.- Prompt-dufy4
linkStyle 13 stroke:#a170ff
Prompt-dufy4 -.- GoogleGenerativeAIModel-30xv3
linkStyle 14 stroke:#a170ff
GmailMesageComponent-0c0un -.- LoopEnd-96ajm
linkStyle 15 stroke:#a170ff
LoopEnd-96ajm -.- Loop-x4kgp
linkStyle 16 stroke:#a170ff
📁 Documentação do Fluxo “Enviar e‑mails frios”
🧩 Descrição Geral
O fluxo automatiza a criação e envio de e‑mails promocionais em massa. Ele extrai contatos de um Google Sheets, gera textos (assunto e corpo) com Gemini, envia os e‑mails via Gmail e atualiza o status dos contatos no documento. Tudo ocorre em um laço que garante o processamento sequencial de cada registro.
⚙️ Funcionalidades Principais
- Leitura automática de contatos em Google Sheets.
- Filtragem de contatos não enviados por meio de um roteador.
- Atualização do status “enviado” no mesmo documento.
- Geração dinâmica de corpo e assunto de e‑mail usando Gemini.
- Envio automático de e‑mails com destinatário, assunto e corpo.
- Loop controlado que repete o processo para cada linha válida do sheet.
🔄 Passos do Fluxo de Trabalho
| Nome do Componente | Papel no Fluxo | Entradas Principais | Saídas Principais |
|---|---|---|---|
| Google Sheets (Leitura) | Extrai linhas de contatos | ID do arquivo, operação “Get Rows”, nome da planilha | Dados de contatos |
| Roteador (Switch) | Seleciona contatos não enviados | Dados de contatos, chave enviado |
Dados de contatos filtrados |
| Google Sheets (Atualização) | Marca contato como enviado | Dados de contatos filtrados, operação “Update Row” | Dados atualizados |
| Preparação de Dados (Create Data) | Combina dados de produto e contato | Texto do produto (Text Input), dados atualizados | Registro de dados (produto + e‑mail) |
| Loop | Itera sobre cada registro | Registro de dados | Item atual e controle de fim |
| Extração de Endereço (direção) | Converte campo de e‑mail para texto | Registro de dados | Texto do e‑mail |
| Geração do Corpo (Prompt) | Cria prompt para Gemini | Produto | Prompt de corpo |
| Gemini (Gemini) | Gera corpo do e‑mail | Prompt de corpo | Texto do corpo |
| Extração do Produto (direção2) | Converte campo de produto para texto | Registro de dados | Texto do produto |
| Geração do Assunto (Prompt2) | Cria prompt para Gemini | Texto do produto | Prompt de assunto |
| Gemini (Gemini2) | Gera assunto do e‑mail | Prompt de assunto | Texto do assunto |
| Envio de E‑mail (Gmail Message) | Envia e‑mail via Gmail | Destinatário (e‑mail), assunto, corpo, credenciais | Dados de envio (status) |
| Loop End | Finaliza iteração e reinicia se houver mais itens | Dados de envio | Item processado, loop continua |
Observação: Componentes de Label (LabelComponent) são usados apenas para exibir informações no editor e não participam do fluxo de dados principal.
🧠 Notas
Credenciais:
- Google Sheets e Gmail exigem credenciais OAuth configuradas no ambiente.
- Gemini requer chave de API do Google Cloud.
Limitações de tamanho:
- Gemini possui limite de tokens (4096).
- Gmail tem limite de envio diário; verifique a política da conta.
Dependências de ordem:
- A atualização do status deve ocorrer antes do envio para evitar re‑envio de e‑mails.
- O loop só avança se o componente Loop End receber a saída do Gmail Message.
Execução em lote:
- O fluxo está configurado em modo “Batch” (parâmetro
mapping_mode=true), permitindo processamento paralelo de até 5 itens simultâneos.
- O fluxo está configurado em modo “Batch” (parâmetro
Tratamento de erros:
- Se um e‑mail falhar, o fluxo continua para o próximo item; o status não é alterado e permanece “não enviado” para posterior re‑tentativa.
Logs:
- Todos os componentes geram logs de entrada e saída que podem ser visualizados no painel de execução.
Esta documentação oferece uma visão funcional clara do fluxo, permitindo ajustes e manutenção sem mergulhar em detalhes de implementação interna.