Как подключить телефонию к 1С: способы и настройка

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

Единого «встроенного» способа подключения телефонии в типовых конфигурациях 1С нет: интеграция реализуется через внешние сервисы виртуальных АТС, SIP-провайдеров или локальную офисную АТС. Конкретный путь зависит от используемой конфигурации (Управление торговлей, Комплексная автоматизация, 1С:CRM, Управление нашей фирмой), от того, облачная у вас 1С или локальная, и от того, какой оператор телефонии вы выбрали.

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

Определите, какой способ интеграции вам подходит

Прежде чем что-то настраивать, ответьте на три вопроса: где развёрнута 1С (локально или в облаке), какая у вас конфигурация и есть ли уже оператор телефонии. От ответов зависит выбор технического пути.

Первый способ — готовый модуль интеграции от оператора виртуальной АТС. Большинство крупных сервисов телефонии предлагают расширения или внешние обработки под популярные конфигурации 1С. Это самый быстрый вариант: модуль устанавливается без изменения конфигурации, а настройка сводится к вводу API-ключа.

Второй способ — интеграция через универсальные механизмы: HTTP-запросы к API телефонии и вебхуки о событиях звонков. Такой путь выбирают, когда готового модуля нет или нужна нестандартная логика, например особая маршрутизация или запись звонков в собственные документы. Здесь потребуется доработка конфигурации или расширение, разработанное программистом 1С.

Третий способ — подключение через локальную офисную АТС (например, на базе Asterisk) или через софтфон на компьютере пользователя. 1С в этом случае взаимодействует с АТС по её API либо запускает звонок через софтфон по протоколу tel/sip. Вариант подходит компаниям, которые уже используют собственную телефонную инфраструктуру.

Подготовьте 1С и учётные данные оператора

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

Убедитесь, что у пользователей, которые будут звонить из 1С, есть необходимые права. Для модулей интеграции часто требуется роль на использование телефонии и доступ к контрагентам и контактным лицам. В файловой базе проверьте также, что серверу или клиентским компьютерам разрешён исходящий доступ в интернет — модуль обращается к API оператора по HTTPS.

Со стороны оператора телефонии подготовьте: API-ключ или токен доступа, список внутренних номеров сотрудников и их SIP-логины. Сопоставление внутреннего номера оператора с пользователем 1С — ключевой шаг: без него звонки не будут привязываться к ответственным менеджерам.

Подключите телефонию через модуль оператора

Типовая последовательность для готового модуля выглядит так. Скачайте расширение или внешнюю обработку из личного кабинета оператора телефонии — именно оттуда, а не со сторонних сайтов, чтобы исключить подмену файла.

Установите расширение через «Администрирование» → «Печатные формы, отчеты и обработки» → «Расширения» либо подключите внешнюю обработку. Если конфигурация работает в режиме совместимости старой версии, расширение может не установиться — это признак того, что нужно обновить конфигурацию.

Откройте форму настроек модуля и введите API-ключ. Затем заполните таблицу соответствия: для каждого пользователя 1С укажите его внутренний номер у оператора. Включите нужные события: входящий звонок с открытием карточки, исходящий по клику, запись разговора, регистрация пропущенных.

1. 1
   Скачайте модуль интеграции из личного кабинета оператора телефонии
2. 2
   Установите расширение или подключите внешнюю обработку в 1С
3. 3
   Введите API-ключ в настройках модуля
4. 4
   Сопоставьте пользователей 1С с внутренними номерами оператора
5. 5
   Включите события: входящие, исходящие, записи разговоров
6. 6
   Сделайте тестовый звонок и проверьте карточку клиента

Настройте интеграцию через API и вебхуки

Если готового модуля нет, интеграцию строят на двух направлениях обмена. Исходящее: 1С отправляет оператору команду на звонок (обычно HTTP-запрос с номерами абонента и сотрудника), оператор соединяет сначала сотрудника, затем клиента. Входящее: оператор при событии звонка отправляет вебхук на опубликованный HTTP-сервис вашей 1С.

Для приёма вебхуков база должна быть опубликована на веб-сервере с доступом из интернета, а HTTP-сервис — настроен на приём запросов оператора. Обязательно предусмотрите проверку подлинности запросов: секретный токен в заголовке или подпись тела запроса, иначе любой, кто узнает адрес сервиса, сможет создавать в базе фиктивные звонки.

Обработку событий делайте асинхронной: вебхук должен быстро подтвердить приём, а запись звонка, поиск контрагента по номеру и создание документа «Событие» или «Взаимодействие» выполнять в фоновом задании. Иначе при пиковой нагрузке звонки начнут теряться из-за таймаутов.

// Пример: исходящий звонок через API оператора
Запрос = Новый HTTPЗапрос("/api/call");
Запрос.УстановитьТелоИзСтроки("{""from"":""" + ВнутреннийНомер + "",""to"":""" + НомерКлиента + ""}"");
Соединение = Новый HTTPСоединение("api.operator.example", 443,,,,, Новый ЗащищенноеСоединениеOpenSSL);
Ответ = Соединение.ОтправитьДляОбработки(Запрос);

Подключение через локальную АТС или софтфон

При наличии собственной АТС (Asterisk, 3CX и подобных) 1С обычно подключают к её интерфейсу управления: для Asterisk это AMI или ARI, для 3CX — API звонков. Принцип тот же, что и с облачным оператором: 1С инициирует вызов, АТС сообщает о событиях. Разница в том, что всё оборудование находится в вашей сети, и публиковать базу в интернет не требуется.

Самый простой вариант без интеграции — исходящие звонки по клику через софтфон. Номер из карточки клиента передаётся в операционную систему как ссылка вида tel:+7... или sip:..., и установленный на компьютере софтфон начинает вызов. Минус очевиден: входящие звонки и записи разговоров в 1С таким способом не попадают.

При работе с локальной АТС следите за качеством сети: телефония чувствительна к задержкам и потерям пакетов. Если голос «плавает» или звонки обрываются, проблема чаще всего в сетевой инфраструктуре, а не в 1С.

Проверьте результат и устраните типичные ошибки

После настройки выполните контрольный цикл: исходящий звонок из карточки клиента, входящий звонок с номера, сохранённого в базе, и входящий с неизвестного номера. В первом случае звонок должен начаться по клику и зафиксироваться в истории; во втором — открыться карточка звонящего; в третьем — появиться событие с предложением создать нового контакта.

Проверьте, что запись разговора прикрепляется к событию и воспроизводится, а пропущенные звонки регистрируются с датой, номером и ответственным. Если какой-то сценарий не работает, смотрите журнал регистрации 1С и логи на стороне оператора: причина почти всегда видна в сообщениях об ошибках обмена.

Частые причины сбоев: неверно сопоставлены внутренние номера (звонки «падают» не на того менеджера), номер клиента хранится в базе в произвольном формате и не совпадает с форматом оператора, брандмауэр блокирует исходящие HTTPS-запросы, вебхуки приходят на неопубликованную базу. Отдельная группа проблем — права: пользователь видит кнопку звонка, но не может создать событие из-за ограничений роли.

Ограничения и когда нужен программист 1С

Готовые модули покрывают стандартные сценарии: звонок по клику, карточка звонящего, история и записи. Если требуется нестандартная логика — автоматическое создание заказа по звонку, маршрутизация по региону клиента, интеграция с несколькими операторами одновременно — без доработки конфигурации не обойтись.

Облачные сервисы 1С (например, аренда базы у франчайзи или 1С:Фреш) накладывают ограничения: не везде можно установить произвольное расширение или опубликовать HTTP-сервис. Уточните у поставщика облачного сервиса возможности до выбора способа интеграции.

Привлекайте программиста 1С, если нужна разработка HTTP-сервисов, фоновая обработка событий, доработка под нестандартную конфигурацию или безопасная схема аутентификации вебхуков. Самостоятельная настройка безопасна в части установки модуля, ввода ключей и сопоставления пользователей — это не трогает данные и легко откатывается отключением расширения.

Частые вопросы