Перейти к содержимому
AISARAISAR
Все инструкции

Google Sheets: подключение и блоки сценариев

Как подключить аккаунт Google к AISAR, добавить таблицы и настроить в сценариях блоки «Добавить строку», «Найти строку» и «Обновить строку».

Что даёт интеграция

Сценарии AISAR сами записывают заявки из мессенджеров в вашу таблицу Google, находят в ней клиента по телефону и меняют ячейки, например статус. Таблицу больше не нужно вести руками или собирать через сторонние сервисы. Обзор возможностей на сайте: aisar.app/ru/integrations/google-sheets.

Блоки Google Sheets доступны на тарифах, где есть сценарии. Состав тарифов: aisar.app/#pricing. В AISAR Kids интеграции нет.

Кто может подключать

  • Подключать и отключать аккаунты Google, добавлять и убирать таблицы может администратор компании. В своих ролях это право выдать нельзя. Остальные увидят на странице подсказку «Попросите администратора с правом на интеграции подключить Google Sheets».
  • Выбирать таблицу в блоках сценария может любой, кто редактирует сценарии. Ему видны только таблицы, которые администратор уже добавил в настройках.
  • Выбрать из Google Drive может только тот, кто подключил этот аккаунт: окно Google открывается с его доступом. Другой администратор может создать новую таблицу в этом аккаунте или подключить свой.

Шаг 1. Подключите аккаунт Google

  1. В my.aisar.app откройте Настройки → CRM и интеграции → Каталог и у карточки Google Sheets нажмите «Настроить». Когда аккаунт уже подключён, кнопка называется «Управлять», а в меню настроек под «CRM и интеграции» появляется отдельный пункт Google Sheets.
  2. На странице Google Sheets перечислено, что смогут делать сценарии, а кнопка «Как это работает» открывает эту статью. Нажмите «Подключить Google». Откроется окно входа Google: выберите аккаунт, в Google Drive которого будут лежать таблицы.
  3. На экране с разрешениями Google отметьте пункт о файлах Google Диска (или «Выбрать все») и нажмите «Продолжить».
  4. Google вернёт вас в AISAR, и вы увидите «Google Sheets подключён». Нажмите «Перейти к таблицам».
Настройки → CRM и интеграции → Каталог: карточка Google Sheets с подписью «Подключено: 1 аккаунт» и кнопкой «Управлять», в меню слева пункт Google Sheets
Галочка у пункта о файлах Google Диска обязательна. Если её снять, AISAR покажет «Не хватает разрешения на файлы» и не сохранит подключение: без этого разрешения он не может записывать строки. Бояться за остальные файлы не нужно, разрешение открывает только те таблицы, которые вы создадите в AISAR или выберете сами.
Экран «Не хватает разрешения на файлы» с кнопками «Подключить ещё раз» и «Вернуться к настройкам»

Аккаунтов можно подключить несколько, кнопкой «Подключить ещё аккаунт»: например, отдельный для отдела продаж и для школы. Один аккаунт Google работает только с одной компанией в AISAR. Если он уже подключён к другой компании, появится «Этот аккаунт Google уже подключён к другой компании»: выберите другой аккаунт или сначала отключите этот там.

Шаг 2. Добавьте таблицы

AISAR не видит ваш Google Drive целиком, об этом напоминает подсказка внизу страницы: «AISAR видит только таблицы из этого списка». Сценарии работают только с таблицами из списка «Таблицы» под аккаунтом, а попадают туда таблицы двумя способами.

Страница Google Sheets: кнопки «Как это работает» и «Подключить ещё аккаунт», карточка аккаунта со статусом «Активно» и кнопкой «Отключить», раздел «Таблицы» с кнопками «Создать таблицу» и «Выбрать из Google Drive», строка таблицы и подсказка о том, что AISAR видит только эти таблицы

Создать таблицу

  1. Нажмите «Создать таблицу».
  2. Укажите «Название», например «Заявки на пробный урок», и при желании «Лист» (по умолчанию «Лист1»).
  3. В поле «Названия колонок в первой строке» введите заголовки по одному, после каждого нажимайте Enter: «Имя», «Телефон», «Канал», «Статус». Колонок до 50. Поле можно оставить пустым, тогда в блоках колонки будут подписаны буквами.
  4. Нажмите «Создать таблицу». Файл появится в Google Drive подключённого аккаунта и сразу встанет в список.
Панель «Создать таблицу» с полями «Название», «Лист» и «Названия колонок в первой строке» и кнопками «Отмена» и «Создать таблицу»

Выбрать из Google Drive

Если таблица уже есть, нажмите «Выбрать из Google Drive». Откроется окно Google со списком ваших файлов: выберите таблицу, и AISAR загрузит её листы и названия колонок. Окно открывается во всплывающем окне с адреса apis.google.com, поэтому блокировщик рекламы или запрет всплывающих окон может ему помешать.

Названия колонок AISAR берёт из первой строки каждого листа. У каждой таблицы в списке видны листы с числом колонок и время последнего обновления. Справа в строке две кнопки: иконка со стрелкой «Открыть в Google» открывает файл, а меню «…» содержит два пункта. «Обновить колонки» нужен, если вы добавили лист или переименовали колонки в самой таблице. «Убрать» убирает таблицу из AISAR после подтверждения, а сам файл остаётся в Google Drive. На один аккаунт можно добавить до 50 таблиц.

Открытое меню «…» у строки таблицы с пунктами «Обновить колонки» и «Убрать», рядом иконка «Открыть в Google»

Шаг 3. Блоки в сценарии

В редакторе сценария нажмите «Добавить действие»: блоки лежат в «Библиотеке действий», в категории «Интеграции». Начало настройки у всех трёх одинаковое: «Аккаунт Google», «Таблица», «Лист». Рядом с таблицей есть ссылка «Открыть в Google», а в заголовке раздела ссылка «Настройки Google Sheets». Колонки показываются с буквой и названием из первой строки, например «C: Телефон». Если подключений ещё нет, блок предложит «Открыть настройки», а сценарий сохранится как черновик.

Библиотека действий, категория «Интеграции»: блоки «Добавить строку в Google Sheets», «Найти строку в Google Sheets» и «Обновить строку в Google Sheets»

В значения можно подставлять переменные так же, как в тексте сообщения: {{contact.name}}, {{contact.phone}}, {{vars.name}} и другие, подробнее в статье «Переменные, константы и кнопки в сценариях». У каждого блока есть выход «Не удалось»: туда сценарий идёт при ошибке Google, потере доступа или удалённой таблице.

«Добавить строку в Google Sheets»

Записывает новую строку в конец листа. В разделе «Что записать» нажмите «Добавить колонку», выберите «Колонку» и укажите «Значение»: текст, переменную или их смесь. Колонок до 50, значение до 2000 символов. Колонки между выбранными останутся пустыми. Выходы: «Добавлено» (номер новой строки виден в запуске) и «Не удалось».

Пример: заявки из мессенджера. Сценарий запускается на новый диалог, блок «Спросить и сохранить» спрашивает, на какой курс клиент хочет записаться, и кладёт ответ в course. Дальше «Добавить строку»:

КолонкаЗначение
A: Имя{{contact.name}}
B: Телефон{{contact.phone}}
C: Курс{{vars.course}}
D: СтатусНовая
Настройки блока «Добавить строку в Google Sheets»: аккаунт, таблица и лист, в разделе «Что записать» колонки «A: Имя», «B: Телефон», «C: Статус» со значениями {{contact.name}}, {{contact.phone}} и «Новая», ниже выходы «Добавлено» и «Не удалось»

«Найти строку в Google Sheets»

Ищет строку по значению в одной колонке и сохраняет ячейки найденной строки в переменные. Настройки:

  • «Колонка для поиска» и «Значение», обычно переменная. Если после подстановки значение пустое, блок сразу идёт по выходу «Не найдено».
  • «Как сравнивать»: «Совпадает со значением» (без учёта регистра и пробелов по краям) или «Телефон: по последним 10 цифрам». Во втором случае +7 701 555 12 34 и 8 (701) 555-12-34 считаются одним номером.
  • «Сохранить в переменные»: какая колонка в какую переменную. Имена латиницей, цифрами и _, до 20 переменных. Ячейки приходят текстом, как их видно в таблице.
  • «Номер найденной строки»: переменная, по умолчанию sheet_row. Дальше номер доступен как {{vars.sheet_row}}.

Поиск идёт по последним 20 000 строкам листа. Если совпадений несколько, берётся самая нижняя строка: новые заявки обычно внизу. Выходы: «Найдено», «Не найдено», «Не удалось».

Пример: клиент пишет «когда у меня урок?». Блок ищет в колонке «B: Телефон» значение {{contact.phone}} в режиме «Телефон», а колонку «E: Дата записи» сохраняет в переменную lesson_date. На выходе «Найдено» стоит сообщение «Вы записаны на {{vars.lesson_date}}», на выходе «Не найдено» сообщение «Не нашли вашу запись, сейчас подключится менеджер» и назначение на сотрудника.

Настройки блока «Найти строку в Google Sheets»: поиск по колонке «B: Телефон» в режиме «Телефон: по последним 10 цифрам» со значением {{contact.phone}}, колонка «C: Статус» сохраняется в переменную status, номер строки в sheet_row, выходы «Найдено», «Не найдено», «Не удалось»

«Обновить строку в Google Sheets»

Меняет выбранные ячейки в одной строке, остальные ячейки не трогает. В разделе «Какую строку обновить» две вкладки:

  • «Номер из переменной»: в поле «Номер строки» обычно {{vars.sheet_row}} из блока «Найти строку». Номер берётся только из переменных предыдущих шагов, не из данных триггера, и должен быть от 2: первая строка занята названиями колонок. Пустой номер или не число ведёт на выход «Не удалось».
  • «Найти по колонке» (выбрана по умолчанию): поиск прямо в этом блоке, с теми же настройками, что у «Найти строку». Здесь же переключатель «Не нашли: добавить строку», он выключен по умолчанию. Если его включить, при отсутствии строки блок добавит новую с этими значениями и пойдёт по выходу «Обновлено».

Ниже, в «Что записать», выберите колонки и значения. Выходы: «Обновлено» и «Не удалось», а при поиске по колонке ещё «Не найдено».

Настройки блока «Обновить строку в Google Sheets»: вкладка «Номер из переменной» с номером {{vars.sheet_row}}, в «Что записать» колонка «C: Статус» со значением «Оплачено», выходы «Обновлено» и «Не удалось»

Пример: менеджер подтвердил оплату и поставил клиенту тег «Оплачено». Сценарий, который запускается на изменение тегов контакта, вызывает «Обновить строку» с поиском по «B: Телефон» = {{contact.phone}} в режиме «Телефон» и пишет в «D: Статус» значение «Оплачено». Если перед этим в сценарии уже был блок «Найти строку», достаточно номера {{vars.sheet_row}}, второй раз искать не нужно.

Тестовый запуск сценария пишет в таблицу по-настоящему. Для проверки удобно завести отдельный лист или копию таблицы.

Что важно знать

  • Формулы не выполняются. Всё пишется как текст: значение, которое начинается с =, в таблице останется строкой и не станет формулой. Числа без ведущего нуля попадут в таблицу числом, а телефоны вроде +7 701 и коды с нулём впереди останутся текстом.
  • Лимиты Google. Google ограничивает число запросов к таблицам в минуту, и AISAR держит темп ниже этого лимита. Если заявок приходит слишком много сразу или Google временно не отвечает, шаг не падает, а ждёт и повторяет запрос: через 30 секунд, 2 минуты и 10 минут. Это видно в запуске сценария. Если не прошёл и третий повтор, шаг уходит по выходу «Не удалось». Когда упираетесь в лимит постоянно, разнесите сценарии по разным таблицам или аккаунтам.
  • Ответ не пришёл вовремя. Если Google не ответил за 10 секунд на запись строки, AISAR не знает, записалась ли она, и не повторяет запрос, чтобы не появился дубль. Шаг уходит в «Не удалось» с причиной «Google не ответил вовремя». Проверьте конец листа, прежде чем добавлять заявку вручную.
  • Таблицу удалили. Шаг уходит в «Не удалось» с причиной «Таблица удалена». Восстановите файл из корзины Google Drive или выберите в блоке другую таблицу.
  • Закрыли доступ к файлу. Если владелец убрал доступ или файл перенесли, причина будет «Google закрыл доступ к таблице». Выберите таблицу заново через «Выбрать из Google Drive».
  • Удалили лист. Причина «Лист не найден». Выберите лист в блоке заново.
  • Доступ к аккаунту отозван. Если в аккаунте Google сменили пароль или отозвали доступ для AISAR, у аккаунта в настройках появится статус «Доступ потерян», а шаги с его таблицами пойдут по выходу «Не удалось». Нажмите «Переподключить» и войдите тем же аккаунтом: таблицы и настройки блоков сохранятся.

Отключение

Кнопка «Отключить» у аккаунта отзывает доступ AISAR у Google и убирает аккаунт вместе с его таблицами из AISAR. Сами таблицы остаются в Google Drive, их никто не трогает. В окне подтверждения видно, сколько сценариев пишут в таблицы этого аккаунта: после «Да, отключить» их шаги Google Sheets пойдут по выходу «Не удалось». Если потом подключить аккаунт снова, таблицы придётся добавить заново и выбрать их в блоках.

Чтобы убрать только одну таблицу, откройте меню «…» у неё, выберите «Убрать» и подтвердите кнопкой «Убрать». Блоки, где она выбрана, будут уходить по выходу «Не удалось», пока в них не выберут другую.

Частые проблемы и решения

Что видитеЧто делать
«Не хватает разрешения на файлы»На экране согласия Google сняли галочку с пункта о файлах Google Диска. Нажмите «Подключить ещё раз» и оставьте галочку (или отметьте «Выбрать все»).
«Ссылка для подключения устарела»С начала подключения прошло больше 15 минут, или окно Google открыли из старой вкладки. Нажмите «Начать заново» и пройдите вход в Google без долгих пауз.
«Вы не дали разрешение»В окне Google нажали «Отмена». Подключите аккаунт ещё раз и нажмите «Продолжить».
Таблицы нет в списке блокаБлок показывает только таблицы, добавленные в настройках под выбранным аккаунтом. Проверьте, что выбран нужный «Аккаунт Google», и добавьте таблицу кнопкой «Создать таблицу» или «Выбрать из Google Drive». Файлы из Google Drive сами в AISAR не появляются.
Нет кнопки выбора из Google Drive или она не срабатываетВыбирать из Google Drive может только тот, кто подключил аккаунт. Если это вы, разрешите всплывающие окна и проверьте, что блокировщик не режет apis.google.com.
Нет нового листа или колонки в блокеНажмите «Обновить колонки» в блоке или в меню «…» у таблицы в настройках: AISAR перечитает листы и первую строку.
«У этого аккаунта уже 50 таблиц в AISAR»Уберите ненужную таблицу или подключите ещё один аккаунт.

Смотрите также

Как устроены сценарии — в «Автоматизациях». Переменные и блок «Спросить и сохранить» — в «Переменных, константах и кнопках в сценариях». Обзор интеграции — на странице aisar.app/ru/integrations/google-sheets.