Интеграция IP-телефонии Zadarma на сайт под ключ

Каждый пятый звонок в российском интернет-магазине с высоким оборотом не доходит до менеджера — клиент сбрасывает после 20 секунд ожидания. Без интеграции телефонии теряются данные о звонящем, невозможно автоматически создать задачу в CRM и оценить процент дожатых лидов. Мы подключаем Zadarma к вашему сайту за 2–5 рабочих дней: настраиваем вебхуки, обратный вызов, WebRTC-звонки, запись разговоров и передачу данных в AmoCRM, Bitrix24 или любую другую систему. Многолетний опыт интеграций телефонии под ключ позволяет сократить пропущенные звонки на 40% и повысить конверсию из звонка в лид на 15%.

Техническая реализация интеграции

Вебхуки уведомлений

Route::post('/webhooks/zadarma', function (Request $request) {
    $data  = $request->except('sign');
    ksort($data);
    $sign  = md5(http_build_query($data) . env('ZADARMA_SECRET'));
    if ($request->sign !== $sign) return response('Invalid sign', 403);

    $event = $data['event'];

    switch ($event) {
        case 'NOTIFY_START':
            $caller = $data['caller_id'];
            $this->handleIncomingCall($caller);
            break;

        case 'NOTIFY_END':
            CallLog::create([
                'zadarma_callid'  => $data['call_id_with_rec'],
                'caller'          => $data['caller_id'],
                'duration'        => $data['duration'],
                'disposition'     => $data['disposition']
            ]);
            break;

        case 'NOTIFY_RECORD':
            $recordingUrl = $data['link'];
            CallLog::where('zadarma_callid', $data['call_id_with_rec'])
                   ->update(['recording_url' => $recordingUrl]);
            break;
    }
});

API для обратного звонка

$params = [
    'from'      => $agentPhone,
    'to'        => $customerPhone,
    'sip_id'    => env('ZADARMA_SIP_ID')
];
ksort($params);
$sign = base64_encode(hash_hmac(
    'sha1',
    env('ZADARMA_KEY') . urldecode(http_build_query($params)) . md5(serialize($params)),
    env('ZADARMA_SECRET')
));

Http::withHeaders([
    'Authorization' => env('ZADARMA_KEY') . ':' . $sign
])->get('https://api.zadarma.com/v1/request/callback/', $params);

WebRTC — звонок из браузера

<script src="https://my.zadarma.com/webphoneApi/v3/js/zadarmawebrtc.js"></script>
<script>
var webrtcPhone = new ZadarmaWebRTC({
    sipId:    '{{ $sipId }}',
    sipPass:  '{{ $sipPassword }}',
    onCallStateChange: function(state, data) {
        console.log('Call state:', state);
    }
});
webrtcPhone.dial('79001234567');
</script>

Получение и хранение записей

$response = Http::get('https://api.zadarma.com/v1/pbx/record/request/', [
    'call_id'    => $zadarmaCallId,
    'pbx_call_id'=> $pbxCallId
]);
$downloadUrl = $response->json()['link'];

Какие проблемы решает интеграция с Zadarma?

Пропущенные звонки — главная потеря для интернет-магазина. Без callback-виджета клиент ждёт ответа и сбрасывает. Мы настраиваем обратный вызов: система сама перезванивает клиенту через 30 секунд, снижая отток на 40%. Отсутствие аналитики — вторая проблема. Без записи разговоров и лога звонков невозможно определить эффективность каналов. После интеграции в базе CallLog появляются caller_id, duration, disposition и ссылка на запись. Ручная передача заявок в CRM замедляет обработку и чревата ошибками — мы автоматизируем создание сделок при каждом звонке. В одном из проектов (интернет-магазин электроники) пропущенные звонки сократились с 25% до 8%, а заказы через телефон выросли на 18% за месяц.

Почему стоит выбрать Zadarma?

Zadarma — международный провайдер с номерами в 100+ странах и гибкой виртуальной АТС. API позволяет реализовать любой сценарий: от виджета до контакт-центра. Стоимость звонков — от 0.5 ₽/мин, а интеграция в 2–3 раза быстрее, чем ручная настройка. Главное преимущество — низкая цена и простота webhook- и REST-интеграции. По сравнению с проводной телефонией, Zadarma экономит до 60% на абонентской плате и междугородных звонках.

Сравнение: наша интеграция vs ручная настройка

Сравнение тарифов Zadarma для бизнеса

Типичные ошибки при самостоятельной интеграции

• Неверная подпись вебхуков. Без ksort и MD5 с секретным ключом Zadarma вернёт 403. Проверяйте сортировку и http_build_query.
• Отсутствие обработки NOTIFY_END. Без этого события лог звонка останется пустым — не получите caller_id, duration и статус.
• Проблемы с кодировкой. Для REST API используйте urlencode с PHP_QUERY_RFC3986, иначе подпись не совпадёт.
• Игнорирование ошибок API. Всегда проверяйте $response->json()['status'] — не все запросы возвращают success.

Этапы работы по интеграции

1. Аналитика — изучаем текущую схему телефонии, нагрузку и потребности в CRM.
2. Проектирование — выбираем сценарии: callback, WebRTC, запись, интеграция.
3. Реализация — пишем код, настраиваем вебхуки и API, интегрируем с CRM.
4. Тестирование — проверяем все сценарии: входящие, исходящие, запись, передачу в CRM.
5. Деплой — разворачиваем на боевом сервере, обучаем сотрудников.

Что вы получаете в результате

• Документация по интеграции с описанием эндпоинтов.
• Доступ к панели управления и логам.
• Обучение сотрудников работе с системой.
• Поддержка 2 месяца после запуска.
• Гарантия корректной работы всех сценариев.

Оценим ваш проект. Свяжитесь с нами — напишем план интеграции. Работаем под ключ за 2–5 дней. Закажите консультацию и получите анализ текущей телефонной схемы.

По данным документации Zadarma, uptime сервиса составляет 99.9%. Для работы через WebRTC требуется современный браузер.

Интеграция 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+ проектов. Закажите бесплатный аудит текущей интеграции — получите отчёт с рекомендациями.