# Новофон

## Как начать пользоваться

Для работы интеграции у вас должна быть создана учетная запись в сервисе Новофон. Чтобы начать пользоваться услугами сервиса Новофон, нужно пройти следующие шаги:

1\. Зарегистрироваться на сайте Новофон.

2\. Подтвердить контактный мобильный номер РФ.

3\. Подписать договор.

4\. Пополнить счет.

5\. Подключить виртуальный номер.

По умолчанию доступ к API запрещен всем. Чтобы можно было делать запросы необходимо открыть доступ. Это можно сделать через личный кабинет администратора в разделе "Настройки -> Правила и настройки безопасности" вкладка "API".

<div data-with-frame="true"><figure><img src="https://lh7-rt.googleusercontent.com/docsz/AD_4nXdAzDKPvqRVarx9PxQBi8sWfaG9Cyn5jVle11QxfXz5JCmg3WdL786C3dK0Q2ASIOXx8Feof7ApStTKSRCPYltCxSVddYu_dJR6qdcaXmUxRt9RXCbKwgj3qkFZHqyIXg1jZChkqNr2f0ueaS3toQlCBY1P?key=gRO4Wih9euT2ZU7mHveHOA" alt=""><figcaption></figcaption></figure></div>

В поле IP/Маска введите “0.0.0.0/0”.

<div data-with-frame="true"><figure><img src="https://lh7-rt.googleusercontent.com/docsz/AD_4nXc2_8MUkPJRVejiAMlRSXgtHLLj0WlbnwBZhS3IAoAzNsdTFFbWg-9ZpQfVAlOIP768zmlK8-t_IWRLf4kmbjlqMpfx9k04rg8uxH2DMw1DU4wuOmGCuQQBaz567jcFv53qaKOp8W8sntdXXNUSEeL_iy5B?key=gRO4Wih9euT2ZU7mHveHOA" alt=""><figcaption></figcaption></figure></div>

Для подключения Новофон к Salebot в настройках пользователя Администратор нужно включить доступ по ключу. Для этого в разделе Телефония - Пользователи АТС открыть настройки пользователя "Администратор". В настройках пользователя в вкладке API поставьте галку "Использовать ключ API". Также установите  параметр “Время жизни” - вечно. В этом разделе понадобятся данные из полей Key и Secret.

<div data-with-frame="true"><figure><img src="https://lh7-rt.googleusercontent.com/docsz/AD_4nXdkPTSOqmMoz63XhhhGza3dovI1o8MyZNVCeAk9oVxIysx_vf0ZFC1qvTVkmQcp4iFMawJ0SNacTwUP7BLGqKl0oxoPGeaWX10AkJ8b2E_1hMoeI_AKTYJYWgRQnMxRiiFu90jEn12KqNoiF3yGO51XugWm?key=gRO4Wih9euT2ZU7mHveHOA" alt=""><figcaption></figcaption></figure></div>

После генерации, сохраните Secret в надежное место. Вы всегда можете использовать ранее полученные ключи или перегенерировать их.

Обращаем внимание, что после перегенерации ключей придется заменять их на новые во всех местах, где они использовались.

Далее следует перейти в Salebot во вкладку телефония и ввести полученные данные в окно Новофон.

<div data-with-frame="true"><figure><img src="https://4216716816-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-LxKl4rC_EcwBAz40Qn_%2Fuploads%2FqyPc0DuZM5EWKWTFTytz%2F%D0%A1%D0%BD%D0%B8%D0%BC%D0%BE%D0%BA%20%D1%8D%D0%BA%D1%80%D0%B0%D0%BD%D0%B0%202026-03-25%20%D0%B2%2015.25.41.png?alt=media&#x26;token=693ebab8-ed2c-4817-85b3-744c237b15dd" alt="" width="563"><figcaption></figcaption></figure></div>

<div data-with-frame="true"><figure><img src="https://4216716816-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-LxKl4rC_EcwBAz40Qn_%2Fuploads%2FAETDr1psRmGyhEVaVoCh%2F%D0%A1%D0%BD%D0%B8%D0%BC%D0%BE%D0%BA%20%D1%8D%D0%BA%D1%80%D0%B0%D0%BD%D0%B0%202026-03-25%20%D0%B2%2015.27.25.png?alt=media&#x26;token=90ffb38e-dc2b-497c-805f-59fb0bff4c75" alt="" width="563"><figcaption></figcaption></figure></div>

Сервис Новофон подключен.

Однако для успешной работы с телефонией нам также понадобится информация о сотрудниках и схемах работы.

Для осуществления звонков следует подключить виртуальные номера. Такая настройка осуществляется в «Телефония» → «Виртуальные номера». Также в разделе “Пользователи АТС” нужно добавить сотрудников и назначить им номер для исходящих звонков. Назначение номера происходит во вкладке “ВАТС” настроек сотрудника.

{% hint style="info" %}
Без подключенного номера для сотрудника звонки из Salebot работать не будут!
{% endhint %}

<div data-with-frame="true"><figure><img src="https://lh7-rt.googleusercontent.com/docsz/AD_4nXeGXRgkWpMcwwLa-8ZhzBtrCtZjwxqP6C9wBO9OlFOuFkwgv03YuO84djKQsfRXCGx6auM35XezaPbMNU5SN7AHt4TNdE91QZ473pVRyL3T9h6iR-fbXeRBsDhTTZ23TxYSp0jnIFUDM12C4rKcBDokDrY?key=gRO4Wih9euT2ZU7mHveHOA" alt=""><figcaption></figcaption></figure></div>

Кроме виртуального номера, нам также нужен id сотрудника. Найти его можно в адресной строке, находясь на странице сотрудника. В этом примере id это “111111”

<div data-with-frame="true"><figure><img src="https://lh7-rt.googleusercontent.com/docsz/AD_4nXc4OuFdL-Z7x9s7wZL9xOqCJqf4TGkitniDqkf7dtxc3LLssFIMbIBEbdNIfIn4zqyMtR4Jeaj9DRjNQyAX_wHaoEWeNBulGHFhS9TS5e3P9t9-nDn6HgdVddx3hK4Yt2IneCJZoTgV3h0oBHqf4MzhYPuK?key=gRO4Wih9euT2ZU7mHveHOA" alt="" width="563"><figcaption></figcaption></figure></div>

### Как происходит сопоставление клиента

Для работы с телефонией используются номера в формате 71234567890 (должен начинаться с 7( или с иного кода другой страны, например, 375), состоять из 11 и более цифр и не иметь лишних знаков и отступов).

Последовательность сопоставления данных о клиенте: 1. Осуществляется поиск клиента Телефонии. Если клиент не найден, то происходит поиск по значениям всех переменных по всему списку клиентов проекта. Первая найденная запись о клиенте считается тем самым "искомым" клиентом. 2.Если клиент не найден среди клиентов Телефонии и:

* если к проекту подключен любой мессенджер, например, Whatsapp\*, то будет создан клиент Whatsapp\* с данным номером телефона;
* если к проекту не подключены иные виды мессенджеров (Whatsapp\*, Viber, Instagram\* и т.д.), то будет создан клиент Телефонии. Такому клиенту Вы сможете совершать только звонки с получением информации о них. Написать такому клиенту возможности нет

{% hint style="danger" %}
\*Whatsapp, Instagram принадлежат Meta inc., деятельность которой признана в РФ экстремистской и запрещена.
{% endhint %}

### Функция Salebot обратный звонок

Для того чтобы совершить звонок из бота, необходимо использовать функцию novofon\_call(client\_phone, employee\_phone, employee\_id), которая принимает на вход следующие параметры:

* client\_phone - номер клиента, которому должен быть совершен звонок, строка, пример - '79004443322'.
* employee\_phone - виртуальный номер, с которого будет совершен звонок,  строка, пример - “79500000033”.&#x20;
* employee\_id - id сотрудника, которому поступит звонок в систему в Новофон.

Пример реализации функции в боте:

<div data-with-frame="true"><figure><img src="https://4216716816-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-LxKl4rC_EcwBAz40Qn_%2Fuploads%2FFgRXVQXrhY1eBbseBxC7%2F%D0%A1%D0%BD%D0%B8%D0%BC%D0%BE%D0%BA%20%D1%8D%D0%BA%D1%80%D0%B0%D0%BD%D0%B0%202026-03-26%20%D0%B2%2017.36.59.png?alt=media&#x26;token=95ef03ac-b651-49ea-b375-c514d4a96b6c" alt=""><figcaption></figcaption></figure></div>

### Настройка звонков из карточки клиента

Для настройки возможности осуществлять звонки непосредственно из карточки клиента введите сотрудников в систему Salebot. После регистрации сотрудника зайдите в редактирование его данных.

<div data-with-frame="true"><figure><img src="https://lh7-rt.googleusercontent.com/docsz/AD_4nXcfsKj8ZY2aqNDC9KlMfPBP-tMpXiuQ99g81dRQOupI83CGwYm00w7xb1U-tqkZx1yj0ZGp13Kx288dOdNuzw1lC3INfSttUIrOCLzyCD1y2Db_kEVEhKqtKmauurp3wERj7KwMz2BQLjKeF1b5tGefeIEx?key=gRO4Wih9euT2ZU7mHveHOA" alt=""><figcaption></figcaption></figure></div>

В позиции “Способ совершения телефонных звонков” выберите звонки по API Новофон.

* Если выбрать пункт Отключить звонки, то этот сотрудник не сможет совершать звонки и иконка телефона возле номеров телефона у него не будет отображаться.
* Звонки через приложение - при нажатии на иконку телефона звонок будет перенаправлен в приложение, установленное для звонков на Вашем устройстве (Zopier и тд).
* Звонки по API Новофон - при клике на иконку телефона АТС звонок поступит сотруднику, чей id вы указали в карточке, а затем клиенту

После выбора способа совершения телефонных звонков в “Звонки по API Новофон” появятся дополнительные поля, в которые следует вписать виртуальный номер и id вашего сотрудника в системе.

<div data-with-frame="true"><figure><img src="https://4216716816-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-LxKl4rC_EcwBAz40Qn_%2Fuploads%2FFADDh4yQSXZDK3L2JB13%2F%D0%A1%D0%BD%D0%B8%D0%BC%D0%BE%D0%BA%20%D1%8D%D0%BA%D1%80%D0%B0%D0%BD%D0%B0%202026-03-26%20%D0%B2%2017.48.10.png?alt=media&#x26;token=22fafb08-1cf4-4ee8-944a-2bce59e73884" alt="" width="563"><figcaption></figcaption></figure></div>

Для осуществления звонка выбранным методом достаточно в карточке клиента нажать на иконку голубой телефонной трубки рядом с его номером телефона:

<div data-with-frame="true"><figure><img src="https://lh7-rt.googleusercontent.com/docsz/AD_4nXdjWCXnaAvatRtdcwJ8tprGJOfHLFwfNpBRmIZxCw744nQM99BJSMRFliIvi72qJIXf-OgvjCnnJeMrEcIloKoynmyyuaGXVSBcapjDtRkduRJJ5QCAKtM3Z_s16Lf_5Zjj3Xkka7tKicBslOPYFlA5xaM?key=gRO4Wih9euT2ZU7mHveHOA" alt=""><figcaption></figcaption></figure></div>

### Настройка вебхуков

Для того чтобы настроить получение колбэков о завершении звонка, необходимо в системе Новофон перейти в раздел “Интеграции” - “Уведомления о событиях v1”. Здесь нажимаем “Подключить интеграцию”.

<div data-with-frame="true"><figure><img src="https://lh7-rt.googleusercontent.com/docsz/AD_4nXct3WNXZvX7ApKmd3pwgerID1h6WUlXsRk6dobKk8hNJIVZ8vMXs9TIkf6ECAx3tRKaDZ3iBbGVs7kGbORvBYbSIBH5-GR3T4bb0DH-vzqbFYtP-stAVhmYgMs84o28b6ebGw-sbPGqaH4hxsxInnnqZNk?key=gRO4Wih9euT2ZU7mHveHOA" alt=""><figcaption></figcaption></figure></div>

В поле “URL для уведомлений о звонках АТС” вставьте ссылку на вебхуки вида: <https://chatter.salebot.pro/novofon\\_webhook/\\><secret-key>, например,  <https://chatter.salebot.pro/novofon\\_webhook/4aa6\\*\\*\\*\\*\\*\\*\\*\\*\\*\\*\\>\*

Обратите внимание! Secret используется тот, который Вы получили в Новофон.

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

{% hint style="warning" %}
Обращаем внимание!

Обязательно внизу страницы переключаем ползунок “Интеграция активна”
{% endhint %}

<div data-with-frame="true"><figure><img src="https://lh7-rt.googleusercontent.com/docsz/AD_4nXd_X5TeU-tLngdc9ahbFW3ahcgZyyiwbs4_QOle3d3zIzCzMAcC4Jk__5H-fyOYdnOufihFI6ZSMp42NsaNqXrJamBMUBlF3XvdgVFYWWLW53klFwZ6xr_u1uLaPH963gx3j6mRJaBeqzl8UShj55qGVDs?key=gRO4Wih9euT2ZU7mHveHOA" alt="" width="563"><figcaption></figcaption></figure></div>

При подтверждении всплывет уведомление вида:

<div data-with-frame="true"><figure><img src="https://lh7-rt.googleusercontent.com/docsz/AD_4nXcOzz9iF4-4L6y1xWb9802_Sx6WE8_0OoucYQwZTI8B6bJb_7WGmFDyU5nhLG5_8CzFdu3TP366oQRdNrN4Mq-zaShjvLgqXxEKoiAY64hGjLx2j3ECoQpSwFFuvEuY3McQaApVhMhLCs_MaRGqB0rnQ4lr?key=gRO4Wih9euT2ZU7mHveHOA" alt=""><figcaption></figcaption></figure></div>

В результате при завершении звонков в Salebot будет приходить уведомление следующего вида `novofon_call_event EVENT`:

<div data-with-frame="true"><figure><img src="https://4216716816-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-LxKl4rC_EcwBAz40Qn_%2Fuploads%2FRnR452GrtHVs8TaXCBxm%2F%D0%A1%D0%BD%D0%B8%D0%BC%D0%BE%D0%BA%20%D1%8D%D0%BA%D1%80%D0%B0%D0%BD%D0%B0%202026-03-26%20%D0%B2%2017.40.45.png?alt=media&#x26;token=ef051db2-2c9a-4100-885f-fcd7e3539c67" alt="" width="375"><figcaption></figcaption></figure></div>

<div data-with-frame="true"><figure><img src="https://4216716816-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-LxKl4rC_EcwBAz40Qn_%2Fuploads%2F3bBxyj5fmGVyjq3KPSan%2F%D0%A1%D0%BD%D0%B8%D0%BC%D0%BE%D0%BA%20%D1%8D%D0%BA%D1%80%D0%B0%D0%BD%D0%B0%202026-03-26%20%D0%B2%2017.41.38.png?alt=media&#x26;token=03910268-8b60-4ed1-88e3-3ff16f3be404" alt="" width="375"><figcaption></figcaption></figure></div>

<div data-with-frame="true"><figure><img src="https://4216716816-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-LxKl4rC_EcwBAz40Qn_%2Fuploads%2F2cA93aiOvHwotNdg6AwX%2F%D0%A1%D0%BD%D0%B8%D0%BC%D0%BE%D0%BA%20%D1%8D%D0%BA%D1%80%D0%B0%D0%BD%D0%B0%202026-03-26%20%D0%B2%2017.42.21.png?alt=media&#x26;token=d72daba7-2044-4a5d-9286-23f8de1f1a0f" alt="" width="375"><figcaption></figcaption></figure></div>

В системе используются следующие статусы (EVENT):&#x20;

NOTIFY\_START | NOTIFY\_OUT\_START  -> начало звонка&#x20;

NOTIFY\_END | NOTIFY\_OUT\_END -> конец звонка&#x20;

NOTIFY\_INTERNAL -> начало входящего звонка на внутренний номер АТС&#x20;

NOTIFY\_ANSWER -> ответ при звонке на внутренний или на внешний номер&#x20;

Также если у звонка будет иметься запись разговора, то у клиента будет создана переменная `novofon_record_link`, содержащая ссылку на запись

Другие переменные:

* `novofon_call_id`
* `novofon_call_disposition`
* `novofon_call_event`
* `novofon_record_lifetime`.