# Телфин

<figure><img src="/files/n9Hg6KZ73QMO0cQDk0bs" alt="" width="298"><figcaption></figcaption></figure>

«Телфин» — современный российский поставщик индивидуальных решений для коммуникаций. Среди сервисов «Телфин» — облачная телефония для бизнеса, виртуальная АТС «Телфин.Офис», программный телефон «Телфин.Cофтфон», выгодные тарифы на интернет-телефонию, интеграция с CRM и мессенджерами. \
Компания предоставляет виртуальные номера 75 городов России и 65 стран мира. Собственные резервные каналы гарантируют высочайшую отказоустойчивость сервисов и качественную связь «Телфин» для десятков тысяч абонентов. По данным CNews, «Телфин» входит в ТОР-5 провайдеров IP-телефонии 2023.

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

### Регистрация Телфин&#x20;

Шаг 1: перейдите[ по ссылке](https://apiproxy.telphin.ru/app/register/):&#x20;

<figure><img src="https://lh7-us.googleusercontent.com/docsz/AD_4nXfEQgpjdFVJdfVA6AnmtIbJemgOc3hoObOrzPDlPMOxyHUgveFRi_nGDSWE4OdRaZKah72ffWpv1CDSta2VdnXbwWIXA1IW3Dsetd-QWsTnL6dEzcv1W-nZuAV6Ze-mSU-x16oaGEycrCQiuLlksxNpRsmH?key=3tq9SI-GmWzpCdtkRo6UBw" alt=""><figcaption></figcaption></figure>

Шаг 2. Регистрация

Далее откроется окно регистрации, где необходимо:

1. application name - прописать любое имя;
2. поле redirect URLs НЕ НУЖНО заполнять;
3. &#x20;Application Type - в данном поле обязательно установить Trusted&#x20;
4. Application Access - установить Call API (у службы поддержки потом можно запросить полный доступ)

Шаг 3. Сохранение секретного ключа

После регистрации на сервисе вы автоматически перейдете на следующую страницу, где увидите следующие поля:

1. App ID
2. App Secret:

<figure><img src="https://lh7-us.googleusercontent.com/docsz/AD_4nXcwwOm798j7AADaEY1fCrhee3KKLAEklblkXPNeI7vIMLTqdE4tJnE9SrrcEnwiQSuLNjSLt5yxA27uG0duoi1kDGR4fTqopOBlE_PT4eORGP-BJpIgKaSwAtrdRzirnIkd-DAXOuxRxhXpiaLGcOpkG6o-?key=3tq9SI-GmWzpCdtkRo6UBw" alt=""><figcaption></figcaption></figure>

Эти данные будут использоваться для нашей интеграции: на Salebot мы укажем именно эти два поля в форме подключения.

### Подключение Salebot

На стороне Salebot вам необходимо перейти в раздел "Телефония" для подключения интеграции:

<figure><img src="/files/EpS2R17DcvH5JNpf5PBA" alt="" width="563"><figcaption></figcaption></figure>

После чего найдите необходимую интеграцию Телфин и кликните "Подключить":

<figure><img src="/files/vtx9roRKxIJsxafnkBvx" alt="" width="363"><figcaption></figcaption></figure>

Вам откроется окно с полями ввода тех данных, которые мы ранее сохранили при регистрации на сайте Телфин: App ID и App Secret:

<figure><img src="/files/Gi5b3RX4aPrUix88x1Mb" alt="" width="563"><figcaption></figcaption></figure>

На этом подключение интеграции закончено.&#x20;

## Функции

Доступно две функции: telphin\_employee\_call, telphin\_group\_call

* telphin\_employee\_call(client\_phone, short\_employee\_number) - стандартная функция для интеграций с телефонией - функция обратного вызова;

принимает два параметра:

1. client\_phone - номер телефона клиента;
2. short\_emplotee\_number - внутренний короткий номер

Пример вызова функции:

<figure><img src="/files/uItW2HBy9t4hWmE7TKci" alt=""><figcaption></figcaption></figure>

* telphin\_group\_call(client\_phone, group\_id) - функция звонка группе, отличается она тем, что тут нужно указать не номер группы, а ее идентификатор.&#x20;

Принимает два параметра:

1. client\_phone - телефон клиента;
2. group\_id - идентификатор группы. Вы можете узнать его у службы поддержки, либо самостоятельно через терминал, предоставленный телфином.

Пример вызова функции:

<figure><img src="/files/HU02Ww7vG0IikwLahujg" alt="" width="563"><figcaption></figcaption></figure>

## Настройка webhook\`ов&#x20;

Для настройки вебхуков необходимо перейти в личный кабинет АТС Телфин:

<figure><img src="https://lh7-us.googleusercontent.com/docsz/AD_4nXd6YrJL_cw6PgQr625O4WmazS76yJUdjeMWn57GpuMHqAD6hKDTZXDr4sIYnV53r0Pw9nQ1XQ7piRNsXqUUdt1shzKpebKOCgd76wnVSnCiq08KwWw-C4vIor8LCRZPrDJ_NBm0TSgcYCBksW1EtQJ_abc?key=3tq9SI-GmWzpCdtkRo6UBw" alt=""><figcaption></figcaption></figure>

Для каждого внутреннего номера нужно отдельно настраивать вебхук: для этого кликните по одному из внутренних номеров, и переходите во вкладку события:

<figure><img src="/files/cLlkh0iqOlqnRlrvQmS2" alt=""><figcaption></figcaption></figure>

Нажимаем на кнопку <mark style="background-color:blue;">**+ Добавить**</mark>, после чего появится плашка, где нужно заполнить 3 поля:

1. Тип события: dial-in, dial-out, answer, hangup. Добавляйте их всех по очереди, чтобы получать уведомления от всех событий.
2. Метод: всегда выбираем POST.
3. URL: <mark style="color:green;">**<https://chatter.salebot.pro/telphin\\_webhook/>**</mark><mark style="color:red;">**#{APP\_ID}**</mark> , где:\
   \- зеленым цветом обозначена неизменяемая часть URL;\
   \- красным цветом - часть URL, в которое необходимо вставить значение App ID

{% hint style="info" %}
Где найти App ID, читайте в параграфе "[Регистрация Телфин](#registraciya-telfin)".
{% endhint %}

При добавлении событий 4-х типов, вы увидите следующий результат:

<figure><img src="/files/M3vya0gGaRe5pxtTK45Q" alt=""><figcaption></figcaption></figure>


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.salebot.pro/integration/telefoniya/telfin.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.