Предача лідів з Leeloo.AI в AMO crm

1. Вступ

Призначення
Ця інструкція описує повний процес налаштування інтеграції між amoCRM та Leeloo для автоматичної передачі заявок (лідів) разом із контактами.

Що таке інтеграція amoCRM ↔ Leeloo
Інтеграція дозволяє автоматично створювати ліди та контакти в amoCRM на основі заявок, отриманих у Leeloo.

Типові сценарії використання:

Передача заявок з квізів Leeloo в amoCRM
Автоматичне створення ліда у вибраній воронці
Автоматичне створення контакту з номером телефону
Зменшення ручної роботи менеджерів

Після ознайомлення ви зможете:

Створити інтеграцію та токен доступу в amoCRM
Зібрати всі необхідні ID без використання API
Сформувати коректний запит для передачі ліда з контактом

2. Основні терміни

Термін	Пояснення

Термін	Пояснення
amoCRM	CRM-система для роботи з лідами та клієнтами
Leeloo	Платформа для створення квізів і збору заявок
Інтеграція	Звʼязок між Leeloo та amoCRM для передачі даних
Bearer Token	Довгостроковий токен доступу до API amoCRM
pipeline_id	ID воронки продажів
status_id	ID статусу всередині воронки
field_id	ID кастомного поля (наприклад, Телефон)
Лід	Заявка або потенційна угода
Контакт	Клієнт, привʼязаний до ліда

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

Перед початком налаштування переконайтесь, що:

Ви маєте адміністративний доступ до amoCRM
В amoCRM вже створені:
- Воронка продажів
- Статуси воронки
Ви знаєте, в яку воронку мають потрапляти заявки
У вас є доступ до налаштувань Leeloo

Рекомендація: підготуйте документ або таблицю, куди будете записувати всі ID.

4. Покрокова інструкція

Крок 1. Створення токена доступу в amoCRM

Увійдіть в amoCRM під адміністратором
Перейдіть: Налаштування → Інтеграції
Натисніть Створити інтеграцію
Оберіть Приватна інтеграція
Заповніть:
- Назва: Leeloo
- Права доступу:
  - Ліди
  - Контакти
Збережіть інтеграцію

Після збереження система покаже:

Довгостроковий токен (Bearer Token)
ID інтеграції
Секретний ключ

Збережіть ці дані. Bearer Token використовується в Leeloo.

Крок 2. Отримання необхідних ID (без API)

Отримання `pipeline_id`

Перейдіть: Налаштування → Воронки та джерела
Відкрийте потрібну воронку
Подивіться на URL у браузері:
- .../pipeline/5669989
Число в URL — це pipeline_id

Отримання `status_id`

У відкритій воронці натисніть на потрібний статус
У URL побачите:
- .../statuses/50179309
Це і є status_id

Статус обовʼязково має належати цій самій воронці.

Отримання `field_id` для телефону

Перейдіть: Налаштування → Кастомні поля → Контакти
Відкрийте поле Телефон
Запишіть ID поля (відображається в налаштуваннях або URL)

Приклад: field_id = 219445

Доступні типи телефону:

WORK
MOB
HOME
OTHER

Крок 3. Формування запиту для передачі ліда

Endpoint:

POST https://YOUR_SUBDOMAIN.amocrm.ru/api/v4/leads

Headers:

Authorization: Bearer YOUR_LONG_TOKEN
Content-Type: application/json

Body (лід + контакт + телефон):

[
  {
    "name": "Заявка з Leeloo",
    "pipeline_id": 5712484,
    "status_id": 50209147,
    "price": 1,
    "contacts": [
      {
        "first_name": "Viktor",
        "custom_fields_values": [
          {
            "field_id": 219445,
            "values": [
              {
                "value": "+380991234567",
                "enum_code": "WORK"
              }
            ]
          }
        ]
      }
    ]
  }
]

У цьому запиті контакт створюється одразу та автоматично привʼязується до ліда.

5. Супутні інструкції

Назва інструкції	Для чого потрібна

Назва інструкції	Для чого потрібна
Перевірка ліда в amoCRM	Переконатись, що лід і контакт створились
Отримання ID користувачів	Для призначення відповідального менеджера
Робота з кастомними полями	Для передачі email, міст, джерел

6. Часті помилки

Проблема	Причина	Рішення

Проблема	Причина	Рішення
NotSupportedChoice (status_id)	Статус не з цієї воронки	Перевірити відповідність `pipeline_id` і `status_id`
Контакт не створився	Невірний `field_id`	Перевірити ID поля Телефон
Немає номера телефону	Неправильний `enum_code`	Використовувати WORK / MOB
401 Unauthorized	Невірний токен	Перевірити Bearer Token