Втрата заявок через ручне перенесення лідів з сайту в CRM — системна проблема бізнесу, що зростає. Інтеграція Мегаплану з сайтом через API дозволяє автоматично передавати ліди у Мегаплан, створювати угоди та налаштовувати вебхуки. Інтернет-магазин із 500 заявками на день після впровадження інтеграції знизив час обробки з 2 годин до 30 секунд. API інтеграція краща за ручне перенесення у 50 разів за швидкістю — замість годин очікування менеджери отримують лід за секунди. Менеджери витрачають до 30% робочого часу на копіювання даних, а помилки перенесення сягають 10%. Мегаплан — одна з популярних CRM для малого та середнього бізнесу, але без автоматизації ефективність падає. Ми вирішуємо це завдання безпосередньо через REST API та webhooks, прискорюючи обробку лідів у 50 разів та виключаючи людський фактор.
Які дані передаються з сайту в Мегаплан
Для інтеграції Мегаплану з сайтом через API передаються дані лідів, що дозволяє синхронізувати Мегаплан і сайт без затримок. З форми заявки зазвичай передаються ім'я, телефон, email та коментар. Ці поля маппяться на стандартні атрибути угоди та контакту. Можна також передавати кастомні поля — наприклад, UTM-мітки, джерело трафіку, обраний товар. Для інтернет-магазинів корисно передавати склад замовлення, суму та статус оплати. Все це лягає у відповідні поля Мегаплану, а для нестандартних даних використовуються extraFields. Підтримується передача до 50 кастомних полів на угоду.
Як налаштувати API Мегаплану?
Мегаплан надає REST API v3. Авторизація Мегаплану API відбувається через Bearer-токен, який отримують обміном логіна/пароля або через API-ключ у налаштуваннях акаунту. Приклад коду Мегаплану для отримання токена:
$response = Http::post("https://{$this->domain}.megaplan.ru/api/v3/auth/access_token", [
'username' => env('MEGAPLAN_LOGIN'),
'password' => env('MEGAPLAN_PASSWORD'),
'grant_type' => 'password'
]);
$token = $response['access_token'];
$refreshToken = $response['refresh_token'];
// Хранить токен в кеше, обновлять через refresh_tokenТокен живе близько години, тому зберігайте його в Redis та оновлюйте за розкладом. Кожен запит із простроченим токеном поверне 401 Unauthorized. Для безпечного зберігання використовуйте змінні оточення, а не вставляйте логін і пароль у код.
Як створити угоду із заявки?
Створення угоди Мегаплану: коли відвідувач надсилає форму, ми створюємо угоду в потрібній воронці. Ось приклад на Laravel (Laravel Мегаплан інтеграція):
$response = Http::withToken($this->getToken())
->post("https://{$this->domain}.megaplan.ru/api/v3/deal/create", [
'data' => [
'contentType' => 'Deal',
'name' => "Заявка с сайта: {$request->subject}",
'programId' => ['contentType' => 'DealProgram', 'id' => $this->pipelineId],
'responsible' => ['contentType' => 'Employee', 'id' => $this->defaultManagerId],
'contractor' => ['contentType' => 'Client', 'id' => $contactId],
'extraFields' => [
'Cf12345' => $request->message,
],
],
]);
Перед створенням угоди потрібно переконатися, що клієнт вже є в системі. Використовуйте пошук за email або телефоном, щоб уникнути дублів.
Як знайти або створити контакт?
Пошук контакту Мегаплану:
// Поиск существующего контакта
$search = Http::withToken($this->getToken())
->post("https://{$this->domain}.megaplan.ru/api/v3/contractor/list", [
'data' => [
'contentType' => 'ContractorFilter',
'email' => $request->email
]
]);
if ($search['data']['meta']['totalCount'] > 0) {
$contactId = $search['data']['list'][0]['id'];
} else {
// Создать нового
$contact = Http::withToken($this->getToken())
->post("https://{$this->domain}.megaplan.ru/api/v3/client/create", [...]);
$contactId = $contact['data']['id'];
}Такий підхід гарантує, що кожен клієнт буде унікальним, а угоди прив’яжуться до його картки.
Webhooks з Мегаплану
Мегаплан вміє надсилати HTTP-сповіщення при зміні статусів угод. Це дозволяє оновлювати статус заявки на сайті: коли менеджер переводить угоду в «Успішно реалізовано», сайт може показати користувачеві подяку. Webhooks налаштовуються в інтерфейсі Мегаплану — потрібно вказати URL вашого ендпоінта. При отриманні webhook-запиту перевіряйте підпис HMAC, щоб уникнути підробок. Ось приклад обробки Webhook на Laravel:
// В контроллере
public function handleWebhook(Request $request)
{
$signature = $request->header('X-Megaplan-Signature');
$payload = $request->getContent();
if (!hash_equals($this->computeSignature($payload), $signature)) {
abort(401, 'Invalid signature');
}
// Логика обновления статуса заявки
}Рекомендується логувати вхідні webhook-запити для налагодження.
Як інтеграція з Мегапланом прискорює обробку лідів у 50 разів?
| Критерій | Ручне введення | Через API |
|---|---|---|
| Час на лід | 2-5 хвилин | 0.2-0.5 секунди |
| Помилки перенесення | 5-10% | 0% |
| Затримка | Години/дні | Миттєво |
Результат — прискорення обробки лідів у 50 разів, виключення помилок людського фактора. Наприклад, при 1000 лідів на місяць економія на зарплаті менеджерів може сягати 1.5 млн грн на рік.
Наші досягнення
Понад 10 років на ринку веб-розробки, понад 50 успішних інтеграцій з CRM, 100+ реалізованих проектів. Ми гарантуємо стабільну роботу інтеграції та оперативне усунення інцидентів.
Типові помилки інтеграції
| Помилка | Причина | Рішення |
|---|---|---|
| 401 Unauthorized | Прострочений токен | Оновлювати токен через refresh_token |
| 409 Conflict | Дублікат контакту | Перевіряти існування контакту перед створенням |
| 429 Too Many Requests | Перевищення ліміту API | Впровадити чергу запитів та кешування |
При дублікатах контактів завжди перевіряйте існування клієнта перед створенням. Використовуйте індекс за email у своїй базі. Для прискорення пошуку можна кешувати ID контактів у Redis за email. Якщо API відповідає повільно (200–500 мс), всі запити ставте в чергу (через Laravel Queue або RabbitMQ). Для частих даних (довідники, воронки) налаштуйте кешування. Зберігайте кожен запит і відповідь у таблицю crm_logs — це рятує при налагодженні: метод, URL, тіло запиту, код відповіді, тіло відповіді, час виконання.
Що входить в роботу
- Аналіз поточних форм та бізнес-логіки.
- Налаштування API-підключення та отримання токенів.
- Розробка модуля передачі лідів з маппінгом полів.
- Налаштування webhook-сповіщень для зворотного зв’язку.
- Тестування всіх сценаріїв (успіх, помилка, дублі).
- Документація з інтеграції.
- Супровід протягом 30 днів після запуску.
Процес роботи
- Аналітика — розбираємо вашу воронку, джерела лідів, потрібні поля.
- Проектування — погоджуємо схему даних, REST-ендпоінти, обробку помилок.
- Реалізація — пишемо код, налаштовуємо черги, кешування.
- Тестування — перевіряємо всі сценарії, включаючи крайові випадки (порожні поля, спецсимволи).
- Деплой — розміщуємо на бойовому сервері, налаштовуємо моніторинг.
Строки та вартість
Базова інтеграція (ліди + контакти + угоди) займає від 3 до 4 робочих днів. Вартість базової інтеграції стартує від 30 000 грн. Складні проекти з webhooks, кастомними полями та зворотною синхронізацією — до 2 тижнів. Вартість розраховується індивідуально після аналізу ваших завдань. Залиште заявку — ми запропонуємо оптимальне рішення.
Наш досвід: понад 10 років розробки веб-додатків, понад 50 успішних інтеграцій з CRM. Гарантуємо стабільну роботу інтеграції та оперативне усунення інцидентів. Отримайте консультацію інженера — розкажемо, як автоматизувати вашу CRM.
