E-mail

O envio automático de e-mails em diferentes situações é a principal função dessas macros. Outras tarefas são desempenhadas, mas esta é a mais importante delas. Para o envio de e-mails, deve ser usada exclusivamente a conta manutencaoscne@gmail.com.

Tipos

Atualmente, são enviados os seguintes tipos de notificações via e-mail:

  • Arquivamento de processo, destinada a(o) solicitante;

  • Bloqueio de execução por aguardo de alguma definição ou interação do solicitante;

  • Compilação de processos não estruturais arquivados durante a semana passada à CGD, enviada todo dia;

  • Compilação de processos estruturais enviados aos colaboradores relevantes, caso tenha;

  • Alteração de layout à CPLAN;

  • Resposta automatizada para feedback. Um tipo para nota baixa e outro para serviço julgado como não concluído pelo(a) solicitante;

  • Insumos atrasados atrapalhando execução, enviada ao fiscal de contrato;

  • (EM DESENVOLVIMENTO) Remoção de colaborador com status “DESLIGADO” na página de “Equipe” por mais de 30 dias (padrão, configurável no painel de controle);

Última atualização: 07 nov. 2025

Templates

O envio de e-mails é feito usando HTML com templates. Mensagens com corpo de texto puro não são suportadas pelo projeto, já que implementar um parser próprio de HTML não é viável de um ponto de vista de esforço e de performance. O formato das templates é próprio ao Google Apps Script, exemplos podem ser encontrados em src/templates/. O arquivo mail.ts contém vários wrappers para GmailApp.SendMail que avaliam essas templates, preenchendo dados para cada um dos tipos de notificação especificados.

A sintaxe de templates do Apps Script permite <? ... ?> para lógica e <?= ... ?> para saída.

Exemplo de arquivo de template, que seria colocado em src/templates/

<!-- src/templates/notification.html -->
<p>Olá <?= nome ?>,</p>

<p>Seguem os processos:</p>
<ul>
<? for (var i = 0; i < processos.length; i++) { ?>
    <li><?= processos[i].numero ?> — <?= processos[i].assunto ?></li>
<? } ?>
</ul>

<p>Atenciosamente,<br>Equipe</p>

Exemplo de código no Google Apps Script que avalia a template e envia um e-mail:

function sendNotification(to, nome, processos) {
    // Carrega a template pelo nome do arquivo (sem extensão)
    var template = HtmlService.createTemplateFromFile('notification');
    template.nome = nome;
    template.processos = processos;

    // Avalia a template e obtém o HTML final
    var htmlBody = template.evaluate().getContent();

    // Envia usando a conta dedicada
    GmailApp.sendEmail(
        to,
        'Notificação de processos',
        'Seu cliente de e-mail não suporta HTML.',
        {
            htmlBody: htmlBody,
            from: 'manutencaoscne@gmail.com'
        }
    );
}

Verificação Manual

Os envios de e-mail são programados para fazer logging extenso e deixar o processo transparente. É possível observar suas execuções nos logs do Google Apps Script. A função alto-nível responsável por ativar todas as notificações é enviarNotificacoes() em main.ts