Google Apps Script: ИИ-нейросеть для скриптов Таблиц и Документов

/**
 * Отправляет письмо менеджеру при новой строке из формы.
 * Читает адрес менеджера из листа «Настройки», ячейка B1.
 * Обрабатывает лист «Заявки» и не повторяет отправку для уже отмеченных строк.
 */
function processFormSubmit(e) {
  // Проверяем, что событие пришло от отправки формы
  if (!e || !e.range) {
    throw new Error('Функция должна запускаться триггером отправки формы.');
  }

  const ss = SpreadsheetApp.getActiveSpreadsheet();

  // Листы из задачи — не переименовывать
  const заявкиSheet = ss.getSheetByName('Заявки');
  const настройкиSheet = ss.getSheetByName('Настройки');

  if (!заявкиSheet) {
    throw new Error('Не найден лист «Заявки».');
  }

  if (!настройкиSheet) {
    throw new Error('Не найден лист «Настройки».');
  }

  // Читаем e-mail менеджера из B1
  const managerEmail = String(настройкиSheet.getRange('B1').getValue()).trim();

  if (!managerEmail) {
    throw new Error('В ячейке B1 листа «Настройки» не указан e-mail менеджера.');
  }

  // Определяем строку, которую добавила форма
  const row = e.range.getRow();

  // Если это строка заголовков или выше — ничего не делаем
  if (row < 2) {
    return;
  }

  // Читаем всю строку целиком: A:E
  const rowValues = заявкиSheet.getRange(row, 1, 1, 5).getValues()[0];

  const timestamp = rowValues[0]; // A — отметка времени
  const clientName = rowValues[1]; // B — имя
  const phone = rowValues[2]; // C — телефон
  const comment = rowValues[3]; // D — комментарий
  const mailStatus = rowValues[4]; // E — статус письма

  // Защита от повторной обработки уже отправленных строк
  if (String(mailStatus).toLowerCase() === 'отправлено') {
    return;
  }

  // Формируем тему и текст письма
  const subject = 'Новая заявка из формы';

  const body =
    'Поступила новая заявка из формы.\n\n' +
    'Дата и время: ' + timestamp + '\n' +
    'Имя: ' + clientName + '\n' +
    'Телефон: ' + phone + '\n' +
    'Комментарий: ' + comment + '\n\n' +
    'Строка в таблице: ' + row;

  // Отправляем письмо менеджеру
  GmailApp.sendEmail(managerEmail, subject, body);

  // Отмечаем строку как обработанную
  заявкиSheet.getRange(row, 5).setValue('отправлено');
}

/**
 * Создаёт устанавливаемый триггер на отправку формы для текущей таблицы.
 * Запускать вручную один раз.
 */
function createFormSubmitTrigger() {
  const ss = SpreadsheetApp.getActiveSpreadsheet();

  // Удаляем старые триггеры с этой же функцией, чтобы не создавать дубли
  const triggers = ScriptApp.getProjectTriggers();

  for (let i = 0; i < triggers.length; i++) {
    const trigger = triggers[i];

    if (trigger.getHandlerFunction() === 'processFormSubmit') {
      ScriptApp.deleteTrigger(trigger);
    }
  }

  // Создаём триггер для таблицы
  ScriptApp.newTrigger('processFormSubmit')
    .forSpreadsheet(ss)
    .onFormSubmit()
    .create();
}

/**
 * Проверочная функция для первого запуска и выдачи доступов.
 * Запускать вручную один раз, затем можно удалить или оставить.
 */
function testPermissions() {
  const ss = SpreadsheetApp.getActiveSpreadsheet();

  // Просто читаем активную таблицу, чтобы запросить доступы
  const sheetName = ss.getName();

  Logger.log('Текущая таблица: ' + sheetName);
}

Как установить

1. Откройте нужную Google Таблицу.
2. Перейдите в «Расширения → Apps Script».
3. Вставьте код целиком в файл скрипта, заменив шаблонный код, если он есть.
4. Нажмите Сохранить.
5. Сначала запустите вручную функцию testPermissions или createFormSubmitTrigger:
   • выберите функцию в списке,
   • нажмите ▶ Запуск,
   • выдайте доступы.
6. Если появится предупреждение о непроверенном приложении, это значит, что скрипт ещё не прошёл проверку Google. Для личного использования обычно нужно нажать «Дополнительные настройки» → «Перейти к проекту (небезопасно)» и подтвердить доступ.
7. После этого вручную запустите функцию createFormSubmitTrigger — она создаст устанавливаемый триггер через ScriptApp.newTrigger(...).forSpreadsheet(...).onFormSubmit().
8. Также можно поставить триггер вручную через интерфейс:
   • «Триггеры»
   • «Добавить триггер»
   • функция: processFormSubmit
   • источник события: из таблицы
   • тип события: при отправке формы
9. Проверьте работу на копии таблицы перед использованием в бою.

Что важно учесть

• Простые триггеры здесь не подходят, поэтому используется именно устанавливаемый триггер.
• Письмо отправляется через GmailApp.sendEmail().
• Защита от повторной отправки сделана через столбец E: если там уже стоит «отправлено», строка пропускается.
• Скрипт читает и обрабатывает данные пакетно через getRange(...).getValues(). Отметка статуса в одной ячейке ставится после отправки письма.
• Не отправляйте массовые письма без теста: сначала проверьте на одной тестовой заявке.
• Если у вас большой поток заявок, учитывайте квоты Gmail и Apps Script.

Если нужно, я могу сразу адаптировать этот же скрипт под вариант, где статус письма записывается в отдельный столбец с датой отправки вместо слова «отправлено».

// Google Apps Script для Google Таблиц
// Задача: каждый день утром проверять сроки договоров и подсвечивать строки:
// меньше 14 дней — красным, меньше 30 дней — жёлтым.
// Лист: "Договоры", заголовки в строке 1, данные со 2 строки.

// Создаёт ежедневный триггер на 8–9 утра
function createDailyTrigger() {
  // Удаляем старые триггеры для этой функции, чтобы не плодить дубликаты
  const triggers = ScriptApp.getProjectTriggers();
  for (let i = 0; i < triggers.length; i++) {
    if (triggers[i].getHandlerFunction() === 'checkContractsDeadline') {
      ScriptApp.deleteTrigger(triggers[i]);
    }
  }

  // Создаём новый триггер: каждый день, примерно в 8–9 утра
  ScriptApp.newTrigger('checkContractsDeadline')
    .timeBased()
    .everyDays(1)
    .atHour(8) // запуск в часовой интервал 8–9
    .create();
}

// Проверяет даты окончания договоров и красит строки
function checkContractsDeadline() {
  const ss = SpreadsheetApp.getActiveSpreadsheet();
  const sheet = ss.getSheetByName('Договоры'); // имя листа из задачи

  if (!sheet) {
    throw new Error('Лист "Договоры" не найден.');
  }

  const lastRow = sheet.getLastRow();
  const lastColumn = 3; // A:C по структуре задачи

  // Если нет данных кроме заголовка — ничего не делаем
  if (lastRow < 2) {
    return;
  }

  const range = sheet.getRange(2, 1, lastRow - 1, lastColumn);
  const values = range.getValues();

  // Подготавливаем массив цветов для всей таблицы разом
  const backgrounds = [];

  const today = new Date();
  today.setHours(0, 0, 0, 0);

  for (let i = 0; i < values.length; i++) {
    const row = values[i];
    const endDateValue = row[2]; // C — дата окончания
    let color = null;

    if (endDateValue instanceof Date && !isNaN(endDateValue)) {
      const endDate = new Date(endDateValue);
      endDate.setHours(0, 0, 0, 0);

      const diffMs = endDate.getTime() - today.getTime();
      const diffDays = Math.ceil(diffMs / (1000 * 60 * 60 * 24));

      if (diffDays < 14) {
        color = '#f4cccc'; // красный
      } else if (diffDays < 30) {
        color = '#fff2cc'; // жёлтый
      }
    }

    // Красим всю строку A:C
    backgrounds.push([color, color, color]);
  }

  // Одним вызовом применяем форматирование ко всему диапазону
  range.setBackgrounds(backgrounds);
}

Как установить:

1. Откройте таблицу Google Sheets.
2. Меню: Расширения → Apps Script.
3. Вставьте код в файл Code.gs вместо шаблона.
4. Нажмите Сохранить.
5. Запустите вручную функцию createDailyTrigger:
   • выберите её в списке функций;
   • нажмите Выполнить.
6. При первом запуске появится запрос доступа:
   • выберите аккаунт;
   • нажмите Разрешить;
   • если увидите предупреждение о непроверенном приложении, это стандартное окно Google для скриптов без публикации. Нужно нажать Дополнительно → Перейти к [название проекта] → Разрешить.
7. После этого откройте слева раздел Триггеры → Добавить триггер:
   • функция: checkContractsDeadline;
   • источник события: По времени;
   • тип триггера: Таймер дня;
   • время: 8–9 утра.

Важно:

• Скрипт рассчитан на таблицу с листом «Договоры» и датой окончания в колонке C.
• Перед запуском проверьте на копии таблицы.
• Если данных много, помните про квоты Apps Script; здесь чтение и запись идут пакетно через getValues() и setBackgrounds(), без обработки по ячейке.
• Не добавляйте массовую рассылку писем без теста.

Если нужен вариант, который ещё и пишет статус в отдельный столбец или отправляет уведомление на почту, я добавлю это в том же стиле.

// Google Apps Script для Google Таблиц
// Сценарий: при ручном изменении на листе "Задачи"
// Если в столбце F поставить "Готово" — записать текущую дату в G
// Если статус в F очистили — очистить дату в G
// Скрипт реагирует только на нужный лист и только на изменения в столбце F

function handleTaskStatusEdit(e) {
  // Проверяем, что событие вообще пришло
  if (!e || !e.range) return;

  // Получаем лист, где было изменение
  const sheet = e.range.getSheet();

  // Срабатываем только на листе "Задачи"
  if (sheet.getName() !== 'Задачи') return;

  // Столбец F = 6
  const editedColumn = e.range.getColumn();

  // Нас интересует только столбец F
  if (editedColumn !== 6) return;

  // Не обрабатываем множественную вставку диапазона, только одиночную ячейку
  if (e.range.getNumRows() !== 1 || e.range.getNumColumns() !== 1) return;

  // Берём новое значение из события
  const newValue = e.value;

  // Номер строки, где произошла правка
  const row = e.range.getRow();

  // Диапазон для даты готовности в столбце G = 7
  const dateCell = sheet.getRange(row, 7);

  // Если статус стал "Готово", ставим текущую дату
  if (newValue === 'Готово') {
    dateCell.setValue(new Date());
    return;
  }

  // Если статус очистили, очищаем дату
  if (newValue === undefined || newValue === '') {
    dateCell.clearContent();
    return;
  }
}

Как установить

1. Откройте Google Таблицу.
2. Перейдите в Расширения → Apps Script.
3. Вставьте код в файл Code.gs.
4. Нажмите Сохранить.
5. В редакторе Apps Script откройте Триггеры.
6. Нажмите Добавить триггер.
7. Выберите функцию handleTaskStatusEdit.
8. Источник события: Из таблицы.
9. Тип события: При изменении.
   Если нужен именно e.range для реакции на правку ячеек, в Apps Script обычно используют устанавливаемый триггер при редактировании. Для него выберите тип события При редактировании.
10. Сохраните триггер и выдайте доступы при первом запуске.

Почему здесь нужен устанавливаемый триггер

• Для обычного onEdit(e) не требуется ручная установка, но он имеет ограничения.
• Если в будущем потребуется доступ к почте, другим файлам или внешним сервисам, простой триггер не сможет это делать без авторизации.
• Устанавливаемый триггер запускается с правами пользователя и подходит для более сложных действий.
• Также у простого триггера есть ограничение по времени выполнения: около 30 секунд.

Что означает предупреждение о непроверенном приложении

Если при первом запуске появится окно с предупреждением о непроверенном приложении:

• это стандартное уведомление Google,
• оно появляется, когда скрипт ещё не прошёл проверку Google,
• нужно нажать Дополнительные сведения → Перейти к [название проекта],
• затем подтвердить доступы.

Важные замечания

• Скрипт настроен только на лист «Задачи».
• Он реагирует только на изменения в столбце F.
• Если в одной ячейке F поставить «Готово», в G проставится текущая дата.
• Если значение в F очистить, дата в G очистится.
• Проверяйте скрипт на копии таблицы перед работой в боевом файле.

Если нужно, я могу сразу сделать версию именно для простого триггера onEdit(e) без установки триггера.

/**
 * Google Apps Script для Gmail
 * Задача: раз в час находить письма с ярлыком «Счета»,
 * сохранять вложения PDF в папку на Google Диске «Счета 2026»
 * и снимать ярлык с уже обработанных писем.
 *
 * Важно:
 * - Используются только существующие сервисы Apps Script: GmailApp, DriveApp, ScriptApp.
 * - Нужны права доступа к Gmail и Google Диску.
 * - Перед запуском проверьте на копии данных.
 */

/**
 * Создаёт часовой триггер вручную из кода.
 * Запускать один раз вручную.
 */
function createHourlyTrigger() {
  // Удаляем старые триггеры этой же функции, чтобы не было дублей.
  const triggers = ScriptApp.getProjectTriggers();

  // Перебираем все триггеры проекта.
  for (let i = 0; i < triggers.length; i++) {
    // Если триггер уже на нужную функцию, удаляем его.
    if (triggers[i].getHandlerFunction() === 'processInvoicesByLabel') {
      ScriptApp.deleteTrigger(triggers[i]);
    }
  }

  // Создаём новый триггер: каждый час.
  ScriptApp.newTrigger('processInvoicesByLabel')
    .timeBased()
    .everyHours(1)
    .create();
}

/**
 * Основная функция обработки писем.
 * Ищет письма с ярлыком «Счета», сохраняет PDF-вложения
 * в папку «Счета 2026» и снимает ярлык после успешной обработки.
 */
function processInvoicesByLabel() {
  // Название ярлыка из задачи.
  const labelName = 'Счета';

  // Название папки из задачи.
  const folderName = 'Счета 2026';

  // Получаем ярлык Gmail.
  const label = GmailApp.getUserLabelByName(labelName);

  // Если ярлык не найден, прекращаем выполнение.
  if (!label) {
    throw new Error('Не найден ярлык Gmail: ' + labelName);
  }

  // Получаем письма с этим ярлыком.
  const threads = GmailApp.search('label:' + labelName);

  // Находим или создаём папку на Диске.
  let folder = getOrCreateFolderByName_(folderName);

  // Обрабатываем все найденные цепочки писем.
  for (let i = 0; i < threads.length; i++) {
    // Берём все сообщения в цепочке.
    const messages = threads[i].getMessages();

    // Флаг успешной обработки всей цепочки.
    let threadProcessed = false;

    // Обрабатываем сообщения внутри цепочки.
    for (let j = 0; j < messages.length; j++) {
      // Получаем вложения письма.
      const attachments = messages[j].getAttachments();

      // Флаг: есть ли PDF во вложениях.
      let hasPdf = false;

      // Проверяем все вложения.
      for (let k = 0; k < attachments.length; k++) {
        // Проверяем MIME-тип PDF.
        if (attachments[k].getContentType() === 'application/pdf') {
          hasPdf = true;

          // Формируем имя файла.
          const fileName = makeSafeFileName_(
            messages[j].getDate(),
            attachments[k].getName(),
            threads[i].getId()
          );

          // Сохраняем PDF в папку Google Диска.
          folder.createFile(attachments[k].copyBlob().setName(fileName));

          // Помечаем цепочку как обработанную.
          threadProcessed = true;
        }
      }

      // Если у письма не было PDF, ничего не делаем.
      if (!hasPdf) {
        continue;
      }
    }

    // Если хотя бы одно PDF сохранено, снимаем ярлык.
    if (threadProcessed) {
      threads[i].removeLabel(label);
    }
  }
}

/**
 * Возвращает существующую папку по имени или создаёт новую.
 * @param {string} folderName Имя папки.
 * @returns {GoogleAppsScript.Drive.Folder} Папка Google Диска.
 */
function getOrCreateFolderByName_(folderName) {
  // Ищем папку по имени.
  const folders = DriveApp.getFoldersByName(folderName);

  // Если папка уже есть, возвращаем первую найденную.
  if (folders.hasNext()) {
    return folders.next();
  }

  // Иначе создаём новую папку.
  return DriveApp.createFolder(folderName);
}

/**
 * Делает безопасное имя файла.
 * @param {Date} date Дата письма.
 * @param {string} originalName Оригинальное имя вложения.
 * @param {string} threadId ID цепочки письма.
 * @returns {string} Безопасное имя файла.
 */
function makeSafeFileName_(date, originalName, threadId) {
  // Форматируем дату вручную.
  const yyyy = date.getFullYear();
  const mm = String(date.getMonth() + 1).padStart(2, '0');
  const dd = String(date.getDate()).padStart(2, '0');
  const hh = String(date.getHours()).padStart(2, '0');
  const min = String(date.getMinutes()).padStart(2, '0');

  // Берём исходное имя или задаём запасное.
  const baseName = originalName ? originalName : 'invoice.pdf';

  // Очищаем имя от недопустимых символов.
  const cleaned = baseName.replace(/[\\\/:*?"<>|]/g, '_');

  // Возвращаем итоговое имя файла.
  return yyyy + '-' + mm + '-' + dd + '_' + hh + '-' + min + '_' + threadId + '_' + cleaned;
}

/**
 * Разовая ручная установка триггера через интерфейс:
 * «Триггеры» → «Добавить триггер».
 *
 * В интерфейсе нужно выбрать:
 * - Функция: processInvoicesByLabel
 * - Источник события: По времени
 * - Тип триггера: Таймер часов
 * - Интервал: Каждый час
 *
 * Эту функцию запускать не нужно, она дана как инструкция в коде.
 */
function triggerSetupGuide() {
  // Пустая служебная функция.
  // Нужна только как напоминание, что триггер можно создать вручную через интерфейс.
}

Как установить

1. Откройте нужный Google-аккаунт и перейдите в таблицу/документ с проектом.
2. Нажмите «Расширения → Apps Script».
3. В редакторе удалите шаблонный код и вставьте скрипт целиком.
4. Нажмите Сохранить.
5. Запустите вручную функцию createHourlyTrigger().
6. При первом запуске Google попросит доступы:
   • к Gmail — чтобы читать письма и снимать ярлык;
   • к Google Диску — чтобы создавать папку и сохранять файлы.
7. Если появится предупреждение «Это приложение не проверено», это означает, что скрипт ещё не проходил проверку Google. Для собственного проекта обычно можно открыть «Дополнительно» → «Перейти к проекту» и подтвердить доступ.
8. После этого в редакторе можно также поставить триггер вручную: «Триггеры» → «Добавить триггер».
   • Функция: processInvoicesByLabel
   • Источник события: По времени
   • Тип: Каждый час

Что делает защита от повторного выполнения

• Скрипт ищет письма с ярлыком «Счета».
• После успешного сохранения PDF из цепочки он снимает ярлык.
• Поэтому при следующем часовом запуске уже обработанные письма не попадут в обработку повторно.

Важно

• Проверьте скрипт на копии почты и Диска перед рабочим запуском.
• Не запускайте массовую обработку без теста.
• Если в письме несколько PDF, все они будут сохранены.
• Если ярлык есть, но PDF-вложений нет, ярлык не снимется.

Если хотите, я могу сразу сделать версию с журналом обработанных писем в отдельном листе или с поиском только непрочитанных писем.

Причина простая: GmailApp.sendEmail() нельзя вызывать из простого триггера onEdit(e).
Простой триггер работает с ограниченными правами, поэтому отправка письма блокируется. Для GmailApp нужен устанавливаемый триггер.

Еще момент: в вашем коде функция называется onEdit, а для устанавливаемого триггера лучше использовать другое имя, как вы и просили.

Исправленный код целиком:

function handleEditSendEmail(e) {
  // Обрабатывает изменение статуса в столбце F на листе «Заявки»
  const sheet = e.range.getSheet();
  const editedColumn = e.range.getColumn();
  const editedRow = e.range.getRow();

  // Проверяем нужный лист и столбец F
  if (sheet.getName() !== 'Заявки' || editedColumn !== 6) return;

  // Берём новое значение из изменённой ячейки
  const status = e.value || '';

  // Если статус пустой, письмо не отправляем
  if (!status) return;

  // Отправляем письмо
  GmailApp.sendEmail(
    'boss@example.com', // [ЗАПОЛНИТЬ: адрес получателя, если нужен другой]
    'Новый статус',
    status
  );
}

Что было не так простыми словами:

• onEdit(e) — это простой триггер.
• Простой триггер не имеет права отправлять письма через GmailApp.
• Нужно поставить устанавливаемый триггер на эту функцию.

Шаги установки:

1. Откройте Расширения → Apps Script.
2. Вставьте код и сохраните проект.
3. Запустите функцию handleEditSendEmail вручную один раз, чтобы выдать доступы.
4. Если появится запрос разрешений — подтвердите их.
5. Откройте Триггеры в Apps Script.
6. Нажмите Добавить триггер.
7. Выберите функцию: handleEditSendEmail.
8. Источник события: Из таблицы.
9. Тип события: При изменении.
10. Сохраните триггер.

Важно:

• Проверьте сначала на копии таблицы.
• Не отправляйте массовые письма без теста.
• e.value в триггере есть только при редактировании одной ячейки; если вставляют диапазон сразу, значение может быть другим.
• Для Gmail у аккаунта должны быть права на отправку писем; на некоторых аккаунтах Workspace администратор может ограничивать доступ.

Ниже — простыми словами, что делает ваш скрипт.

1) По функциям

function fillTemplate()

Что делает:
- Берёт текущий открытый Google Документ:
  - DocumentApp.getActiveDocument()
- Получает его тело документа:
  - doc.getBody()
  - Но дальше переменная body никак не используется.
- Открывает таблицу по ID:
  - SpreadsheetApp.openById('1AbC')
- Берёт лист с названием:
  - 'Клиенты'
- Забирает все данные с этого листа:
  - getDataRange().getValues()
- Пропускает первую строку:
  - data.slice(1)
  - Обычно это заголовки столбцов.
- Для каждой строки:
  - делает копию текущего документа в Google Диске:
    - DriveApp.getFileById(doc.getId()).makeCopy(r[0])
    - Имя копии берётся из r[0]
  - открывает эту копию как документ:
    - DocumentApp.openById(copy.getId())
  - заменяет в тексте шаблонные поля:
    - {{ИМЯ}} → r[0]
    - {{СУММА}} → r[1]

2) Когда он запускается и что произойдёт

Запуск:
- В коде нет триггера.
- Значит, функция fillTemplate() сама по себе не запускается автоматически.
- Она сработает только если:
  - вы запустите её вручную из редактора Apps Script,
  - или подключите к ней установимый триггер.

Что произойдёт при запуске:
- Скрипт прочитает все строки из листа 'Клиенты' в таблице с ID '1AbC'.
- Для каждой строки, начиная со второй:
  - создаст отдельную копию текущего документа,
  - назовёт копию значением из первого столбца строки,
  - заменит в копии {{ИМЯ}} и {{СУММА}} на значения из строки.

3) Что опасного есть в скрипте

- Доступ к файлам:
  - Да.
  - Используются:
    - DocumentApp.getActiveDocument()
    - SpreadsheetApp.openById('1AbC')
    - DriveApp.getFileById(doc.getId()).makeCopy(...)
    - DocumentApp.openById(copy.getId())
  - Это значит, что скрипт читает таблицу, берёт текущий документ и создаёт копии файлов на Диске.

- Отправка писем:
  - Нет.
  - GmailApp в коде не используется.

- Удаление данных:
  - Нет.
  - Удаляющих методов нет.

- Внешние запросы:
  - Нет.
  - UrlFetchApp и похожие сервисы не используются.

4) Проверка сервисов, классов и методов

В вашем коде используются корректные сервисы Apps Script:
- DocumentApp.getActiveDocument() — существует
- doc.getBody() — существует
- SpreadsheetApp.openById('1AbC') — существует
- getSheetByName('Клиенты') — существует
- getDataRange().getValues() — существует
- DriveApp.getFileById(doc.getId()) — существует
- makeCopy(r[0]) — существует
- DocumentApp.openById(copy.getId()) — существует
- replaceText('{{ИМЯ}}', r[0]) — существует
- replaceText('{{СУММА}}', r[1]) — существует

По аргументам:
- openById принимает строку ID — у вас так и есть.
- getSheetByName принимает имя листа — у вас так и есть.
- makeCopy принимает имя новой копии — у вас так и есть.
- replaceText принимает шаблон и строку замены — у вас используется корректно, но значения лучше приводить к строке, если есть риск, что там не текст.

5) Важные замечания

- Переменная body:
  - объявлена, но не используется.
- data содержит весь лист:
  - если в листе много строк, скрипт создаст много копий документа.
- Если r[0] пустой:
  - имя копии может получиться пустым или неудобным.
- Если в r[1] число:
  - replaceText обычно ожидает строку, лучше явно преобразовать:
    - String(r[1])

6) Простое объяснение в одну фразу

Этот скрипт берёт строки из таблицы 'Клиенты', делает по одной копии текущего документа на каждую строку и подставляет в копии имя и сумму из таблицы.

7) Что в нём не хватает для запуска по триггеру

Сейчас триггера нет. Если нужен автоматический запуск, нужно отдельно добавить установимый триггер на функцию fillTemplate.

Если хотите, я могу сразу переписать этот же скрипт в более надёжном виде: с проверкой пустых строк, преобразованием значений к строке и понятными комментариями.