Exercício 03 · Encontro 01 · 35 minutos
A resposta que chega por e-mail
O que você vai aprender
Você vai voltar ao fluxo do protocolo e acrescentar um nó que manda um e-mail ao cidadão, pela sua conta Google, com o número do protocolo e um texto seu. No caminho, cria a primeira credencial. Você sai com a automação completa: recebe, registra, confirma e avisa.
Como começar
- Onde
- O fluxo Protocolo Vale Verde, aberto na aba Editor.
- Conversa
- O chat da reunião, para os sinais.
- Pasta
- O kit na Área de Trabalho, para o plano B.
- Vem de
- Exercício 1: o fluxo publicado.
- Leva para
- Exercício 4: guardar tudo. No Encontro 2, o fluxo classifica pedidos da tabela.
Baixe antes de começar
- Baixar
- Fluxo pronto: Protocolo com e-mail (JSON)Fluxo (JSON)Baixar
Plano B. Depois de importar, escolha a tabela protocolos e a sua credencial do Gmail.
Situação
A confirmação na tela some quando o cidadão fecha a aba. O que fica é o e-mail: com o número, o tipo e a data, no tom da repartição. É a primeira vez que o fluxo fala com alguém fora do n8n, e para isso precisa de uma permissão guardada com segurança.
Credencial é permissão guardada. O fluxo usa; ninguém escreve a senha.
Tenha o Gmail da conta Google da Impacta aberto em outra aba do mesmo Chrome: é nela que você vai entrar, e é nela que o e-mail de teste vai chegar.
Passo a passo
5 passos · 35 minO que este exercício monta, caixinha por caixinha
- Formulário
- Número de protocolo
- Data table
- Gmail: o e-mail (novo)
- n8n Form: a confirmação
O nó do e-mail
Caixinha 4 de 5: Gmail: o e-mail (novo)5 minutos. O e-mail entra no meio do fluxo do protocolo, entre a tabela e a confirmação.
Por que este passo: A confirmação na tela some quando o cidadão fecha a aba; o e-mail fica. Este nó entra no meio do fluxo, entre gravar e responder, porque a resposta na tela deve continuar sendo a última coisa.
- Abra o fluxo Protocolo Vale Verde (Overview, aba Workflows, clique no nome).
- Passe o mouse na seta entre o Insert row (a tabela) e o Form (a confirmação) e clique no + que aparece no meio dela: o nó novo entra entre os dois.
- Na busca, digite gmail e clique em Gmail. Na lista de ações, clique em Send a message (enviar uma mensagem).
Deve aparecer: Cinco caixinhas: o Gmail entra no desenho com o nome Send a message, entre o Insert row e o Form. Sinal no chat: GMAIL.
O que acabou de acontecer: Inserir um nó no meio de uma seta é como acrescentar uma estação na linha de montagem: as outras não mudam.
A credencial: entrar com o Google
Caixinha 4 de 5: Gmail: o e-mail (novo)8 minutos. A primeira credencial: a permissão para o fluxo mandar e-mail pela sua conta Google.
Por que este passo: Para mandar e-mail pela sua conta, o fluxo precisa de permissão. Credencial é essa permissão guardada com segurança: você entra uma vez, o n8n guarda a chave, e ela nunca aparece em campo nenhum.
- No alto do painel do Gmail, no campo Credential (credencial), clique direto em Sign in with Google (entrar com o Google). Ignore o link or setup manually, ao lado.
- Na janela que abre, escolha a conta Google da Impacta, clique em Continuar e permita o acesso ao Gmail.
- A janela fecha sozinha, aparecem os avisos Credential created successfully e Account connected successfully, e o campo Credential mostra Gmail account, com um lápis ao lado.
Deve aparecer: O campo Credential com Gmail account. Sinal no chat: CREDENCIAL.
- A janela do Google não abriu? Popup bloqueado: permita no ícone da barra de endereço e clique de novo.
- O Google recusou a conta? Escreva TRAVEI 3.2: o instrutor confere com a Impacta. Siga com o plano B do fim da página.
O que acabou de acontecer: A senha e o token da credencial ficam na conta do n8n. O JSON pode citar o nome ou o identificador da credencial, mas não permite usá-la em outra conta sem reconectar.
Para quem, assunto e mensagem
Caixinha 4 de 5: Gmail: o e-mail (novo)10 minutos. Para quem, assunto e mensagem: tudo em Expression, porque muda a cada pedido.
Por que este passo: To, Subject e Message em expressão porque mudam a cada pedido: o destinatário é o e-mail que o cidadão digitou, o assunto tem o número, a mensagem tem o nome. O texto entre os campos é seu.
- Em To (para), passe o mouse sobre o campo, clique em Expression e cole o texto abaixo. (Se a coluna INPUT mostrar os campos, arrastar email dá o mesmo resultado; ao reabrir o fluxo ela costuma vir vazia.)To (Expression) · copiar
{{ $json.email }} - Em Subject (assunto), passe o mouse, clique em Expression e cole:Subject (Expression) · copiar
Protocolo {{ $json.protocolo }} aberto - Em Email Type (tipo), que vem em HTML, troque para Text (texto simples).
- Em Message (mensagem), passe o mouse, clique em Expression e cole o esqueleto abaixo. Depois, substitua o trecho em colchetes por duas linhas suas, do jeito que a sua repartição escreveria.Message (Expression): esqueleto para você preencher · copiar
Olá, {{ $json.nome }}. [ESCREVA AQUI, COM AS SUAS PALAVRAS, DUAS LINHAS DIZENDO QUE O PEDIDO FOI RECEBIDO E O QUE ACONTECE AGORA] Número do protocolo: {{ $json.protocolo }} Tipo do pedido: {{ $json.tipo }} Aberto em: {{ $json.criado_em }} Secretaria da Fazenda de Vale Verde Esta mensagem foi enviada automaticamente. Não responda a este e-mail.
- Em Options (opções), clique em Add option (adicionar opção) e em Append n8n Attribution (assinatura do n8n). Desligue a chave que aparece.
- Feche o painel no X, no canto superior direito (ou tecle Esc).
Deve aparecer: O nó sem ponto vermelho. Sinal no chat: MENSAGEM e a sua primeira linha do e-mail.
O que acabou de acontecer: É o mesmo pacote de dados do formulário chegando ao quarto nó. Tudo o que o formulário recebeu está disponível aqui como {{ $json.campo }}.
- Em To (para), passe o mouse sobre o campo, clique em Expression e cole o texto abaixo. (Se a coluna INPUT mostrar os campos, arrastar email dá o mesmo resultado; ao reabrir o fluxo ela costuma vir vazia.)
Testar com o seu e-mail
7 minutos. O teste: o e-mail vai para você.
Por que este passo: Você mesmo é o cidadão deste teste, com o seu e-mail, para ver o resultado chegar.
- Clique em Execute workflow. O formulário abre.
- Preencha com um nome inventado, mas no campo E-mail use o e-mail da conta Google da Impacta (o seu). Escolha um tipo, escreva uma descrição e envie.
- Volte ao n8n: cinco caixinhas verdes. Na aba do formulário, a tela de confirmação mostra o número do protocolo.
- Abra a aba do Gmail: o e-mail chegou, com o protocolo, o tipo e a data. Confira também que a tela de confirmação mostra o mesmo número, sem undefined.
Deve aparecer: O e-mail na sua caixa de entrada, com o assunto Protocolo VV-... aberto. Sinal no chat: CHEGOU.
- O Gmail deu erro de destinatário? O campo To está em Fixed com o texto {{ $json.email }}: mude para Expression.
O que acabou de acontecer: Cinco caixinhas verdes e um e-mail na caixa de entrada: o fluxo agora fala com alguém fora do n8n.
Publicar de novo
5 minutos. A segunda versão publicada.
Por que este passo: A versão publicada de manhã não tem o e-mail. Publicar de novo é trocar a versão que está no ar; o histórico guarda a anterior.
- Clique em Publish. Na caixa Publish workflow, apague o conteúdo de Version name e cole:Version name · copiar
com e-mail - Clique em Publish na janela. Se a caixa Production Checklist aparecer de novo, feche no X. A partir de agora, todo pedido pelo endereço de produção recebe o e-mail.
- Clique na setinha ao lado do botão Published e em View timeline (ver a linha do tempo). O painel abre na aba Publish Timeline: aparecem as duas versões publicadas, a primeira e esta, com a atual no alto.
Deve aparecer: Duas versões no histórico; a atual é com e-mail. Sinal no chat: PUBLICADO 2.
O que acabou de acontecer: Cada Publish é uma versão com nome. Se algo der errado, o histórico é o seu ponto de retorno.
- Clique em Publish. Na caixa Publish workflow, apague o conteúdo de Version name e cole:
O que você deve ver
- O fluxo com cinco caixinhas: formulário, protocolo, tabela, e-mail, confirmação.
- A credencial do Gmail criada, com a conta da Impacta.
- O e-mail de confirmação na sua caixa de entrada, com o seu texto.
- Duas versões publicadas no histórico.
Checagem obrigatória
- O campo To é a expressão {{ $json.email }}, não um endereço fixo.
- O e-mail chegou com o número do protocolo e o tipo do pedido. A tela de confirmação mostrou esse mesmo número.
- O texto do e-mail é seu, não o do esqueleto.
- Nenhuma senha foi digitada em campo de nó.
Se travarabrir
- O Google não deixa entrar com a conta da Impacta (tela de acesso bloqueado).
- É política da conta, não erro seu. Escreva TRAVEI 3.2. Plano B: a confirmação na tela já é a resposta ao cidadão; o instrutor mostra o e-mail chegando na tela dele, e o Exercício 3 fica registrado como demonstração. Nada do resto do dia depende dele.
- O e-mail não chegou.
- Confira a caixa de spam. Se o nó ficou verde, o Gmail enviou; se ficou vermelho, abra o nó e leia a mensagem de erro em OUTPUT e confira destinatário e credencial.
- A confirmação mostrou undefined em vez do protocolo.
- O Gmail devolve dados do envio, e o protocolo não está mais no item atual. Em Completion Message, use {{ $('Número de protocolo').first().json.protocolo }} e confira o nome exato do nó criado no passo 7 do Exercício 1.
- O nó entrou no fim, depois da confirmação, e não no meio.
- Arraste a caixinha do Gmail para o lugar; as setas acompanham. Ou apague e clique no + da seta certa.
- Cinco minutos travado.
- Plano B: Create workflow; no menu de três pontos ao lado do nome do fluxo, Import e From file com 05-protocolo-com-email.json; escolha a tabela protocolos no Data Table e a sua credencial no Gmail; Execute workflow. O arquivo importado ganha o nome do fluxo que está dentro dele: para não ficar com dois de mesmo nome, arquive antes o seu fluxo travado (menu de três pontos, Archive).
Se você terminou antesabrir
Não avance para o próximo passo. Faça um destes testes na resposta que já tem:
- Mude Email Type para HTML e coloque o número do protocolo em negrito: <b>{{ $json.protocolo }}</b>.
- Adicione um aviso interno depois do Gmail. No assunto, use Novo pedido de {{ $('Número de protocolo').first().json.nome }}, pois o Gmail muda o item que segue para a próxima caixinha.
Leve para o seu trabalho
- Sign in with Google cria a credencial
- To, Subject e Message em Expression
- O texto do e-mail é do órgão, não do n8n
- Cada Publish é uma versão
- Senha nunca vai em campo
Registre o método
Complete na folha ou num bloco de notas. É o que fica quando a aula acaba.
- A primeira linha do meu e-mail:
- Onde a credencial fica guardada e o que não vai no JSON:
- Quantas versões o fluxo tem agora: