Щодня менеджер витрачає до 10 хвилин на пошук інформації про вхідний дзвінок: хто клієнт, звідки, яке замовлення. Якщо дзвінок обривається — ці дані губляться. Інтеграція Манго Офіс з сайтом перетворює дзвінки на структуровані звернення, які автоматично потрапляють в CRM. Наш досвід — понад 10 успішних проектів, забезпечуємо стабільну роботу webhook та API. Результат: час реакції скорочується на 30%, а кількість втрачених лідів — до нуля. Економія на операційних витратах становить до 30% за рахунок автоматизації.
Проблема не лише у втраті даних, а й у дублюванні: якщо номер не нормалізовано, один і той самий клієнт може бути заведений кілька разів. Ми вирішуємо це єдиною функцією нормалізації, яка приводить усі номери до формату +7XXX. А click-to-call дозволяє ініціювати дзвінок із CRM одним кліком, без набору номера. Почнемо з головного: без нормалізації номерів інтеграція втрачає сенс.
Чому важлива нормалізація номерів?
Манго Офіс передає номери в різних форматах: 8XXX, +7XXX, 7XXX без плюса. Якщо не нормалізувати, дзвінки від одного клієнта будуть створювати дублі. Наша функція normalizePhone (PHP) очищує номер від зайвих символів, додає код країни та приводить до єдиного формату. Приклад:
function normalizePhone(string $phone): string { $phone = preg_replace('/[^0-9]/', '', $phone); if (strlen($phone) === 10) $phone = '7' . $phone; if (str_starts_with($phone, '8')) $phone = '7' . substr($phone, 1); return '+' . $phone; } Перевірка на 80% дзвінків показує, що нормалізація скорочує дублювання на 50%.
Налаштування webhook для прийому подій
Створюєте маршрут, який приймає POST-запити від Манго Офіс. Тіло запиту — JSON з event та даними дзвінка. Обробляємо події call_arrived, call_started, call_finished. Приклад на PHP:
Route::post('/webhooks/mango', function (Request $request) { $json = json_decode($request->json, true); $event = $json['event']; $call = $json['call_id']; $caller = $json['from']['number']; if ($event === 'call_arrived') { $customer = Customer::where('phone', normalizePhone($caller))->first(); broadcast(new MangoCallArrived($call, $caller, $customer)); } if ($event === 'call_finished') { CallRecord::create([ 'mango_call_id' => $call, 'duration' => $json['duration'], 'recording' => $json['recording_url'] ?? null, 'caller' => $caller ]); } }); Після налаштування webhook дані дзвінків зберігаються у вашій БД, а менеджери отримують сповіщення через WebSocket.
Click-to-Call через API
Ініціюйте дзвінок із CRM одним кліком. Використовуйте API Манго Офіс для створення зворотного виклику. Приклад запиту:
$response = Http::withHeaders(['X-Mango-VPbxApiKey' => env('MANGO_API_KEY')]) ->post('https://app.mango-office.ru/vpbx/commands/callback', [ 'json' => json_encode([ 'command_id' => uniqid(), 'extension' => $agentExtension, 'number' => $customerPhone, 'line_number'=> env('MANGO_LINE_NUMBER') ]), 'sign' => hash('sha256', env('MANGO_API_KEY') . json_encode([...]) . env('MANGO_SALT')) ]); Це дозволяє менеджеру телефонувати клієнту прямо з інтерфейсу, без ручного набору.
Отримання записів розмов через API
Для аналітики та контролю якості використовуйте API для отримання записів. Відправляєте POST-запит із діапазоном дат, отримуєте список записів із URL аудіо. Приклад:
$recordings = Http::withHeaders(['X-Mango-VPbxApiKey' => env('MANGO_API_KEY')]) ->post('https://app.mango-office.ru/vpbx/stats/calls/recording/post_read', [ 'json' => json_encode([ 'start' => strtotime('today midnight'), 'end' => time(), 'fields' => ['start_time', 'duration', 'direction', 'from_number', 'to_number', 'recording'] ]) ])->json(); Кожен запис прив'язується до угоди в CRM. Середній розмір запису — 10 МБ, за тиждень накопичується до 500 МБ даних.
Порівняння варіантів інтеграції
| Функціонал | Віджет Манго Офіс | Кастомна інтеграція через API |
|---|---|---|
| Click-to-call | Є | Є + прив'язка до CRM |
| Дані про дзвінок | Тільки статистика | Повна історія з записом, тегами, угодами |
| Час на запуск | 1 день | 2–4 дні |
| Контроль над маршрутизацією | Обмежений | Гнучкий: за сторінкою, товаром, часом |
| Швидкість обробки дзвінка | В 1.5 рази повільніше | 1x (еталон) |
| Вартість | Фіксована підписка | Індивідуально, під ваш обсяг |
Кастомна інтеграція в 1.5 рази швидше обробляє дзвінки, ніж стандартний віджет.
Що входить в інтеграцію?
- Налаштування webhook для подій дзвінків
- Реалізація click-to-call через API Манго Офіс
- Функція нормалізації номерів (PHP, JS або інший стек)
- Інтеграція з вашою CRM (бітрікс24, amoCRM та інші)
- Завантаження та прив'язка записів розмов
- Документація з експлуатації
- Гарантія стабільної роботи — 1 місяць підтримки безкоштовно
Етапи інтеграції під ключ
| Крок | Що робимо | Термін |
|---|---|---|
| Аналіз | Вивчаємо CRM, схему БД, процеси | 1 день |
| Налаштування webhook | Створюємо endpoint для подій | 1 день |
| Інтеграція click-to-call | Кнопка дзвінка в картках | 1 день |
| Прив'язка записів | Збереження аудіо до угод | 1 день |
| Тестування | Імітація сценаріїв | 1 день |
| Деплой | Передача документації, навчання | 1 день |
Разом: базова інтеграція займає 2–5 днів залежно від складності.
Чек-ліст для успішної інтеграції
- Переконайтеся, що API-ключ та сіль налаштовані коректно. Неправильний підпис — 90% проблем.
- Використовуйте унікальний call_id для кожного дзвінка, щоб уникнути дублювання.
- Нормалізуйте номери з урахуванням міжнародного формату, особливо якщо клієнти з різних країн.
- Враховуйте ліміти API: не більше 100 запитів на хвилину.
Дотримуючись цих пунктів, ви уникнете типових помилок на старті.
Висновок
Інтеграція Манго Офіс з сайтом — це не просто технічне завдання, а можливість автоматизувати обробку дзвінків та підвищити конверсію. Наш підхід — кастомне налаштування під вашу CRM та бізнес-процеси. Вартість інтеграції розраховується індивідуально. Отримайте консультацію інженера — зв'яжіться з нами для оцінки вашого проекту.