Интеграция телефонии с OkoCRM для облачных АТС
Подключите свою АТС к OkoCRM через виджет OkoStore — и ваши клиенты получат телефонию на уровне штатных интеграций: трубку у номера, звонок из карточки, запись и транскрибацию разговора в ленте, правила по пропущенным. Без кода внутри CRM: вебхуки от OkoCRM и пять эндпоинтов API.
Что получает клиент вашей АТС в OkoCRM
Всё то же, что у штатных интеграций с облачными АТС — без доработок с нашей стороны
Звонок в один клик
Трубка у каждого номера в карточке контакта и компании, выбор исходящей линии по городу клиента, автодействие «Позвонить клиенту» на этапе воронки.
Звонки в ленте клиента
Каждый разговор и пропущенный — в истории контакта, компании и сделки, с направлением, длительностью и ответственным менеджером.
Запись и транскрибация
Присылаете ссылку на запись — OkoCRM скачивает её, показывает плеер в ленте, делает расшифровку и краткое содержание разговора с помощью ИИ.
Уведомление о звонке
Менеджер видит, кто звонит, и открывает карточку клиента прямо из всплывающего уведомления.
Перевод на ответственного
Входящий от знакомого клиента АТС сразу переводит на его менеджера — OkoCRM отвечает на запрос маршрутизации за доли секунды.
Правила по звонкам
Пропущенный — задача менеджеру, незнакомый номер — новый контакт и сделка. Настраивает клиент в стандартных вкладках виджета, вам делать ничего не нужно.
Путь разработчика: что делать и в каком порядке
От регистрации виджета до публикации в OkoStore — десять шагов, каждый с понятным результатом
-
1
Зарегистрируйте виджет
В своём аккаунте OkoCRM откройте «Мои виджеты», создайте виджет в категории «Телефония» и скопируйте его секретный ключ (private_key). Результат: есть ключ для проверки подписи вебхуков.
-
2
Поднимите два адреса на своём сервере
Первый принимает вебхуки installed / settings_updated / uninstalled, второй — команду click_to_call. Оба по https, оба проверяют заголовок Signature по сырому телу запроса и отвечают 2xx сразу. Результат: OkoCRM есть куда стучаться.
-
3
Опишите config.json
Добавьте блок telephony с webhook_url и click_to_call_url и поля настроек, которые заполнит клиент (например, ключ API вашей АТС). script.js может быть пустым модулем. Результат: архив виджета готов к загрузке.
-
4
Опубликуйте личную версию и установите себе
Загрузите версию как personal — без модерации, только для вашего аккаунта. Подключите виджет в магазине и сохраните настройки. Результат: на ваш webhook_url пришёл installed с токеном подключения.
-
5
Сохраните токен и передайте номера
Запомните пару setting_ulid → token и сразу вызовите PUT extensions (внутренние номера сотрудников) и PUT numbers (внешние линии). Результат: в настройках виджета появились вкладки «Сотрудники» и «Звонки» с вашими данными, у номеров в карточках — трубки.
-
6
Свяжите себя с внутренним номером
Во вкладке «Сотрудники» привяжите свой добавочный к своему пользователю — так же потом сделает администратор каждого клиента. Без связки события по этому номеру пропускаются. Результат: можно тестировать звонки.
-
7
Подключите события АТС
На каждый звонок шлите в POST events: call.answered или call.started → call.ended, а если никто не ответил — call.missed. Запись — ссылкой в call.ended или позже в call.recorded. Результат: звонок с плеером в ленте контакта.
-
8
Обработайте звонок из CRM
По команде click_to_call АТС набирает сотрудника, затем клиента, и дальше шлёт обычные call.started → call.ended. При отказе ответьте кодом не 2xx с полем message — менеджер увидит причину. Результат: трубка в карточке звонит.
-
9
По желанию: маршрутизация и статус
Если IVR умеет ждать ответ — спрашивайте POST route перед распределением входящего. Если ключ клиента перестал работать — POST status error, когда починили — ok. Результат: перевод на ответственного и честный статус интеграции у клиента.
-
10
Пройдите чеклист и опубликуйте
Сверьтесь с чеклистом из документации (11 пунктов: подпись, события, запись, дубли, перевыпуск токена, удаление) и загрузите версию как public. Результат: после модерации ваша АТС в категории «Телефония» OkoStore у всех клиентов.
Где что читать в документации
- Как это работает — начало группы «Телефония: АТС-виджеты»: схема подключения, блок telephony в config.json, токен подключения, секретный ключ, базовый адрес API, лимиты, коды ошибок и чеклист перед публикацией (шаги 1–3, 10).
- Запросы от OkoCRM — вебхуки installed / settings_updated / uninstalled и команда click_to_call, проверка подписи на PHP, Node.js и Python (шаги 2, 4, 8).
- Справочники и статус — PUT extensions, PUT numbers, POST status (шаги 5, 9).
- Звонки — POST route и POST events: пять событий, их поля и порядок, требования к записи разговора (шаги 7, 9).
Что понадобится от вашей стороны
- Сервер с публичным https-адресом. На него OkoCRM шлёт четыре вебхука: установка, изменение настроек, удаление и команда «позвонить». Каждый подписан HMAC-SHA256 ключом вашего виджета.
- События звонков в реальном времени. АТС должна уметь сообщать, когда звонок принят, начат, завершён или пропущен. Запись разговора необязательна: если есть — присылайте ссылку сразу или позже отдельным событием.
- Исходящий по команде. По запросу от OkoCRM АТС набирает внутренний номер сотрудника, затем номер клиента.
- По желанию — маршрутизация входящего. Если ваш IVR умеет сделать синхронный запрос перед распределением звонка, OkoCRM подскажет, на кого перевести знакомого клиента.
Отладка без модерации: личный виджет ставится на ваш собственный аккаунт OkoCRM и работает точно так же, как публичный. Когда всё работает — публикуйте в OkoStore, и ваша АТС появится в категории «Телефония» у всех клиентов OkoCRM.
Готовы подключить свою АТС?
Полное описание вебхуков, эндпоинтов и событий с примерами на curl, PHP, Node.js и Python — в разделе «Телефония: АТС-виджеты» документации API.
Открыть документациюВопросы по интеграции — в поддержку OkoCRM с пометкой «АТС-виджет»
