Google таблицы. Изменение данных → Создание заявки в MacroCRM (API)

Получайте данные из Google-таблицы при заполнении гугл форм или при изменении данных в таблице

и на основе этих данных создавайте заявки в MacroCRM

 

 

Создайте "Обработку"

Создайте "Обработку" в Webjack. В ней настраивается что/откуда получать и куда/как передавать.

Нажмите кнопку “Создать”,

дайте название для "Обработки" и нажмите "Cохранить"

Добавьте “Источник данных”

Добавьте “Источник данных”, нажмите кнопку “Добавить

Настройте Google-таблицу

Шаг 1. Для начала необходимо установить дополнение Trigger & Send в Google-таблицу

Шаг 2. Найдите дополнение "Trigger & Send"

Шаг 3. Установите его

Шаг 4. Выберите аккаунт гугл

Шаг 5. И разрешите доступ

Создайте обработку

Шаг 1. Создайте обработку и дайте ей название

Шаг 2. Добавьте источник данных

Шаг 3. Выберите в качестве источника данных "HTTP - запрос"

Шаг 4. Сохраните источник, оставив все настройки без изменений

Шаг 5. Скопируйте адрес Web-хука

Этот адрес понадобится в следующем шаге

Настройте уведомления

Шаг 1. Выберите событие при котором отправлять уведомления. Например "On Form Submit" (При отправке Google-формы)

Первая строка будет восприниматься как заголовок таблицы.

Шаг 2. Выберите тип события, при котором надо отправлять уведомление вставьте скопированный адрес и нажмите кнопку "Create form submit event"

Есть несколько событий, при которых будет отправляться уведомление. Основные 2 это:

- on Form Submit - При заполнении и отправке Google-формы

- on Event change - При изменении данных на листе

Добавьте действие "JSON-парсер"

Шаг 1. Данные уведомления из Google-таблицы приходит в формате JSON, поэтому необходимо извлечь из него данные с помощью парсера

Шаг 2. Настройте действие JSON-парсер

1. Выберите поле из которого надо извлечь данные. В нашем случае это "HTTP-запрос - Тело"

2. Добавьте и заполните поля JSON которые надо извлечь

["ID"] - где значение внутри скобок - это заголовок поля из Google-таблицы. Его надо указать в точности как в Google-таблице, в т.ч. заглавные и прописные буквы.

Укажите все поля, которые вам необходимо использовать в дальнейшем.

3. Сохраните действие

Теперь когда в Google-таблице будет происходить выбранное нами событие, то в обработку будет приходить уведомление с данными по строке, в которой были изменения. Парсер будет извлекать из данных нужные поля.

Дальше можно настроить любые действия, например "Уведомления в Telegram", "Создание лида в Битрикс24" и т.д.

 

Настройка действия по отправке данных в MacroCRM

Для передачи данных вам потребуется добавить в MacroCRM строку с названием сайта

Название сайта - это условное название для вашей интеграции. Название сайта может быть любым. Выбирайте его так, чтобы вам было потом понятно, какие заявки будут приходить через эту интеграцию.

Сделать это можно в MacroCRM в разделе "Компания → Интеграции"

Далее для настройки вам понадобится Сайт (Домен) и App_secret (Защищенный ключ).

Подготовка данных для отправки в MacroCRM

Для отправки данных в MacroCRM нужно выполнить несколько простых подготовительных шагов.

Шаг 1. Отформатировать текущую дату в виде нужном MacroCRM

В обработке Webjack добавьте действие "Форматирование даты" со следующими настройками

Шаг 2. Посчитать Хеш MD5

Добавьте действие "Хэш MD5" добавьте в поле "Данные" три значения без пробелов между ними:

- Сайт(Домен)
- Дата
- App_secret

Как показано на рисунке

Шаг 3. Сформировать данные для отправки.

Добавьте действие "Form Urlencoded". И добавьте в него требуемы поля.

Минимально необходимые поля указаны на рисунке:

Перечень полей, которые можно заполнить можно найти в документации MacroCRM по ссылке https://help.macrodigital.ru/manual/integracii/sait_kompanii/integracija_s_saitom.html

Ниже мы перечислим, поля которые уже успешно передавали в интеграциях:

domain - имя сайта, который вы добавили на страницу интеграций
time - время, в формате unix timestamp, мы формировали его в первом действии
token - Хэш MD5, который мы сформировали во 2 действии
action - "buy" - форма подачи заявки на покупку
name - имя клиента
phone - телефон клиента
email - емайл клиента
tags - теги через запятую
message - Комментарий к заявке
utm_source - utm метки
utm_medium - utm метки
utm_campaign - utm метки
 

Отправка данных в MacroCRM

Теперь осталось только отправить сформированные данные в MacroCRM. Для этого добавьте действие "HTTP-запрос" со следующими настройками:

Метод: POST
Адрес: 
https://api.macroserver.kz/estate/request/ - если ваша MacroCRM находиться в Казахстане
https://api.macroserver.ru/estate/request/ - если ваша MacroCRM находится в России
Тело: В это поле передаем данные сформированные в предыдущем действии.
Заголовок:
Content-Type: application/x-www-form-urlencoded

Если все настройки сделаны правильно, то после поступлении лида в источник, данные будут автоматически переданы в MacroCRM

Запустите обработку

Нажмите на кнопку "Запустить"

С этого момента данные будут обрабатываться.

Как все будет работать?

  1. В обработку будут поступать данные из настроенного вами "Источника данных"
  2. Поочередно будут выполняться все действия, которые вы настроили
  3. Все поступающие в обработку данные, а также статус и история их обработки будут отражаться в "Истории операций"

В случае возникновения каких-либо ошибок в процессе обработки, вы получите письмо-уведомление на email.

Если вы обнаружили ошибку или неточность в описании, либо что-то не понятно, напишите нам в чат на сайте. Мы внесем правки.