IPtelefon

Как подключить сервис

Для подключения Iptelefon к Salebot необходимо обратиться к своему менеджеру и запросить у него полный адрес сервера, секретный ключ. Например, server_url = 'https://a00.abc.ru/b3/api/v2/start.php' secret = ‘1ySSeSSSgiS1S1111' Далее в личном кабинете необходимо включить интеграцию "Система" > "Магазин приложений" > "Salebot" и заполнить данные для отправки результата звонка - секретный ключ и url вебхука (см. ниже в разделе настройка вебхуков)

Далее полученные данные вводим в Salebot, вкладка Телефония, окно Iptelefon:

Iptelefon подключен! Но для успешной работы с телефонией требуется настройка под сотрудников и групповые звонки. Всю необходимую информацию для этого можно запросить у своего менеджера. Для совершения обратных звонков понадобится короткий номер сотрудника, например, ‘346’, а для совершения звонков группе понадобится указание номера группы, например, ‘3’

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

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

Последовательность сопоставления данных о клиенте: 1. Осуществляется поиск клиента Телефонии. Если клиент не найден, то происходит поиск по значениям всех переменных по всему списку клиентов проекта. Первая найденная запись о клиенте считается тем самым "искомым" клиентом. 2.Если клиент не найден среди клиентов Телефонии и: * Если к проекту подключен любой мессенджер, например, Whatsapp, то будет создан клиент Whatsapp с данным номером телефона. * Если к проекту не подключены иные виды мессенджеров (Whatsapp, Viber, Instagram и т.д.), то будет создан клиент Телефонии. Такому клиенту Вы сможете совершать только звонки с получением информации о них. Написать такому клиенту возможности нет.

Функция Salebot заказ обратного звонка

Для того чтобы совершить звонок сотруднику из бота, необходимо использовать функцию iptelefon_employee_call(client_phone, short_employee_phone) , которая принимает на вход следующие параметры: client_phone - номер клиента, которому должен быть совершен звонок, строка, пример - '79004443322'. short_employee_phone - короткий номер сотрудника в системе Iptelefon, строка, пример - ‘346’

Пример использования функции:

Функция звонок группе в Salebot

Для того чтобы совершить звонок сотруднику из бота, необходимо использовать функцию iptelefon_group_call(client_phone, group_id), которая принимает на вход следующие параметры: client_phone - номер клиента, которому должен быть совершен звонок, строка, пример - '79004443322'. group_id - идентификатор группы в системе Iptelefon, строка, например, ‘3’

Пример использования функции:

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

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

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

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

  • Звонки через приложение - при нажатии на иконку телефона звонок будет перенаправлен в приложение, установленное для звонков на Вашем устройстве (Zopier и тд).

  • Звонки по API Iptelefon - при клике на иконку телефона АТС звонок поступит сначала сотруднику, чей id вы указали в карточке, а затем перенаправляет звонок клиенту.

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

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

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

Для того, чтобы настроить получение колбеков о завершении звонка, необходимо обратиться к менеджеру Iptelefon и попросить его прописать адрес для получения вебхуков по типу: https://chatter.salebot.pro/iptelefon_webhook/<секретный-ключ>, например, https://chatter.salebot.pro/iptelefon_webhook/1ySSeSSSgiS1S1111

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

При подключении функции получение записи разговора в переменные проекта добавится параметр iptelefon_call_record_link, в которой будет записана ссылка на запись разговора.

Last updated