CRMservice интегрируется с облачной АТС — мы принимаем вебхук о входящих/исходящих/завершённых звонках, поднимаем карточку клиента до того как менеджер взял трубку, и сохраняем историю + ссылку на запись в карточку.
Реально подключаются (есть в коде)
| Провайдер | Метод авторизации | Особенности |
|---|---|---|
| MANGO Office | HMAC-SHA256 вебхук | Самый популярный, стабильные вебхук, click-to-call через commands/callback |
| Sipuni | MD5 + form вебхук | Российский, есть бесплатный тариф для маленьких команд |
| UIS | Generic вебхук + SIP | Подходит при коллтрекинге, есть отдельный API для подмены номеров |
| Generic | Кастомный XML/REST | Универсальный адаптер если ваша АТС не из списка но умеет вебхук |
Подключение в CRM
В Настройки → Интеграции → Телефония:
- Выберите провайдера.
- Заполните параметры авторизации (для MANGO — ключ API + API Salt + vpbx; для Sipuni — id + secret).
- Скопируйте URL вебхук из карточки канала.
- В кабинете провайдера пропишите этот URL в настройках вебхук.
- Нажмите Тестовый вызов — CRM проверит что вебхук принимает события.
- MANGO Office —
telephony-mango.
Маппинг сотрудников
В Настройки → Сотрудники для каждого впишите его внутренний номер у провайдера (например 101, 102). Без этого CRM не узнаёт, кто взял трубку.
Что записывается
| Тип события | Что попадает в CRM |
|---|---|
| Входящий звонок | Карточка клиента (если узнан по номеру) или новый лид |
| Ответ | Кто ответил (по внутреннему номеру), время |
| Завершение | Длительность, статус (успешно / занято / неответ) |
| Запись разговора | URL записи в карточке (срок хранения — у провайдера) |
История звонков — раздел Звонки.
Click-to-Call
Из карточки клиента можно нажать на номер → CRM делает запрос в API провайдера → провайдер сначала звонит менеджеру, тот берёт трубку → потом провайдер соединяет с клиентом.
Возможные проблемы
- «Не работает вебхук» — провайдер шлёт на наш URL не из своих IP-белого-списка. У некоторых провайдеров есть allowlist Caddy. Проверьте в логах caddy
docker logs crm-caddy-1. - «Запись разговора пустая» — у провайдера выключена запись по умолчанию или разговор < 5 сек.
- «Карточка не подтянулась» — клиента нет в базе. CRM создаст лид автоматически с номером телефона.
