Як автоматично додавати лідів з Google Таблиць до Grinfi

Цей гайд покаже, як налаштувати інтеграцію Google Sheets з Grinfi, щоб нові ліди автоматично передавались у список при додаванні нового рядка.

🔗 Що вам потрібно

API ключ Grinfi
UUID списку (list_uuid) — у який ви хочете додавати лідів
Таблиця Google Sheets з колонками (наприклад):
- Імʼя
- Прізвище
- LinkedIn ID (або URL)
- Email

📘 Повна документація API доступна тут:

https://api.grinfi.io/

📄 Приклад структури таблиці

Імʼя	Прізвище	LinkedIn ID	Email
John	Doe	john-doe-123456	john.doe@example.com

⚙️ Налаштування Google Apps Script

Відкрийте Google Таблицю
Перейдіть у меню: Розширення → Apps Script

Вставте код нижче (замінивши ВАШ_API_КЛЮЧ і ВАШ_LIST_UUID):

const GRINFI_API_KEY = 'Bearer ВАШ_API_КЛЮЧ';

const LIST_UUID = 'ВАШ_LIST_UUID';

function onEdit(e) {
  const sheet = e.source.getActiveSheet();
  const editedRow = e.range.getRow();
 
  if (editedRow !== sheet.getLastRow()) return;
 
  const row = sheet.getRange(editedRow, 1, 1, 4).getValues()[0];
  const [firstName, lastName, linkedinId, email] = row;
 
  if (!linkedinId) return;
 
  const payload = {
    lead: {
      linkedin_id: linkedinId,
      first_name: firstName,
      last_name: lastName,
      email: email
    },
    list_uuid: LIST_UUID,
    update_if_exists: true,
    move_to_list: true
  };
 
  const options = {
    method: 'POST',
    headers: {
      'Authorization': GRINFI_API_KEY,
      'Content-Type': 'application/json'
    },
    payload: JSON.stringify(payload),
    muteHttpExceptions: true
  };
 
  const url = 'https://leadgen.grinfi.io/leads/api/leads/upsert';
 
  const response = UrlFetchApp.fetch(url, options);
  Logger.log(response.getContentText());
}

🔄 Як це працює

Коли ви додаєте новий рядок до таблиці — скрипт надсилає дані в Grinfi.
Якщо лід уже існує — він оновлюється.
Якщо не існує — створюється і додається до списку.

📌 Примітки

Поле linkedin_id є обовʼязковим.
Ви можете додати інші поля, наприклад position, company_name — достатньо розширити payload.lead.

❓ Маєте питання?

Перегляньте документацію API Grinfi або зверніться до нашої технічної підтримки.