# Подключение телефонии и история звонков

Настройте провайдера, направление входящих лидов и проверяйте результаты звонков.

Источник: https://docs.molekula-platform.ru/communication-telephony
Версия справки: 1.4.0. Проверено: 2026-09-06.

Раздел «Телефония» содержит обзор состояния, провайдеров и историю звонков. Для подключения нужны доступ к кабинету телефонного провайдера и его параметры интеграции. Набор доступных провайдеров определяется настройками вашей установки.

## 1. Добавьте провайдера

Откройте «Телефония» → «Провайдеры» и нажмите «Добавить провайдера». Выберите доступный вариант, задайте название подключения, заполните запрошенные параметры и выберите воронку для входящих лидов.

![Вкладка провайдеров телефонии с подключением «Звонки команды» и кнопкой добавления провайдера.](https://docs.molekula-platform.ru/images/communications/telephony-providers.png 'Название помогает различать подключения, если у команды несколько телефонных аккаунтов.')

Для Novofon форма запрашивает `Secret / access_token`. Для Zadarma предусмотрены API Key и API Secret, если этот провайдер доступен в списке. Используйте значения из своего кабинета и нажмите «Подключить».

![Форма подключения Novofon с названием, защищённым полем Secret и воронкой входящих лидов.](https://docs.molekula-platform.ru/images/communications/connect-telephony.png 'Скриншот показывает поля формы без настоящих ключей.')

## 2. Завершите настройку входящих событий

Если после подключения показан webhook URL, перенесите его в соответствующие настройки уведомлений вашего провайдера. Для Novofon URL с токеном показывается один раз: сохраните его до закрытия окна. Он предоставляет доступ для передачи событий, поэтому не публикуйте его в переписке или скриншотах.

Если URL потерян, используйте предусмотренную ротацию секрета и обновите адрес на стороне провайдера. Старое значение после ротации использовать нельзя. Не заменяйте его произвольным адресом из примера.

## 3. Проверьте настройки

В карточке провайдера доступны проверка соединения, включение и выключение, приоритет, выбор основного подключения и воронка. Уточните эти значения до начала работы команды. Изменение воронки задаёт направление новых входящих лидов и не является массовым переносом существующих карточек.

Проведите контрольный звонок через настроенную телефонию. Если соединение с API проверяется успешно, но события не появляются, отдельно проверьте настройку webhook у провайдера.

## 4. Работайте с историей звонков

Откройте вкладку «Звонки». В таблице показаны время, направление, номера, статус, длительность и провайдер. Кнопка «Обновить» перечитывает историю; при большом числе записей используйте страницы.

![История с демонстрационным входящим звонком, завершённым за три минуты, и колонкой записи.](https://docs.molekula-platform.ru/images/communications/calls.png 'Время, направление и номера помогают найти конкретный разговор. Телефоны на скриншоте учебные.')

Запись доступна только если её предоставил провайдер и CRM получила ссылку. Пустая колонка не означает, что звонок не состоялся. Статус завершения также не всегда означает успешный разговор: учитывайте пропущенные, занятые и неуспешные вызовы.

Если появляется виджет текущего звонка, проверьте определённого собеседника и доступную связанную карточку. По окончании разговора сохраните договорённость в карточке и [поставьте задачу](https://docs.molekula-platform.ru/work-tasks), если нужен повторный контакт. Способ инициирования звонка зависит от подключённой телефонии; описанная таблица служит для просмотра истории.

## Как проверить результат

Провайдер включён, проверка проходит, а контрольный звонок появился в истории с ожидаемыми номерами и направлением. При наличии записи она открывается. Для входящего обращения проверьте связанный лид и выбранную воронку.