Telfin — российская виртуальная АТС с готовым модулем для RetailCRM. Подключение занимает не больше вечера, если заранее собрать доступы и понимать, что за что отвечает. Разбираем пошаговое подключение и проверку входящих и исходящих звонков.
Что получаете после подключения Telfin
Интеграция Telfin с RetailCRM переносит работу со звонками внутрь CRM. Оператору становятся доступны:
- всплывающая карточка клиента при входящем звонке;
- звонок в один клик из карточки клиента и заказа;
- запись разговоров в истории обращения;
- журнал вызовов для аналитики по операторам и результатам.
Обмен идёт по API: Telfin отправляет события звонков в RetailCRM, а CRM отдаёт команды на исходящие вызовы. Модуль Telfin доступен в Маркетплейсе RetailCRM, отдельная разработка не нужна.
По сути интеграция избавляет менеджера от переключений между софтфоном и CRM. Раньше типичный сценарий выглядел так: звонок в трубке, параллельно поиск клиента в базе, отдельный журнал вызовов в кабинете АТС. После подключения Telfin всё это схлопывается в одно окно — вызов, карточка, заказ и запись находятся на одном экране. Для отдела на несколько операторов это ощутимо экономит время на каждом обращении и снижает число ошибок при вводе данных.
Что подготовить до старта
Соберите доступы с обеих сторон, чтобы не прерывать настройку:
| Сторона | Что нужно |
|---|---|
| Telfin | Доступ в личный кабинет, данные API (client_id/секрет или токен) |
| RetailCRM | Права администратора, доступ к «Интеграциям» |
| Операторы | Внутренние номера (extension) сотрудников в Telfin |
Ключи API создаются в личном кабинете Telfin в разделе интеграций/приложений. Без них CRM не сможет принимать события и инициировать вызовы.
Пошаговое подключение
Порядок настройки в RetailCRM:
- Откройте
Настройки → Интеграции → Маркетплейси установите модуль Telfin. - В настройках модуля впишите данные API из личного кабинета Telfin.
- Скопируйте адрес обработки событий (webhook), который выдаст модуль, и укажите его в личном кабинете Telfin.
- Сопоставьте сотрудников: внутренний номер Telfin — пользователь RetailCRM.
- Включите передачу истории звонков и записей.
Сопоставление операторов — ключевой шаг: именно оно определяет, кому покажется всплывающая карточка и от чьего имени пойдёт исходящий вызов.
Всплывающая карточка и исходящие звонки
При входящем звонке Telfin отправляет в RetailCRM событие telephony/call/event. CRM ищет клиента по номеру и показывает карточку нужному оператору — с именем, заказами и историей. Новый клиент создаётся из карточки в пару кликов.
Исходящий работает по схеме click-to-call: оператор нажимает на номер, RetailCRM даёт Telfin команду, АТС соединяет оператора с клиентом. Для этого оператору нужен рабочий внутренний номер или подключённый софтфон.
Запись разговоров в карточке
Записи разговоров Telfin передаёт в RetailCRM ссылкой, которую видно в истории звонка. Прослушать их можно из карточки клиента или заказа — удобно для контроля качества и разбора спорных ситуаций.
Сами файлы хранятся на стороне Telfin, CRM отдаёт ссылку. Поэтому доступность записей зависит от срока их хранения в тарифе Telfin: если запись давно удалена у провайдера, ссылка в CRM перестанет открываться.
Если записи нужны для регулярного контроля качества, заранее оцените их объём и срок хранения. Активный колл-центр за месяц накапливает тысячи файлов, и на минимальном тарифе они могут вытесняться уже через несколько недель. В таком случае имеет смысл либо расширить хранилище у Telfin, либо выстроить выгрузку важных разговоров во внешнее хранилище. RetailCRM в этой цепочке остаётся точкой доступа: менеджер и руководитель открывают запись из карточки, не заходя в кабинет АТС.
Проверка и частые ошибки
Проверку удобнее делать вдвоём: один сотрудник звонит с внешнего номера, второй наблюдает реакцию CRM. Так сразу видно, появляется ли карточка, у того ли оператора и не задваивается ли клиент. Пройдитесь по короткому чек-листу:
- Входящий звонок — появилась ли карточка у нужного оператора.
- Исходящий из карточки — проходит ли соединение.
- Завершённый вызов — есть ли в истории длительность и запись.
Что ломается чаще всего:
| Симптом | Причина |
|---|---|
| Нет карточки | Оператор не привязан к extension |
| Нет событий вовсе | Не указан или неверный webhook в Telfin |
| Нет исходящих | Нет прав API или рабочего софтфона |
| Нет записей | Запись не включена в тарифе Telfin |
Итог
Подключение Telfin к RetailCRM — это установка модуля из Маркетплейса, ввод API-данных, указание webhook в кабинете Telfin и точное сопоставление операторов с внутренними номерами. После этого работают всплывающая карточка, звонок в один клик и запись разговоров в заказе.
Мы подключаем Telfin к RetailCRM под ключ: настраиваем ключи и webhook, привязываем операторов, проверяем входящие и исходящие на боевых номерах и включаем запись. Если нужна телефония, которая заработает с первого раза, возьмём подключение и поддержку на себя.
Частые вопросы
Где взять данные API для Telfin?
В личном кабинете Telfin в разделе интеграций или приложений создаются данные для API (идентификатор и секрет либо токен). Их вписывают в настройки модуля Telfin в RetailCRM.
Модуль Telfin есть в Маркетплейсе RetailCRM?
Да, готовый модуль телефонии Telfin устанавливается из Маркетплейса RetailCRM. Отдельной разработки для базового подключения он не требует.
Почему не приходят события звонков?
Чаще всего в личном кабинете Telfin не указан или указан неверно адрес webhook, который выдал модуль RetailCRM. Проверьте адрес обработки событий в настройках интеграции Telfin.
Почему всплывающая карточка не показывается?
Обычно оператор не сопоставлен со своим внутренним номером Telfin либо у него закрыта/не авторизована вкладка RetailCRM. Проверьте привязку сотрудников и активность сессии.
Как работает исходящий звонок?
По схеме click-to-call: оператор нажимает на номер в карточке, RetailCRM даёт команду Telfin, и АТС соединяет оператора с клиентом. Оператору нужен рабочий внутренний номер или софтфон.
Почему запись разговора не открывается?
Файлы записей хранятся на стороне Telfin, а CRM показывает лишь ссылку. Если запись удалена по сроку хранения в тарифе Telfin, ссылка перестанет работать.
Нужно ли включать запись отдельно?
Да, на некоторых тарифах Telfin запись разговоров и передача событий по API подключаются отдельно. Уточните это до настройки, иначе модуль встанет без записей и всплывашки.
Поможем с настройкой и поддержкой RetailCRM
Поможем с настройкой, доработкой и поддержкой RetailCRM.