Интеграция Битрикс24 с Sipuni
Sipuni — российский облачный сервис виртуальной АТС, ориентированный на малый и средний бизнес. Особенность Sipuni — акцент на простоте настройки и готовых CRM-интеграциях. Официальный коннектор Sipuni для Битрикс24 входит в маркетплейс и покрывает базовые потребности. Для более сложных сценариев доступен прямой API.
Официальный коннектор Sipuni
Устанавливается из каталога Битрикс24 (Приложения → Маркетплейс → Sipuni). Авторизация через API-ключ Sipuni. После подключения работает:
- Всплывающая карточка при входящем звонке
- Создание лидов при пропущенных звонках
- История звонков в CRM
- Исходящие звонки из карточки CRM
- Прикрепление записей разговоров
Официальный коннектор достаточен для большинства сценариев малого бизнеса. Ограничения появляются при нестандартной маршрутизации или когда несколько порталов Битрикс24 должны работать с одной Sipuni-АТС.
Sipuni API: расширенная интеграция
Sipuni предоставляет REST API и webhooks. Документация доступна по адресу sipuni.com/api.
Авторизация: Sipuni использует API-ключ, передаваемый в заголовке запроса X-Api-Key или как параметр api_key.
Получение событий: в личном кабинете Sipuni (раздел Настройки → Интеграции → Webhooks) настраивается URL для уведомлений. Sipuni поддерживает события:
-
call.incoming— входящий звонок (ещё не отвечен) -
call.answered— оператор ответил -
call.ended— звонок завершён -
call.missed— пропущенный звонок
Маршрутизация в Sipuni и отображение в Битрикс24
Sipuni поддерживает сценарии и схемы маршрутизации. Входящий звонок может проходить через несколько шагов: IVR → очередь → конкретный сотрудник. В webhook Sipuni передаёт поле answered_by — внутренний номер того, кто ответил последним.
Если нужно отслеживать весь путь звонка (прошёл через IVR → был в очереди N секунд → ответил сотрудник X), это реализуется через составные события Sipuni или через дополнительный запрос к API истории звонков после завершения.
Запись звонков в Sipuni
Sipuni хранит записи в облаке. Доступ через API:
GET https://sipuni.com/api/v1/records/{call_id}
X-Api-Key: {api_key}
Sipuni возвращает ссылку на файл или redirect на скачивание. Срок хранения определяется тарифом (обычно 14-30 дней на базовых тарифах). Для долгосрочного хранения — скачивать и сохранять в собственное хранилище при каждом событии call.ended.
Работа с несколькими сотрудниками
При групповом звонке (несколько телефонов звонят одновременно) Sipuni в webhook передаёт answered_by только при ответе одного из сотрудников. Остальные события об отклонённых звонках к другим сотрудникам не приходят — это упрощает обработку по сравнению с некоторыми другими провайдерами.
Кейс: агентство недвижимости, 20 агентов
Агентство использовало Sipuni с закреплёнными номерами за отдельными агентами (у каждого агента — свой городской номер от Sipuni). Клиент звонит напрямую агенту. Требование: каждый звонок должен создаваться в CRM у конкретного агента, а если агент недоступен и звонок переадресован на коллегу — это тоже должно фиксироваться.
Реализация через кастомный webhook-обработчик: таблица {городской номер Sipuni → USER_ID Битрикс24}. При входящем звонке регистрируется звонок у ответственного агента (владельца номера). Если через 15 секунд не ответил — Sipuni переадресует на следующего по цепочке. При событии answered_by с другим номером обработчик обновляет ответственного в звонке.
Дополнительно: анализ пропущенных — если агент не отвечает дольше 3 звонков в день, система создаёт задачу руководителю на разбор ситуации.
Срок настройки: 3-5 рабочих дней.