Automatizar o Google Sheets e o Gmail com Google Apps Script

Descreve as colunas com uma linha real (sem dados pessoais). Corre primeiro o script com DRY_RUN ativo, revê o registo e só depois desativa-o e cria o acionador.

Tarefa: lembrete por email 3 dias antes do vencimento de cada fatura · Folha: separador «Faturas» com cliente, email, valor em euros, data de vencimento, estado · Acionador: diário às 8h00 · Serviços: Gmail.

2. Código (Apps Script, V8)

const CONFIG = {
  SHEET_NAME: 'Inscrições',
  STATUS_COL: 5,            // A=nome, B=email, C=curso, D=data de início, E=estado
  SUBJECT: 'Bem-vindo ao teu curso',
  DRY_RUN: true,            // set to false once the test run looks right
};

function sendWelcomeEmails() {
  const lock = LockService.getScriptLock();
  if (!lock.tryLock(30 * 1000)) return;           // another run is in progress
  try {
    const sheet = SpreadsheetApp.getActive().getSheetByName(CONFIG.SHEET_NAME);
    const lastRow = sheet.getLastRow();
    if (lastRow < 2) return;
    const rows = sheet.getRange(2, 1, lastRow - 1, CONFIG.STATUS_COL).getValues();
    let sent = 0;
    const statuses = rows.map(([name, email, course, start, status], i) => {
      if (status) return [status];                // already processed: skip
      try {
        if (!/^[^@\s]+@[^@\s]+\.[^@\s]+$/.test(email)) throw new Error('invalid email');
        const date = Utilities.formatDate(new Date(start), Session.getScriptTimeZone(), 'dd/MM/yyyy');
        const body = `Olá ${name},\n\nbem-vindo ao curso «${course}». Começamos a ${date}.`;
        if (CONFIG.DRY_RUN) { console.log(`[DRY_RUN] would email ${email}`); return ['']; }
        GmailApp.sendEmail(email, CONFIG.SUBJECT, body);
        sent++;
        return ['ENVIADO ' + new Date().toISOString()];
      } catch (e) {
        console.log(`Row ${i + 2}: ${e.message}`);
        return ['ERRO: ' + e.message];
      }
    });
    sheet.getRange(2, CONFIG.STATUS_COL, statuses.length, 1).setValues(statuses); // one bulk write
    console.log(`Done: ${sent} sent out of ${rows.length} rows`);
  } finally {
    lock.releaseLock();
  }
}

function createTrigger() {
  ScriptApp.newTrigger('sendWelcomeEmails')
    .forSpreadsheet(SpreadsheetApp.getActive()).onFormSubmit().create();
}

A coluna de estado evita envios repetidos se o script correr duas vezes. O convite do Google Calendar entra no mesmo ciclo quando o calendário do curso estiver confirmado → [COMPLETAR]…