Интеграция Манго Офис с сайтом: API, webhook, click-to-call за 2–4 дня

Каждый день менеджер тратит до 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 МБ данных.

Сравнение вариантов интеграции

Кастомная интеграция в 1.5 раза быстрее обрабатывает звонки, чем стандартный виджет.

Что входит в интеграцию?

• Настройка webhook для событий звонков
• Реализация click-to-call через API Манго Офис
• Функция нормализации номеров (PHP, JS или другой стек)
• Интеграция с вашей CRM (битрикс24, amoCRM и другие)
• Загрузка и привязка записей разговоров
• Документация по эксплуатации
• Гарантия стабильной работы — 1 месяц поддержки бесплатно

Этапы интеграции под ключ

Итого: базовая интеграция занимает 2–5 дней в зависимости от сложности.

Чек-лист для успешной интеграции

• Убедитесь, что API-ключ и соль настроены корректно. Неверная подпись — 90% проблем.
• Используйте уникальный call_id для каждого звонка, чтобы избежать дублирования.
• Нормализуйте номера с учётом международного формата, особенно если клиенты из разных стран.
• Учитывайте лимиты API: не более 100 запросов в минуту.

Следуя этим пунктам, вы избежите типичных ошибок на старте.

Заключение

Интеграция Манго Офис с сайтом — это не просто техническая задача, а возможность автоматизировать обработку звонков и повысить конверсию. Наш подход — кастомная настройка под вашу CRM и бизнес-процессы. Стоимость интеграции рассчитывается индивидуально. Получите консультацию инженера — свяжитесь с нами для оценки вашего проекта.

Интеграция email рассылок: почему она часто ломается?

Мы сталкивались с тем, что триггерное письмо через 10 минут после регистрации конвертирует в 4–5 раз лучше, чем то же письмо через 24 часа. Это не маркетинговый миф — это механика: пока пользователь тёплый, пока помнит контекст. Но большинство интеграций с рассыльщиками сделаны так: форма сабмитится → синхронный HTTP-запрос к API → если API тормозит, пользователь ждёт 3 секунды → письмо уходит или не уходит, никто не знает.

Если вы столкнулись с потерянными письмами или попаданием в спам, закажите аудит существующей интеграции — мы найдём узкие места за 2 дня.

Провайдеры и их API

Unisender — российский провайдер, популярен в сегменте SMB. REST API, простой. Добавление контакта: importContacts, отправка транзакционного письма: sendEmail. Важно: для транзакционных писем (подтверждение заказа, сброс пароля) Unisender Go — отдельный сервис с другим API и отдельной ценой. Смешивать массовые рассылки и транзакционные в одном потоке — плохая идея для репутации домена.

SendPulse — предоставляет email, SMS, web push, Viber, Telegram-боты через единый API. Для проектов, где нужен омниканал, это удобно. Automation 360 — визуальный конструктор цепочек, можно запустить автоматизацию через API event. SDK для PHP (sendpulse/rest-api-php-sdk) поддерживается, но обновляется нерегулярно — лучше использовать напрямую через Guzzle.

Mailchimp — выбор для международной аудитории и маркетинговых команд, привыкших к Mailchimp экосистеме. Transactional email — через Mandrill (дочерний сервис). Marketing API v3 для управления списками, тегами, кампаниями. Webhook для событий: открытие, клик, отписка, bounce.

SMS. Для России: СМСЦ, МТС Exolve, Devino Telecom, SMS Aero. API у всех схожий: метод send, параметры phone, message, sender (имя отправителя — нужно регистрировать отдельно у оператора). Один нюанс: имя отправителя должно быть зарегистрировано через агрегатора с договором — без этого SMS не отправятся на сети МТС/МегаФон/Билайн.

Как построить интеграцию, чтобы не терять письма?

Разделяем транзакционные и маркетинговые потоки

Транзакционные письма (подтверждение заказа, сброс пароля, статус доставки) — через отдельный домен-отправитель или субдомен tx.example.com. Маркетинговые рассылки — через mail.example.com или news.example.com. Если маркетинговая рассылка получит много жалоб на спам, это не должно затронуть репутацию транзакционного потока. Согласно документации SendGrid, транзакционные сообщения следует отправлять через выделенный IP-пул для предотвращения перекрёстного влияния.

Очередь и retry

Любой вызов к email API — через очередь (Laravel Queue, Bull, Celery). Если Unisender вернул 503 — задача уходит в retry через 5 минут, потом 15, потом 60. После 5 неудачных попыток — в dead letter queue с алертом. Пользователь при этом уже получил свой 200 OK и не знает о проблеме. Благодаря этому подходу bounce rate на проектах снижается до 0.5%.

Пример job для Laravel:

public function handle(): void
{
    try {
        $response = Http::post(config('services.unisender.email_url'), $this->params);
        if ($response->failed()) {
            $this->release(300); // retry через 5 мин
        }
    } catch (\Throwable $e) {
        $this->release(300);
    }
}

Шаблоны

Храним шаблоны в коде (Blade, Twig, React Email), не в интерфейсе провайдера. Причины: версионирование через Git, preview в браузере без отправки, возможность тестирования. Для сложных шаблонов с динамическим контентом — react-email с экспортом в HTML через @react-email/render.

Валидация и согласия

Перед добавлением контакта в список — double opt-in (письмо с подтверждением). Хранить факт подтверждения с timestamp в своей БД. При отписке — синхронно отписываем и у провайдера, и в своей базе. Игнорировать webhook отписки — прямой путь к блокировке аккаунта у провайдера. Все процессы соответствуют ФЗ-152 о персональных данных.

Мониторинг доставляемости

Подключаем webhook от провайдера на события bounce (жёсткий и мягкий), spam_complaint, unsubscribe. Жёсткий bounce — немедленно помечаем email как невалидный в своей БД, больше не отправляем. Мягкий bounce 3 раза подряд — то же самое. Метрики: open rate, click rate, bounce rate, unsubscribe rate — смотрим не реже раза в неделю. Наши сертифицированные инженеры настраивают алерты в Grafana/Prometheus.

Почему важно разделять потоки?

Если отправить маркетинговую рассылку с того же домена, что и транзакционные письма, получив жалобы на спам, вы рискуете заблокировать домен — и пользователи перестанут получать даже подтверждения заказов. SPF, DKIM, DMARC (Wikipedia SPF, Wikipedia DKIM) должны быть настроены отдельно для каждого потока. Мы используем субдомены с разными DNS-записями.

Объём работ по интеграции

• Аудит текущих потоков коммуникации и репутации домена (SPF, DKIM, DMARC)
• Выбор провайдера и схемы: транзакционный vs маркетинговый трафик
• Настройка DNS-записей SPF, DKIM, DMARC (Wikipedia DMARC)
• Разработка шаблонов писем (HTML + динамический контент)
• Интеграция с бэкендом через очереди и API
• Настройка webhook для доставляемости и жалоб
• Документация по эксплуатации и обучение команды
• Гарантия доставляемости и поддержка после запуска

Сроки и стоимость

Стоимость рассчитывается индивидуально после аудита. Мы работаем под ключ: от анализа до мониторинга в продакшене. Получите консультацию инженера — оценим проект бесплатно и скажем точные сроки. Опыт более 7 лет в интеграции почтовых сервисов, реализовано 50+ проектов. Закажите бесплатный аудит текущей интеграции — получите отчёт с рекомендациями.