Telfin, Zadarma: интеграция

Telfin и Zadarma — популярные виртуальные АТС с готовыми коннекторами к Битрикс24 и открытым API. Обе позволяют связать звонки с CRM, но различаются деталями настройки. Разберём, как подключить каждую и какие сценарии заложить.

Telfin и Zadarma: что общего и в чём разница

Обе платформы — облачные виртуальные АТС с виртуальными номерами, IVR, записью разговоров и API. Zadarma известна доступными тарифами и бесплатной АТС, Telfin — акцентом на бизнес-телефонию и качество связи. Для интеграции с CRM важнее не маркетинг, а набор технических возможностей.

Подключение Zadarma

Zadarma предлагает готовую интеграцию с Битрикс24 и REST API. Быстрый путь — приложение из Маркета:

1. Установить приложение Zadarma в Битрикс24.
2. В личном кабинете Zadarma включить интеграцию и указать домен портала.
3. Сопоставить внутренние номера (SIP) сотрудников с пользователями CRM.
4. Настроить сценарии: всплывающая карточка, автолид, запись.

Для своей логики используется API с ключами key и secret; запросы подписываются HMAC-SHA1, подпись передаётся в заголовке Authorization. События о звонках (NOTIFY_START, NOTIFY_INTERNAL, NOTIFY_END, NOTIFY_RECORD) приходят на ваш обработчик.

Подключение Telfin

У Telfin аналогичная схема: коробочное приложение для Битрикс24 плюс API для кастомных сценариев. Порядок настройки через приложение:

1. Установить приложение Telfin из Битрикс24.Маркет.
2. Авторизоваться реквизитами клиентского кабинета Telfin.
3. Связать внутренние номера сотрудников с пользователями Битрикс24.
4. Включить нужные опции обработки входящих и исходящих.

Telfin API работает по OAuth 2.0 (client credentials): приложение получает токен и обращается к методам управления вызовами и статистикой. События о звонках доставляются на настроенный callback-адрес.

Сценарии в CRM

Для обеих АТС набор полезных сценариев одинаков — различается лишь конкретный метод API:

• Всплывающая карточка с историей клиента при входящем.
• Автолид с нового номера и маршрут на ответственного для повторных.
• Обработка пропущенных — задача «перезвонить» с дедлайном.
• Click-to-call из карточки сделки.
• Callback с сайта — соединение посетителя с оператором.

В интернет-магазине на 1С-Битрикс звонок логично связывать с заказом покупателя, чтобы менеджер сразу видел статус оплаты и отгрузки.

Запись разговоров

И Telfin, и Zadarma хранят записи на своей стороне и отдают ссылку по событию или методу статистики. В Битрикс24 запись прикрепляется к звонку через telephony.externalCall.attachRecord.

• Zadarma сообщает о готовности записи событием NOTIFY_RECORD с ссылкой.
• Telfin отдаёт запись через методы статистики после завершения вызова.
• Для долгого архива обе записи стоит выгружать в собственное хранилище.

Типичные ошибки

Проблемы при подключении Telfin и Zadarma повторяют общую картину телефонии, но есть и нюансы:

• Неверная подпись запроса: у Zadarma — ошибка в HMAC-SHA1, у Telfin — просроченный или недостаточный по scope токен.
• Несопоставленные SIP-номера → звонок без ответственного.
• Разные форматы номеров → дубли лидов и «неопознанные» вызовы.
• Синхронная привязка записи → пустая ссылка.
• Игнор исходящих — нужно обрабатывать оба направления.

Как и с любой АТС, обязательно логируйте запросы к API: это единственный надёжный способ разобрать сбой после факта.

Итог

Telfin и Zadarma подключаются к Битрикс схоже: быстрое приложение из Маркета для типовых задач и API для собственной логики. Различия — в способе авторизации (HMAC у Zadarma, OAuth у Telfin) и деталях событий, но принципы одни: единый формат номеров, сопоставление SIP-номеров, корректная привязка записей и обработка пропущенных.

Мы подбираем и настраиваем АТС под задачи отдела продаж, связываем звонки с заказами на сайте 1С-Битрикс и при необходимости достраиваем омниканальный контур с мессенджерами и коллтрекингом.