Початок роботи

Огляд

API Looma.chat дозволяє програмно отримувати доступ до лідів, чатів, товарів, відвідувачів та іншого. Використовуйте його для побудови CRM-інтеграцій, автоматизації робочих процесів або підключення Looma до наявних інструментів.

Базовий URL

Всі API-запити надсилаються на:

https://api.looma.chat/v1/

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

1. Увійдіть на app.looma.chat
2. Перейдіть до Інтеграції в бічному меню
3. Натисніть Створити API-ключ
4. Вкажіть назву, оберіть права доступу (scopes) та за потреби обмежте до конкретних сайтів
5. Скопіюйте згенерований ключ — він показується лише один раз

Ваш ключ виглядає так: lm_a1b2c3d4e5f6g7h8i9j0k1l2m3n4o5p6q7r8s9t0

Крок 2: Зробіть перший запит

Додайте API-ключ у заголовок Authorization:

curl https://api.looma.chat/v1/leads \
  -H "Authorization: Bearer lm_your_api_key_here"

Крок 3: Прочитайте відповідь

Кожна відповідь має такий формат:

Успіх:

{
  "success": true,
  "data": [ ... ],
  "meta": {
    "total": 128,
    "total_pages": 5,
    "current_page": 1,
    "per_page": 30
  }
}

Помилка:

{
  "success": false,
  "error": {
    "code": "invalid_api_key",
    "message": "Invalid or missing API key"
  }
}

Доступні права (scopes)

При створенні API-ключа ви обираєте, які права він матиме:

Scope	Опис
leads:read	Перегляд лідів
leads:write	Оновлення лідів, додавання коментарів
chats:read	Перегляд чатів та повідомлень
chats:write	Надсилання повідомлень, передача, закриття чатів
products:read	Перегляд каталогу товарів
visitors:read	Перегляд відвідувачів
visitors:write	Оновлення контактної інформації відвідувачів
sites:read	Перегляд сайтів та каналів
balance:read	Перегляд балансу кредитів та використання
webhooks:manage	Створення, оновлення, видалення вебхуків

Обмеження за сайтами

API-ключі можна обмежити конкретними сайтами. Якщо ключ обмежений сайтами [1, 3], він матиме доступ лише до даних цих сайтів — ліди, чати, товари та відвідувачі інших сайтів будуть приховані.

Наступні кроки

• Автентифікація — деталі автентифікації через API-ключ
• Обмеження запитів — ліміти та заголовки
• Помилки — коди помилок та усунення проблем
• Вебхуки — сповіщення про події в реальному часі