← На главную

Подключение Телфин

Готовое подключение виртуальной АТС Телфин.Офис к функции «Звонки»: по окончании разговора АТС сообщает об этом dxCAR, dxCAR забирает запись из АТС, и дальше всё как обычно — распознавание, разбор, экран «Звонки». Ничего ставить в АТС не нужно: только приложение API в кабинете Телфина и одна кнопка в dxCAR.

Что нужно

  • Кабинет Телфин.Офис с включённой записью разговоров на внутренних номерах сотрудников (запись и API есть в любом тарифе).
  • Право «Настройки» в dxCAR (карточка «Телфин» на вкладке «Звонки»).

Подключение

  1. В dxCAR откройте Настройки → Звонки, нажмите «Подключить АТС» → Телфин — появится карточка с шагами и полями.
  2. Откройте apiproxy.telphin.ru/app (логин и пароль — от кабинета Телфин.Офис) и нажмите Register App: имя любое (например, dxCAR), Redirect URL пустой, Application Type — trusted, Application Access — All. Выданные App ID и App Secret впишите в поля карточки.
  3. Нажмите «Проверить и подключить» — сохранять заранее не нужно. dxCAR проверит приложение, сверит внутренние номера АТС с сотрудниками и сам подпишет АТС на события звонков: звонит, ответил, закончился — вручную ничего в кабинете Телфина вписывать не нужно. Ответ — шесть строк: принято ли приложение, какие номера совпали с сотрудниками, с каких внутренних номеров можно звонить из dxCAR, есть ли подписки на события, когда было последнее событие о входящем звонке (для карточки клиента) и когда пришло последнее событие от АТС. Затем «Сохранить» внизу страницы.
  4. Убедитесь, что на внутренних номерах включена запись (кабинет Телфина → Внутренние номера → Запись разговоров): без неё АТС сообщает о звонке, но записи нет — такой звонок пропускается с пометкой в журнале приёма.
  5. Внутренние номера сотрудников в dxCAR (карточка сотрудника → «Внутренний номер АТС») — это цифры после звёздочки в номере Телфина: для 000*099 впишите 99. Так звонок привязывается к сотруднику.

«Сервер API» менять не нужно: apiproxy.telphin.ru — основной, altapi.telphin.ru — резервный, если основной недоступен.

Что происходит дальше

  • Запись появляется на экране «Звонки» через минуту-две после конца разговора.
  • Не отправляются: звонки без ответа (занято, сброс, не дозвонились), разговоры короче 5 секунд, внутренние звонки между сотрудниками и звонки на номерах без записи. История до подключения не подтягивается.
  • Кто звонил, кому, во сколько и сколько говорили — АТС сообщает в самом событии, поэтому направление и сотрудник определяются всегда, даже если звонок прошёл через меню или очередь.

Дозвон из dxCAR

Кнопка «Позвонить» у телефона клиента (карточка клиента, заказ-наряд, окно истории звонков) работает через Телфин: АТС сначала звонит на внутренний номер сотрудника, который нажал кнопку, а после ответа набирает клиента. Как пользоваться кнопкой — в статье «Звонки», раздел «Позвонить клиенту из dxCAR».

Что нужно, кроме подключения выше:

  • переключатель «Дозвон из dxCAR» в карточке Телфина (Настройки → Звонки) — включите его. Звонки идут за счёт сервиса, поэтому без него кнопки «Позвонить» нет;
  • внутренний номер в карточке сотрудника (Сотрудники → «Внутренний номер АТС») — цифры после звёздочки, как для записей: для 000*099 впишите 99. Номер должен быть телефоном (не очередью и не голосовым меню) — строка «Дозвон» в ответе «Проверить и подключить» показывает, у кого из сотрудников с правом входа номер нашёлся среди телефонов АТС, а у кого нет и почему;
  • уровень доступа «Call API» у приложения API в кабинете Телфина — по умолчанию он включён. Без звонка его не проверить: если «Позвонить» отвечает «У приложения Телфина нет уровня доступа «Call API»», включите его у приложения.

Клиент видит номер, который в кабинете Телфина задан для исходящих звонков этого внутреннего номера, — dxCAR его не меняет. В АТС уходит только номер, который нужно набрать: ни имени клиента, ни других данных карточки.

Ответ Телфина приходит сразу: «АТС набирает: снимите трубку, затем пойдёт вызов клиенту» или причина отказа словами — например, «Внутреннего номера 105 нет в АТС Телфин или это не телефон» или «АТС Телфин отказала: …» с текстом от Телфина. «Результат неизвестен — проверьте, не звонит ли телефон, прежде чем нажать снова» значит, что Телфин не ответил за 20 секунд или ответил непонятно: команда могла дойти. Если подключено дополнение «Звонки», запись разговора попадает на экран «Звонки», как и записи остальных разговоров.

Карточка клиента при звонке

Пока у сотрудника звонит телефон, в dxCAR всплывает окно с клиентом, который звонит. Как оно выглядит и что в нём — в статье «Звонки», раздел «Карточка клиента при входящем звонке».

В кабинете Телфина ничего настраивать не нужно: «Проверить и подключить» само подписывает АТС на события «звонит», «ответил» и «закончился» — по тому же адресу, что и записи. Если в ответе проверки подписки на dial-in и answer нет, нажмите «Проверить и подключить» ещё раз: недостающие подписки создадутся. Дополнение «Звонки» для карточки не нужно — без него АТС подключается так же, а записи разговоров не принимаются.

Кому всплывает окно:

  • сотруднику, у которого звонит телефон, — по «Внутреннему номеру АТС» в его карточке (цифры после звёздочки, как для записей). Если звонок идёт на группу или очередь, окно получает каждый, у кого звонит; когда один снял трубку, у остальных окно закрывается;
  • сотрудникам с галочкой «Показывать все входящие» — о каждом входящем, как только он зазвонил на любом телефоне.

Окно не всплывает о внутренних звонках между сотрудниками, об исходящих и о звонках, которые начаты кнопкой «Позвонить». Если звонок кончился без ответа — звонящий положил трубку, звонок ушёл на голосовую почту или на мобильный, — окно сменяется на «Пропущенный звонок» у всех, кому звонило; у сотрудников с галочкой «Показывать все входящие» — сразу, если звонящий положил трубку, иначе через 15 секунд после того, как отзвонил последний телефон.

Если звонков нет

  • «Проверить и подключить» в карточке: приложение не принято — перепроверьте App ID / App Secret и что тип приложения trusted; внутренние номера не получены — у приложения уровень доступа Call API, нужен All (создайте приложение заново); номера «без сотрудника» — впишите их в карточки сотрудников (цифры после звёздочки); событий не было — сделайте пробный звонок и проверьте снова.
  • Сменили секрет приёма (кнопка «Сменить» в блоке «Приём и расшифровка») — нажмите «Проверить и подключить» ещё раз: подписки в АТС пересоздадутся с новым ключом.
  • Окно о входящем звонке не всплывает: в ответе «Проверить и подключить» посмотрите строку подписок (нужны все три — hangup, dial-in, answer) и строку о последнем событии входящего звонка; проверьте «Внутренний номер АТС» в карточке сотрудника и что переключатель «Карточка клиента при входящем звонке» на вкладке «Звонки» включён.
  • Журнал приёма (кнопка «Журнал приёма →» в шапке экрана «Звонки»): каждое событие АТС оставляет строку — «неверный ключ в адресе» (подписка со старым секретом — см. выше), «функция … не входит в тариф» (нет ни дополнения «Звонки», ни тарифа «Команда» и выше), «файл записи: …» (АТС не отдала запись — обычно она появляется позже, проверьте запись на номере), «пропущен: …» (короткий, без ответа, внутренний, без записи).
  • Пустой журнал — события не доходят: нажмите «Проверить и подключить» и посмотрите строку про подписку.
  • Без дополнения «Звонки» записи разговоров не принимаются: в журнал приёма попадают только записанные разговоры (строка «запись не принята: «Звонки» не подключены»), и если запись на линиях не включена, журнал пуст — это не поломка. «Проверить» тогда пишет об этом без замечания, а доходят ли события звонков, видно по строке «Карточка клиента при звонке».

Обновлено 1 октября 2026

Не нашли ответ? Напишите нам — ответим в течение рабочего дня.