Інтеграція IP-телефонії Asterisk на сайт

Інтернет-магазин з 50 операторами скоротив витрати на телефонію на 40% після інтеграції Asterisk — економія склала понад сотні тисяч гривень щомісяця. Хмарні АТС (Манго, Zadarma) зручні на старті, але при зростанні бізнесу з'являються приховані платежі, ліміти на одночасні дзвінки та прив'язка до провайдера. Asterisk — відкрита IP-АТС, що працює на вашому сервері. Жодної абонентської плати, повний контроль над маршрутизацією та даними. Ми реалізували понад 50 проектів з інтеграції телефонії.

Як працює інтеграція Asterisk з сайтом?

Зв'язка будується на трьох компонентах: Asterisk Manager Interface (AMI) для подій і команд, WebRTC для дзвінків із браузера та AGI для сценаріїв обробки викликів. Для WebRTC потрібно налаштувати WebSocket-проксі (наприклад, nginx) та сервер STUN/TURN — без цього дзвінки не пройдуть через NAT. Ми використовуємо сучасну архітектуру з бібліотекою PAMI на PHP та ARI (REST інтерфейс) для складної логіки.

Браузер (WebRTC/SIP.js) ←→ Asterisk (Kamailio/nginx + WebSocket)
                                    ↓
                              AMI (Asterisk Manager Interface)
                                    ↓
                              Backend API (PHP/Go/Node)
                                    ↓
                              База даних + Redis (події)

Для масштабування застосовуємо BFF-шар (backend for frontend), який агрегує дані з AMI та ARI. Запис розмов відправляється в S3-сумісне сховище, а метадані — в Elasticsearch для швидкого пошуку.

Чому Asterisk краще за хмарні АТС?

На масштабі 20+ операторів Asterisk дає економію в кілька разів. Ми тестували навантаження до 5000 дзвінків на годину — система тримає стабільно.

Які завдання вирішує інтеграція?

• Click-to-Call — дзвінок із сайту в один клік, без встановлення софтфону.
• Динамічна маршрутизація — перемикання виклику на вільного оператора або в IVR.
• Запис розмов — повне архівування в S3 з можливістю прослуховування з CRM.
• Історія дзвінків — усі події потрапляють до бази даних та Elasticsearch для аналітики.
• WebRTC у браузері — дзвінки напряму, без додаткових застосунків.

Як налаштувати WebRTC для дзвінків із браузера?

Налаштування WebRTC вимагає підняти WebSocket-проксі (nginx з модулем stream) та сервер STUN/TURN. Ми використовуємо coturn як TURN-сервер і налаштовуємо Asterisk з chan_pjsip для WebRTC. У браузері встановлюється SIP.js або JsSIP, які підключаються до Asterisk через WebSocket. Після цього дзвінки йдуть напряму між браузером і АТС, минаючи додаткове ПЗ.

Які етапи включає інтеграція?

Процес інтеграції складається з семи етапів. Перші два — аудит і проєктування — займають до тижня. Потім ми розгортаємо Asterisk, налаштовуємо WebRTC та пишемо демон для AMI.

Ми надаємо повну документацію з API та навчаємо адміністратора (1 година). Також у рамках робіт: налаштування CI/CD для автоматичного деплою демона, написання тестів для AMI-команд, та підготовка моніторингу (Zabbix/Prometheus) для контролю стану Asterisk.

Типові помилки при інтеграції

• Не налаштований STUN/TURN — дзвінки не проходять через NAT.
• AMI доступний без TLS — перехоплення керування.
• Немає supervisor для демона — після збою демон не перезапуститься.
• MixMonitor не архівується — переповнення диска.
• Не обмежені права AMI-користувача — ризик компрометації.

Щоб уникнути цих проблем, замовте інтеграцію у нас — ми передбачаємо їх на етапі проєктування.

Що входить у роботу

• Проєктна документація: схема інтеграції, опис API, розмежування прав.
• Доступи до сервера Asterisk та веб-застосунку.
• Навчання адміністратора (1 година): налаштування маршрутизації, перегляд статистики, додавання номерів.
• Гарантійна підтримка 1 місяць після впровадження: виправлення помилок, консультації.

Строки та вартість

Повна інтеграція займає від 3 до 5 тижнів залежно від складності сценаріїв та поточної інфраструктури. Вартість розраховується індивідуально. Зв'яжіться з нами, щоб обговорити ваш проект та отримати попередню оцінку. Замовте інтеграцію Asterisk — отримайте безкоштовну консультацію інженера.

Інтеграція 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+ проєктів. Замовте безкоштовний аудит поточної інтеграції — отримайте звіт з рекомендаціями.