Отправка LINE-сообщений с использованием Google Apps Script: Полное руководство

13.06.2025
18884

11 мин
59

Введение в отправку LINE-сообщений с помощью Google Apps Script

Интеграция различных платформ и сервисов стала неотъемлемой частью современной разработки и автоматизации бизнес-процессов. Google Apps Script (GAS) предоставляет мощную и гибкую среду для расширения функциональности Google Workspace, а LINE Messaging API позволяет взаимодействовать с популярным мессенджером LINE. Объединение этих двух инструментов открывает широкие возможности для автоматизации уведомлений, создания ботов и интеграции с вашими данными.

Что такое Google Apps Script и его возможности?

Google Apps Script — это облачная платформа для разработки скриптов на основе JavaScript, которая позволяет автоматизировать задачи, интегрировать различные сервисы Google (Sheets, Docs, Forms, Calendar, Drive, Gmail и др.) и взаимодействовать с внешними API. GAS выполняется на серверах Google, что избавляет от необходимости управлять собственной инфраструктурой.

Ключевые возможности GAS включают:

Создание пользовательских функций для Google Sheets.
Автоматизацию рутинных задач (например, отправка отчетов по расписанию).
Создание веб-приложений и дополнений для продуктов Google Workspace.
Взаимодействие с внешними сервисами через API с использованием UrlFetchApp.

Что такое LINE и зачем интегрировать его с Google Apps Script?

LINE — популярный мессенджер, особенно распространенный в странах Азии (Япония, Таиланд, Тайвань, Индонезия). Он предлагает Messaging API, позволяющий разработчикам создавать ботов для взаимодействия с пользователями, отправки сообщений, получения информации и выполнения команд.

Интеграция LINE с Google Apps Script целесообразна для:

Автоматизации уведомлений: Отправка сообщений в LINE при наступлении событий в Google Workspace (например, добавление строки в Google Sheets, новое событие в Google Calendar).
Создания ботов: Разработка ботов, которые могут получать данные из Google Sheets или других источников Google и отвечать пользователям в LINE.
Маркетинговых кампаний: Отправка персонализированных сообщений или промо-акций сегментам пользователей LINE на основе данных из Google Sheets.

Преимущества автоматизации отправки LINE-сообщений

Оперативность: Мгновенная доставка важной информации пользователям.
Эффективность: Снижение ручного труда и времени на отправку уведомлений.
Персонализация: Возможность отправки кастомизированных сообщений на основе данных.
Интеграция: Бесшовная связь между вашими данными в Google Workspace и аудиторией в LINE.
Гибкость: Широкие возможности настройки логики отправки с помощью GAS.

Обзор необходимых инструментов и аккаунтов

Аккаунт Google: Для доступа к Google Apps Script и другим сервисам Google Workspace.
Аккаунт LINE: Обычный пользовательский аккаунт.
Аккаунт разработчика LINE (LINE Developers Console): Для создания провайдера, канала (бота) и получения токена доступа.
Среда разработки Google Apps Script: Встроенный редактор скриптов (script.google.com) или локальная разработка с использованием clasp.

Настройка LINE Messaging API

Перед написанием кода необходимо настроить окружение в LINE Developers Console.

Создание LINE аккаунта разработчика

Перейдите на сайт LINE Developers.
Войдите, используя ваш существующий аккаунт LINE, или создайте новый.
Создайте нового провайдера (Provider), если у вас его еще нет. Провайдер — это сущность, объединяющая ваши каналы (ботов).

Получение токена доступа (Access Token) для вашего LINE Bot

Внутри вашего провайдера создайте новый канал (Channel) типа Messaging API.
Заполните необходимую информацию о канале (имя, описание, категория и т.д.).
После создания канала перейдите на вкладку Messaging API.
Найдите раздел Channel access token.
Нажмите кнопку Issue для генерации долгосрочного токена доступа (Long-lived access token). Важно: Храните этот токен в безопасности, так как он предоставляет доступ к API от имени вашего бота.

Настройка параметров LINE Bot (например, Webhook URL)

Хотя для простой отправки сообщений из GAS вебхуки (Webhooks) не обязательны, они нужны, если вы хотите, чтобы ваш бот реагировал на сообщения пользователей.

Webhook URL: Если вы планируете обрабатывать входящие сообщения, вам нужно будет развернуть ваш Google Apps Script как веб-приложение и указать его URL в поле Webhook URL в настройках канала на вкладке Messaging API. Включите опцию Use webhook.
Автоответы: Рекомендуется отключить стандартные автоответы (Auto-reply messages) и приветственные сообщения (Greeting messages), если вы планируете управлять ими полностью через API.

Написание кода Google Apps Script для отправки LINE-сообщений

Основным инструментом для взаимодействия с внешними API в GAS является сервис UrlFetchApp.

Импорт библиотеки UrlFetchApp

UrlFetchApp является встроенным сервисом Google Apps Script, поэтому явный импорт библиотеки не требуется. Вы можете использовать его напрямую в вашем коде.

Создание функции для отправки сообщений в LINE

Рекомендуется создать отдельную функцию для инкапсуляции логики отправки сообщений.

/**
 * Отправляет сообщение указанному пользователю LINE.
 * @param {string} userId Идентификатор пользователя LINE (или группы/комнаты).
 * @param {Object[]} messages Массив объектов сообщений LINE.
 * @param {string} accessToken Токен доступа канала LINE Messaging API.
 * @returns {GoogleAppsScript.URL_Fetch.HTTPResponse | null} Объект ответа от LINE API или null в случае ошибки.
 */
function sendLineMessage(userId: string, messages: object[], accessToken: string): GoogleAppsScript.URL_Fetch.HTTPResponse | null {
  const LINE_API_ENDPOINT: string = 'https://api.line.me/v2/bot/message/push';

  // Проверка наличия токена
  if (!accessToken) {
    Logger.log('Ошибка: Токен доступа LINE не предоставлен.');
    return null;
  }

  const payload: object = {
    to: userId,
    messages: messages,
  };

  const options: GoogleAppsScript.URL_Fetch.URLFetchRequestOptions = {
    method: 'post',
    contentType: 'application/json',
    headers: {
      Authorization: 'Bearer ' + accessToken,
    },
    payload: JSON.stringify(payload),
    muteHttpExceptions: true, // Важно для обработки ошибок API
  };

  try {
    const response: GoogleAppsScript.URL_Fetch.HTTPResponse = UrlFetchApp.fetch(LINE_API_ENDPOINT, options);
    Logger.log('Ответ от LINE API: Код = %s, Тело = %s', response.getResponseCode(), response.getContentText());
    return response;
  } catch (error) {
    Logger.log('Ошибка при отправке запроса к LINE API: %s', error);
    return null;
  }
}

Формирование запроса POST с телом сообщения в формате JSON

Тело запроса (payload) должно соответствовать спецификации LINE Messaging API. Для отправки (push) сообщений основными полями являются to (идентификатор получателя) и messages (массив объектов сообщений).

Отправка запроса к LINE Messaging API

Используем UrlFetchApp.fetch(url, options). Параметр options содержит метод (post), заголовки (Authorization, Content-Type) и тело запроса (payload).

Обработка ответов от LINE Messaging API (успех/ошибка)

Благодаря muteHttpExceptions: true, ошибки HTTP (например, 400, 401, 403, 500) не приведут к падению скрипта, а будут доступны в объекте response. Анализируйте response.getResponseCode():

200 OK: Запрос успешно обработан.
400 Bad Request: Ошибка в формате запроса (проверьте payload).
401 Unauthorized: Неверный или отсутствующий токен доступа.
403 Forbidden: Нет прав на выполнение операции (например, пользователь заблокировал бота).
429 Too Many Requests: Превышен лимит отправки сообщений.
500 Internal Server Error: Проблема на стороне серверов LINE.

response.getContentText() содержит тело ответа, которое часто включает детали ошибки в формате JSON.

Отправка различных типов сообщений

LINE API поддерживает множество типов сообщений. Рассмотрим основные.

Отправка текстовых сообщений

Самый простой тип сообщения.

/**
 * Пример отправки простого текстового сообщения.
 */
function sendSimpleText() {
  const TARGET_USER_ID: string = 'Uxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx'; // Замените на реальный User ID
  const ACCESS_TOKEN: string = PropertiesService.getScriptProperties().getProperty('LINE_ACCESS_TOKEN') || '';

  const textMessage: object = {
    type: 'text',
    text: 'Привет из Google Apps Script!',
  };

  sendLineMessage(TARGET_USER_ID, [textMessage], ACCESS_TOKEN);
}

Отправка изображений

Необходимо указать URL изображения (HTTPS) и URL превью.

/**
 * Пример отправки изображения.
 */
function sendImage() {
  const TARGET_USER_ID: string = 'Uxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx';
  const ACCESS_TOKEN: string = PropertiesService.getScriptProperties().getProperty('LINE_ACCESS_TOKEN') || '';

  const imageMessage: object = {
    type: 'image',
    originalContentUrl: 'https://example.com/original.jpg', // URL должен быть HTTPS
    previewImageUrl: 'https://example.com/preview.jpg', // URL должен быть HTTPS
  };

  sendLineMessage(TARGET_USER_ID, [imageMessage], ACCESS_TOKEN);
}

Отправка стикеров

Нужно знать packageId и stickerId стикера. Их можно найти в официальной документации LINE или с помощью специальных инструментов.

/**
 * Пример отправки стикера.
 */
function sendSticker() {
  const TARGET_USER_ID: string = 'Uxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx';
  const ACCESS_TOKEN: string = PropertiesService.getScriptProperties().getProperty('LINE_ACCESS_TOKEN') || '';

  const stickerMessage: object = {
    type: 'sticker',
    packageId: '11537',
    stickerId: '52002734',
  };

  sendLineMessage(TARGET_USER_ID, [stickerMessage], ACCESS_TOKEN);
}

Отправка кнопок (Buttons template)

Позволяет добавить интерактивные кнопки к сообщению.

/**
 * Пример отправки сообщения с кнопками.
 */
function sendButtonTemplate() {
  const TARGET_USER_ID: string = 'Uxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx';
  const ACCESS_TOKEN: string = PropertiesService.getScriptProperties().getProperty('LINE_ACCESS_TOKEN') || '';

  const buttonTemplateMessage: object = {
    type: 'template',
    altText: 'Это шаблон с кнопками.',
    template: {
      type: 'buttons',
      thumbnailImageUrl: 'https://example.com/button-image.jpg',
      imageAspectRatio: 'rectangle',
      imageSize: 'cover',
      imageBackgroundColor: '#FFFFFF',
      title: 'Меню',
      text: 'Пожалуйста, выберите действие:',
      // defaultAction: { type: 'uri', label: 'View detail', uri: 'http://example.com/page/123' },
      actions: [
        {
          type: 'postback',
          label: 'Купить',
          data: 'action=buy&itemid=123',
          displayText: 'Я хочу купить товар 123',
        },
        {
          type: 'message',
          label: 'Спросить',
          text: 'Какой размер у товара 123?',
        },
        {
          type: 'uri',
          label: 'Подробнее',
          uri: 'https://example.com/product/123',
        },
      ],
    },
  };

  sendLineMessage(TARGET_USER_ID, [buttonTemplateMessage], ACCESS_TOKEN);
}

Отправка карусели (Carousel template)

Позволяет отображать несколько элементов (колонок) с изображениями, текстом и кнопками в горизонтальной прокрутке.

/**
 * Пример отправки карусели.
 */
function sendCarouselTemplate() {
  const TARGET_USER_ID: string = 'Uxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx';
  const ACCESS_TOKEN: string = PropertiesService.getScriptProperties().getProperty('LINE_ACCESS_TOKEN') || '';

  const carouselTemplateMessage: object = {
    type: 'template',
    altText: 'Это шаблон карусели.',
    template: {
      type: 'carousel',
      columns: [
        {
          thumbnailImageUrl: 'https://example.com/item1.jpg',
          imageBackgroundColor: '#FFFFFF',
          title: 'Товар 1',
          text: 'Описание товара 1',
          // defaultAction: { type: 'uri', label: 'View detail', uri: 'http://example.com/page/111' },
          actions: [
            { type: 'postback', label: 'Купить', data: 'action=buy&itemid=111' },
            { type: 'uri', label: 'Подробнее', uri: 'https://example.com/product/111' },
          ],
        },
        {
          thumbnailImageUrl: 'https://example.com/item2.jpg',
          imageBackgroundColor: '#000000',
          title: 'Товар 2',
          text: 'Описание товара 2',
          // defaultAction: { type: 'uri', label: 'View detail', uri: 'http://example.com/page/222' },
          actions: [
            { type: 'postback', label: 'Купить', data: 'action=buy&itemid=222' },
            { type: 'uri', label: 'Подробнее', uri: 'https://example.com/product/222' },
          ],
        },
      ],
      imageAspectRatio: 'rectangle',
      imageSize: 'cover',
    },
  };

  sendLineMessage(TARGET_USER_ID, [carouselTemplateMessage], ACCESS_TOKEN);
}

Автоматизация отправки сообщений по расписанию или триггеру

Google Apps Script позволяет запускать функции автоматически с помощью триггеров.

Использование триггеров Google Apps Script (Time-driven triggers, Event-driven triggers)

Time-driven triggers (Триггеры по времени): Запускают функцию через определенные интервалы времени (каждые N минут/часов, ежедневно, еженедельно, ежемесячно).
Event-driven triggers (Триггеры по событиям): Запускают функцию при наступлении определенных событий в Google Workspace:
- onOpen(): При открытии документа/таблицы/формы.
- onEdit(): При редактировании таблицы.
- onInstall(): При установке дополнения.
- doGet() / doPost(): При обращении к скрипту, развернутому как веб-приложение.
- Триггеры Google Forms (onSubmit).
- Триггеры Google Calendar (onEventUpdate).

Триггеры настраиваются в редакторе скриптов через меню «Триггеры» (значок будильника).

Примеры: отправка ежедневных отчетов, уведомлений о событиях и т.д.

Ежедневный отчет о продажах: Настроить триггер по времени на ежедневный запуск функции, которая собирает данные из Google Sheets и отправляет сводку в LINE.
Уведомление о новой заявке: Настроить триггер onSubmit для Google Forms, который при отправке формы запускает функцию, отправляющую данные заявки менеджеру в LINE.
Напоминание о событии: Настроить триггер по времени, который проверяет Google Calendar на наличие событий в ближайшее время и отправляет напоминания участникам в LINE.

Настройка временных зон для корректной работы триггеров

При настройке триггеров по времени важно убедиться, что временная зона проекта Google Apps Script установлена корректно. Это можно сделать в настройках проекта (меню «Настройки проекта» — значок шестеренки).

Получение данных из Google Sheets для отправки персонализированных сообщений

Интеграция с Google Sheets — одно из самых частых применений GAS + LINE.

Чтение данных из Google Sheets с помощью Google Apps Script

Используйте сервис SpreadsheetApp для доступа к таблицам и их данным.

/**
 * Читает данные из указанного листа Google Sheets.
 * @param {string} sheetName Имя листа.
 * @returns {any[][]} Двумерный массив данных.
 */
function readSheetData(sheetName: string): any[][] {
  try {
    const ss = SpreadsheetApp.getActiveSpreadsheet();
    const sheet = ss.getSheetByName(sheetName);
    if (!sheet) {
      Logger.log('Ошибка: Лист с именем "%s" не найден.', sheetName);
      return [];
    }
    // Получаем все данные с листа, исключая заголовок (если нужно)
    // return sheet.getDataRange().getValues(); // Все данные
    return sheet.getSheetValues(2, 1, sheet.getLastRow() - 1, sheet.getLastColumn()); // Данные со 2-й строки
  } catch (error) {
    Logger.log('Ошибка при чтении данных из Google Sheets: %s', error);
    return [];
  }
}

Формирование персонализированных сообщений на основе данных из Sheets

После получения данных (например, список клиентов и их статусы заказов), можно итерировать по массиву и формировать уникальные сообщения для каждого.

/**
 * Отправляет персонализированные уведомления о статусе заказа пользователям из Google Sheets.
 */
function sendOrderStatusUpdates() {
  const SHEET_NAME: string = 'Заказы'; // Имя листа с данными
  const USER_ID_COLUMN_INDEX: number = 0; // Индекс столбца с LINE User ID (начиная с 0)
  const ORDER_STATUS_COLUMN_INDEX: number = 2; // Индекс столбца со статусом заказа
  const CUSTOMER_NAME_COLUMN_INDEX: number = 1; // Индекс столбца с именем клиента

  const ACCESS_TOKEN: string = PropertiesService.getScriptProperties().getProperty('LINE_ACCESS_TOKEN') || '';
  const data: any[][] = readSheetData(SHEET_NAME);

  if (!ACCESS_TOKEN) {
    Logger.log('Токен доступа LINE не найден в свойствах скрипта.');
    return;
  }

  data.forEach((row: any[]) => {
    const userId: string = row[USER_ID_COLUMN_INDEX];
    const status: string = row[ORDER_STATUS_COLUMN_INDEX];
    const name: string = row[CUSTOMER_NAME_COLUMN_INDEX];

    // Проверяем, что User ID есть и статус не пустой
    if (userId && status) {
      const messageText: string = `Уважаемый(ая) ${name}, статус вашего заказа изменен на: ${status}.`;
      const textMessage: object = {
        type: 'text',
        text: messageText,
      };
      sendLineMessage(userId, [textMessage], ACCESS_TOKEN);
      // Добавляем небольшую паузу, чтобы не превысить лимиты API
      Utilities.sleep(300);
    }
  });
}

Примеры: отправка уведомлений о новых заказах, персонализированные приветствия и т.д.

Новые заказы: При добавлении строки в лист ‘Заказы’ (триггер onEdit или onChange), отправить уведомление менеджеру и подтверждение клиенту.
Персонализированные акции: На основе сегмента клиента (столбец в Sheets) отправить ему специальное предложение через LINE.
Напоминания об оплате: Проверить даты оплаты в Sheets и отправить напоминание клиентам с просроченной задолженностью.

Обработка ошибок и отладка кода

Надежная обработка ошибок критически важна для стабильной работы автоматизации.

Логирование ошибок в Google Apps Script

Используйте Logger.log() или console.log() для записи информации о ходе выполнения и ошибках. Просмотреть логи можно в редакторе скриптов (меню «Выполнения»). Для более продвинутого логирования можно использовать Google Cloud Logging (требует настройки).

Проверка валидности токена доступа

Перед массовой отправкой или при получении ошибок 401 Unauthorized убедитесь, что ваш токен доступа действителен и не отозван. Можно добавить проверку в начало функций.

Обработка ошибок API LINE Messaging (например, превышение лимитов)

Анализируйте код ответа (response.getResponseCode()) и тело (response.getContentText()) от UrlFetchApp. При ошибке 429 Too Many Requests реализуйте логику повторной отправки с экспоненциальной задержкой (Utilities.sleep()).

Использование try-catch блоков для обработки исключений

Оборачивайте вызовы UrlFetchApp.fetch() и другие потенциально проблемные операции (например, работа с SpreadsheetApp) в блоки try...catch, чтобы предотвратить полное падение скрипта и логировать ошибки.

Лучшие практики и советы

Безопасное хранение токена доступа (например, использование PropertiesService)

Никогда не храните токен доступа LINE непосредственно в коде. Используйте PropertiesService.getScriptProperties() для хранения конфиденциальной информации.

// Сохранение токена (выполняется один раз или при обновлении)
// PropertiesService.getScriptProperties().setProperty('LINE_ACCESS_TOKEN', 'ВАШ_ДОЛГОСРОЧНЫЙ_ТОКЕН');

// Получение токена в коде
const ACCESS_TOKEN: string = PropertiesService.getScriptProperties().getProperty('LINE_ACCESS_TOKEN') || '';

Оптимизация кода для повышения производительности

Минимизируйте вызовы API: Старайтесь отправлять несколько сообщений одному пользователю за один вызов push API (массив messages).
Пакетная обработка: Читайте/записывайте данные в Google Sheets пакетами (getValues(), setValues()), а не по ячейкам.
Кэширование: Используйте CacheService для временного хранения часто запрашиваемых данных.
Избегайте Utilities.sleep() в циклах без необходимости, но используйте его для соблюдения лимитов API при массовых рассылках.

Управление квотами Google Apps Script

Помните о квотах Google Apps Script (время выполнения скрипта, количество вызовов UrlFetchApp, количество триггеров и т.д.). Оптимизируйте код и планируйте выполнение задач так, чтобы не превышать лимиты.

Создание удобного интерфейса для управления настройками (UI Service)

Для сложных скриптов можно создать пользовательский интерфейс с помощью HTML Service или UI Service (устаревший), чтобы пользователи могли легко изменять настройки (например, ID пользователей для рассылки, тексты сообщений, настройки триггеров) без редактирования кода.

Примеры использования и готовые решения

Пример 1: Отправка уведомлений о статусе заказа из Google Sheets

Этот пример был рассмотрен выше в разделе про интеграцию с Google Sheets. Он демонстрирует чтение данных о заказах и отправку персонализированных обновлений статуса клиентам в LINE.

Пример 2: Создание бота для автоматического ответа на вопросы пользователей

Это более сложный сценарий, требующий развертывания скрипта как веб-приложения и настройки Webhook URL в LINE Developers Console. Скрипт должен реализовывать функцию doPost(e), которая будет принимать входящие события от LINE (сообщения от пользователей), анализировать их и отправлять ответы с помощью replyMessage API (вместо push). Данные для ответов могут храниться в Google Sheets.

Пример 3: Отправка напоминаний о событиях из Google Calendar

Создайте функцию, которая использует CalendarApp для получения событий из определенного календаря на ближайшие 24 часа. Затем для каждого события извлеките участников и отправьте им напоминание в LINE с деталями события. Запускайте эту функцию ежедневно с помощью триггера по времени.

Заключение

Краткое повторение основных моментов

Мы рассмотрели, как настроить LINE Messaging API, получить токен доступа и использовать Google Apps Script (UrlFetchApp) для отправки различных типов сообщений в LINE. Мы также обсудили автоматизацию с помощью триггеров, интеграцию с Google Sheets для персонализации, обработку ошибок и лучшие практики разработки.

Перспективы развития и дальнейшее использование LINE Messaging API с Google Apps Script

Возможности интеграции GAS и LINE обширны:

Создание сложных чат-ботов с использованием AI/NLP сервисов.
Интеграция с другими сервисами Google (Gmail, Drive) для более комплексных рабочих процессов.
Построение систем CRM и поддержки клиентов на базе Google Sheets и LINE.
Автоматизация маркетинговых воронок и рассылок.

Полезные ресурсы и ссылки

LINE Developers Console: Основной портал для управления вашими ботами и каналами.
LINE Messaging API Reference: Официальная документация по всем возможностям API.
Google Apps Script Documentation: Официальная документация по GAS и его сервисам (UrlFetchApp, SpreadsheetApp, PropertiesService и т.д.).

Используя мощь Google Apps Script и гибкость LINE Messaging API, вы можете создавать эффективные и автоматизированные решения для коммуникации и взаимодействия с вашей аудиторией.