Телфин
«Телфин» — современный российский поставщик индивидуальных решений для коммуникаций. Среди сервисов «Телфин» — облачная телефония для бизнеса, виртуальная АТС «Телфин.Офис», программный телефон «Телфин.Cофтфон», выгодные тарифы на интернет-телефонию, интеграция с CRM и мессенджерами. Компания предоставляет виртуальные номера 75 городов России и 65 стран мира. Собственные резервные каналы гарантируют высочайшую отказоустойчивость сервисов и качественную связь «Телфин» для десятков тысяч абонентов. По данным CNews, «Телфин» входит в ТОР-5 провайдеров IP-телефонии 2023.
Подключение
Регистрация Телфин
Шаг 1: перейдите по ссылке:
Шаг 2. Регистрация
Далее откроется окно регистрации, где необходимо:
application name - прописать любое имя;
поле redirect URLs НЕ НУЖНО заполнять;
Application Type - в данном поле обязательно установить Trusted
Application Access - установить Call API (у службы поддержки потом можно запросить полный доступ)
Шаг 3. Сохранение секретного ключа
После регистрации на сервисе вы автоматически перейдете на следующую страницу, где увидите следующие поля:
App ID
App Secret:
Эти данные будут использоваться для нашей интеграции: на Salebot мы укажем именно эти два поля в форме подключения.
Подключение Salebot
На стороне Salebot вам необходимо перейти в раздел "Телефония" для подключения интеграции:
После чего найдите необходимую интеграцию Телфин и кликните "Подключить":
Вам откроется окно с полями ввода тех данных, которые мы ранее сохранили при регистрации на сайте Телфин: App ID и App Secret:
На этом подключение интеграции закончено.
Функции
Доступно две функции: telphin_employee_call, telphin_group_call
telphin_employee_call(client_phone, short_employee_number) - стандартная функция для интеграций с телефонией - функция обратного вызова;
принимает два параметра:
client_phone - номер телефона клиента;
short_emplotee_number - внутренний короткий номер
Пример вызова функции:
telphin_group_call(client_phone, group_id) - функция звонка группе, отличается она тем, что тут нужно указать не номер группы, а ее идентификатор.
Принимает два параметра:
client_phone - телефон клиента;
group_id - идентификатор группы. Вы можете узнать его у службы поддержки, либо самостоятельно через терминал, предоставленный телфином.
Пример вызова функции:
Настройка webhook`ов
Для настройки вебхуков необходимо перейти в личный кабинет АТС Телфин:
Для каждого внутреннего номера нужно отдельно настраивать вебхук: для этого кликните по одному из внутренних номеров, и переходите во вкладку события:
Нажимаем на кнопку + Добавить, после чего появится плашка, где нужно заполнить 3 поля:
Тип события: dial-in, dial-out, answer, hangup. Добавляйте их всех по очереди, чтобы получать уведомления от всех событий.
Метод: всегда выбираем POST.
URL: https://chatter.salebot.pro/telphin_webhook/#{APP_ID} , где: - зеленым цветом обозначена неизменяемая часть URL; - красным цветом - часть URL, в которое необходимо вставить значение App ID
Где найти App ID, читайте в параграфе "Регистрация Телфин".
При добавлении событий 4-х типов, вы увидите следующий результат:
Last updated
