Zapier

Підключіть Looma до Zapier — і кожен новий лід, який зібрали віджети, запускає ваш Zap: лід може потрапити в Google Таблиці, канал Slack, Telegram-бота, листа чи в будь-який із тисяч сервісів, які підтримує Zapier. Без коду й без копіювання URL.

Звʼязок односторонній: Zapier отримує ліди з Looma і нічого не пише назад.

Що це дає

У застосунку Looma в Zapier є один тригер — New Lead («Новий лід»). Він спрацьовує, коли Looma збирає лід із чату, віджета пошуку, форми віджета, каналу месенджера чи дзвінка. Уже наявні ліди повторно не надсилаються, а зміни ліда (новий статус, коментар) тригер не запускають.

Контакти йдуть у Zapier

Лід містить імʼя, телефон і пошту відвідувача. Коли ви вмикаєте Zap, ці дані передаються в Zapier і далі в усі сервіси вашого Zap'а. Переконайтеся, що це узгоджується з вашою політикою конфіденційності.

Перед початком

• Роль Власник або Адміністратор у Looma: лише вони відкривають «Інтеграції» і створюють API-ключі.
• Тариф із доступом до API. Він є в усіх платних тарифах (Starter, Growth, Business). Без нього Zapier при підключенні покаже «API access is not included in your Looma plan».
• Акаунт Zapier. Безкоштовного достатньо.

Крок 1. Створіть API-ключ

1. Відкрийте Інтеграції → API і натисніть Створити API-ключ.
2. Назвіть його, наприклад «Zapier».
3. Позначте рівно три права: leads:read, sites:read і webhooks:manage.
4. Скопіюйте ключ у вікні створення — його показано лише один раз.

Не залишайте права порожніми

Ключ без прав отримує повний доступ до акаунта. Zapier потрібні лише ці три — дайте тільки їх.

Якщо обмежити ключ окремими сайтами, Zap бачитиме ліди лише цих сайтів.

Крок 2. Підключіть Looma в Zapier

Поки що застосунок Looma доступний за приватним посиланням, а не в публічному каталозі Zapier. Посилання на застосунок Looma в Zapier — на сторінці Інтеграції в Looma, на картці Zapier.

1. Відкрийте посилання й прийміть запрошення в Zapier.
2. Створіть Zap і виберіть застосунок Looma тригером.
3. Виберіть тригер New Lead і натисніть Sign in.
4. Вставте API-ключ. Zapier перевіряє його одразу: хибний ключ, відсутнє право чи тариф без доступу до API буде названо простими словами.

Крок 3. Налаштуйте тригер

• Site (сайт) — необовʼязково. Виберіть сайт, щоб отримувати лише його ліди; порожнє поле дає ліди всіх сайтів, які бачить ключ.
• Zapier покаже приклад ліда з ваших останніх справжніх лідів. Якщо їх іще нема, покаже умовний приклад.
• Звʼяжіть поля з наступним кроком і ввімкніть Zap.

Увімкнення Zap'а створює вебхук у Looma. Його видно в Інтеграції → API → Вебхуки з позначкою Zapier.

Поля ліда

Кожне поле присутнє завжди: коли значення немає, текстові поля порожні, списки порожні, а custom_fields — порожній обʼєкт.

Поле	Що містить
id	Номер ліда (також lead_id, те саме значення)
created_at	Час створення, ISO 8601
status	Статус ліда в Looma
name, phone, email, address	Контакти. Телефон — так, як його ввів відвідувач, без коду країни
lead_text	Що хотів відвідувач
custom_fields	Ваші власні зібрані поля за назвою, яку ви дали їм у Looma
products	Товари ліда (до 20): ID, назва, ціна, валюта, посилання, зображення
products_text	Ті самі товари готовим текстом, по рядку на товар
site_id, site_name, site_domain	Сайт
source	Звідки лід: віджет, Telegram, Viber, Facebook, Instagram…
channel_id, channel_name	Канал месенджера, якщо є
utm_source, utm_medium, utm_campaign, landing_page, referrer	Звідки прийшов відвідувач
lead_url	Посилання на лід у дашборді Looma
session_id, visitor_id	Чат-сесія й відвідувач

products_text зручний, коли наступному кроку потрібна одна текстова комірка; поля товарів — коли треба окремо посилання чи ціни.

Вимкнення й видалення

• Вимкнення Zap'а саме видаляє його вебхук у Looma. Повторне ввімкнення створює новий.
• Видалення Zap'а робить те саме. Якщо Zapier не зміг повідомити Looma, Looma дізнається під час наступного ліда (Zapier відповідає, що хук знято) і видаляє вебхук.

Не видаляйте вебхук руками

Якщо видалити вебхук Zapier у Інтеграції → API → Вебхуки, Zap лишається «увімкненим», але ліди перестають надходити, і ніщо про це не попередить. Вимкніть і знову ввімкніть Zap, щоб створити вебхук заново.

Ліміти

• До 20 вебхуків на акаунт, усіх видів разом. Коли ліміт вичерпано, Zapier скаже про це при вмиканні Zap'а — спершу приберіть непотрібні вебхуки в Looma.
• Вебхук, у якого десять доставок поспіль зазнали невдачі, Looma вимикає; увімкніть його в списку вебхуків або вимкніть і ввімкніть Zap.

Якщо щось не так

Zapier каже, що ключ хибний. Перевірте, що скопійовано весь ключ і що його не відкликано. Відкликання діє з затримкою до 5 хвилин: API ще стільки тримає відкликаний ключ у кеші.

«The API key lacks a required scope». Ключу потрібні leads:read, sites:read і webhooks:manage. Відредагуйте ключ в Інтеграції → API або створіть новий.

«API access is not included in your Looma plan». Оберіть платний тариф у Білінгу.

«Webhook limit reached». Видаліть непотрібні вебхуки в Інтеграції → API → Вебхуки.

Zap увімкнено, а лідів нема. Перевірте, що вебхук із позначкою Zapier ще є в Looma і що сайт Zap'а — той, який збирає ліди.

Список сайтів порожній. Ключу потрібне право sites:read.

У прикладі поле було заповнене, а в живих запусках воно порожнє. Тригер New Lead спрацьовує в момент появи ліда — зазвичай щойно відвідувач залишив перший контакт (наприклад, телефон). Якщо далі в тому самому чаті він додасть пошту чи ще товари, Looma оновить лід, але це оновлення в Zap не надсилається. Приклад у редакторі Zap'а натомість береться з уже доповнених лідів, тож може показувати поля, яких у щойно створеного ліда ще немає. Позначте такі поля необов'язковими в наступному кроці Zap'а або додайте крок Filter (наприклад, «Email exists») там, де дія без них не має сенсу.

Пов'язане

• Ліди — звідки беруться ліди
• Інтеграції — API-ключі й вебхуки
• KeyCRM, SalesDrive і KeepinCRM — прямі підключення до CRM
• Вебхуки — навантаження ліда для власних отримувачів
• Білінг — тарифи та стан підписки