---
metadata:
  - name: generator
    content: Diplodoc Platform v5.63.4
style:
  - _style/main.css
vcsPath: integrations/telphin.md
alternate:
  - href: https://help.curs24.online/integrations/telphin.md
    type: text/markdown
    title: Markdown version
  - href: https://help.curs24.online/llms.txt
    rel: describedby
---
# Телфин — виртуальная АТС

**Телфин** — виртуальная АТС, которая позволяет принимать и совершать звонки прямо из CURS24. После подключения звонки автоматически отображаются в карточках клиентов и лидов, при входящем звонке система может перевести его на ответственного менеджера и показать имя клиента в окне Софтфона.

{% note warning %}

Интеграция доступна на тарифе **«Бизнес»**. Сама услуга виртуальной АТС оплачивается напрямую сервису **Телфин**.

{% endnote %}

## Возможности интеграции

### История звонков в карточках клиентов и лидов

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

![история звонков в карточке клиента](../_assets/images/integrations/telphin/customer_calls.png)

### Автоматическое создание лидов из звонков

Если включить эту возможность, при входящем или пропущенном звонке от нового номера в разделе **«Лиды»** автоматически создаётся новый лид. Менеджер сразу видит обращение и может перезвонить.

![автосоздание лида](../_assets/images/integrations/telphin/auto_lead.png)

{% note info %}

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

{% endnote %}

### Маршрутизация на ответственного менеджера

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

![маршрутизация звонка](../_assets/images/integrations/telphin/call_routing.png)

### Имя клиента в Софтфоне

Если номер звонящего есть в базе, в окне Софтфона **Телфин** сразу появится ФИО клиента. Сотруднику не нужно открывать CURS24, чтобы понять, кто звонит.

![имя в софтфоне](../_assets/images/integrations/telphin/softphone_caller.png)

## Подключение интеграции

### Шаг 1. Регистрация приложения в Телфин

1. Откройте страницу [apiproxy.telphin.ru/app](https://apiproxy.telphin.ru/app) и войдите под вашей учётной записью **Телфин**.
2. Нажмите кнопку **«Создать приложение»** (**«Register App»**).
3. В поле **«Application Name»** укажите произвольное имя — например, `CURS24`.
4. В поле **«Application Type»** выберите **«Trusted»**.
5. Сохраните приложение и скопируйте значения **«App ID»** и **«App Secret»** — они понадобятся на следующем шаге.

![создание приложения в телфин](../_assets/images/integrations/telphin/create_app.png)

{% note warning %}

**App Secret** показывается один раз. Сохраните его сразу в надёжном месте — повторно посмотреть его в кабинете **Телфин** не получится.

{% endnote %}

### Шаг 2. Активация интеграции в CURS24

Зайдите в CURS24 под учётной записью с ролью **«Собственник»**.

1. Откройте раздел **«Настройки»**.
2. Перейдите на вкладку **«Интеграции»**.
3. Найдите карточку **«Виртуальная АТС Телфин»** и нажмите кнопку **«Подключить»**.
4. В поле **«App ID»** вставьте скопированное значение.
5. В поле **«App Secret»** вставьте скопированное значение.
6. Нажмите кнопку **«Сохранить»**.

![подключение телфин в curs24](../_assets/images/integrations/telphin/enable_telphin.png)

После сохранения звонки из **Телфин** начнут отображаться в карточках клиентов и лидов.

{% note warning %}

После нажатия **«Сохранить»** окно настроек закроется. Чтобы продолжить настройку (шаги 3 и 4), откройте его снова: **«Настройки» → «Интеграции» → «Виртуальная АТС Телфин»**. Без повторного открытия ключи **«App ID»** и **«App Secret»** ещё не сохранены на сервере, и переход на вкладку **«Сотрудники»** на следующих шагах вернёт ошибку.

{% endnote %}

### Шаг 3. Автоматическое создание лидов (опционально)

Включите эту настройку, если хотите, чтобы система автоматически добавляла лидов от новых клиентов.

1. На вкладке **«Настройка»** включите переключатель **«Автоматически создавать лид при входящем или пропущенном звонке»**.
2. В появившемся поле **«Источник лида»** выберите источник, который будет указан у автоматически созданных лидов — например, **«Входящий звонок»**.
3. Нажмите кнопку **«Сохранить»**.

![автосоздание лидов настройка](../_assets/images/integrations/telphin/auto_lead_settings.png)

{% note tip %}

Если нужного источника нет в списке — добавьте его в справочнике **«Источники клиентов»** и вернитесь к настройке.

{% endnote %}

### Шаг 4. Маршрутизация звонков и отображение ФИО в Софтфоне

Маршрутизация переводит входящий звонок на ответственного менеджера клиента, а отображение ФИО показывает в окне Софтфона имя клиента из базы CURS24. Настройка делается в два этапа: сначала в CURS24, потом в личном кабинете **Телфин**.

**В CURS24:**

1. На вкладке **«Настройка»** включите переключатель **«Включить маршрутизацию входящих звонков на ответственного менеджера»**.
2. Перейдите на вкладку **«Сотрудники»** и в столбце **«Сотрудник в CURS24»** для каждого внутреннего номера выберите соответствующего сотрудника.
3. В карточках клиентов укажите ответственного менеджера — иначе системе будет некого назначать получателем звонка.
4. Вернитесь на вкладку **«Настройка»** и под переключателем маршрутизации нажмите кнопку копирования рядом с полем **«URL для Call Interactive»**. Этот адрес понадобится в кабинете **Телфин**.
5. Нажмите кнопку **«Сохранить»**.

![сопоставление сотрудников](../_assets/images/integrations/telphin/user_mapping.png)

{% note info %}

Сопоставление нужно делать только для **основных** номеров сотрудников. Дополнительные устройства (например, мобильное приложение того же сотрудника) сопоставлять не нужно — система их распознает автоматически.

{% endnote %}

{% note warning %}

Один сотрудник может быть сопоставлен только с одним номером. Если попытаться назначить одного сотрудника на два номера, система покажет ошибку и не даст сохранить.

{% endnote %}

**В Телфин:**

1. Откройте [teleo.telphin.ru/routing_new](https://teleo.telphin.ru/routing_new) и войдите под вашей учётной записью **Телфин**.
2. Откройте схему маршрутизации, которую вы используете для входящих звонков.
3. Добавьте блок **«Интерактивная обработка»**: выберите метод **POST** и вставьте скопированный URL для Call Interactive. Этот блок включает отображение ФИО клиента в Софтфоне.
4. Чтобы система также переводила звонок на ответственного менеджера, после блока **«Интерактивная обработка»** добавьте блок **«Перевод на номер из переменной»** со значением `manager_ext`.
5. Сохраните схему.

![настройка маршрутизации в телфин](../_assets/images/integrations/telphin/telphin_routing.png)

{% note tip %}

Блоки **«Интерактивная обработка»** и **«Перевод на номер из переменной»** можно произвольно комбинировать с меню донабора и другими блоками маршрутизации **Телфин** — нужная логика собирается из них как из конструктора.

{% endnote %}