Новофон
Last updated
Last updated
В некоторых случаях Новофон не работает. Обязательно проверьте следующее:
- Новофон просит активацию через e-mail
- CRM Новофон должна быть активна
Настройка интеграции производится через личный кабинет администратора.
По умолчанию доступ к API запрещен всем. Чтобы можно было делать запросы необходимо открыть доступ. Это можно сделать через личный кабинет администратора в разделе "Настройки -> Правила и настройки безопасности" вкладка "API".
В поле IP/Маска введите “0.0.0.0/0”.
Для подключения Новофон к Salebot в настройках пользователя Администратор нужно включить доступ по ключу. Для этого в разделе Телефония - Пользователи АТС открыть настройки пользователя "Администратор". В настройках пользователя в вкладке API поставьте галку "Использовать ключ API". Также установите параметр “Время жизни” - вечно. В этом разделе понадобятся данные из полей Key и Secret.
После генерации, сохраните Secret в надежное место. Вы всегда можете использовать ранее полученные ключи или перегенерировать их.
Обращаем внимание, что после перегенерации ключей придется заменять их на новые во всех местах, где они использовались.
Далее следует перейти в Salebot во вкладку телефония и ввести полученные данные в окно Zadarma.
Сервис Новофон (ex. Zadarma) подключен.
Однако для успешной работы с телефонией нам также понадобится информация о сотрудниках и схемах работы.
Для осуществления звонков следует подключить виртуальные номера. Такая настройка осуществляется в «Телефония» → «Виртуальные номера». Также в разделе “Пользователи АТС” нужно добавить сотрудников и назначить им номер для исходящих звонков. Назначение номера происходит во вкладке “ВАТС” настроек сотрудника.
Без подключенного номера для сотрудника звонки из Salebot работать не будут!
Кроме виртуального номера, нам также нужен id сотрудника. Найти его можно в адресной строке, находясь на странице сотрудника. В этом примере id это “111111”
Для работы с телефонией используются номера в формате 71234567890 (должен начинаться с 7( или с иного кода другой страны, например, 375), состоять из 11 и более цифр и не иметь лишних знаков и отступов).
Последовательность сопоставления данных о клиенте: 1. Осуществляется поиск клиента Телефонии. Если клиент не найден, то происходит поиск по значениям всех переменных по всему списку клиентов проекта. Первая найденная запись о клиенте считается тем самым "искомым" клиентом. 2.Если клиент не найден среди клиентов Телефонии и:
если к проекту подключен любой мессенджер, например, Whatsapp, то будет создан клиент Whatsapp с данным номером телефона;
если к проекту не подключены иные виды мессенджеров (Whatsapp, Viber, Instagram и т.д.), то будет создан клиент Телефонии. Такому клиенту Вы сможете совершать только звонки с получением информации о них. Написать такому клиенту возможности нет
Для того чтобы совершить звонок из бота, необходимо использовать функцию zadarma_call(client_phone, employee_phone, employee_id), которая принимает на вход следующие параметры:
client_phone - номер клиента, которому должен быть совершен звонок, строка, пример - '79004443322'.
employee_phone - виртуальный номер, с которого будет совершен звонок, строка, пример - “79500000033”.
employee_id - id сотрудника, которому поступит звонок в систему в Новофон.
Пример реализации функции в боте:
Для настройки возможности осуществлять звонки непосредственно из карточки клиента введите сотрудников в систему Salebot. После регистрации сотрудника зайдите в редактирование его данных.
В позиции “Способ совершения телефонных звонков” выберите звонки по API Новофон.
Если выбрать пункт Отключить звонки, то этот сотрудник не сможет совершать звонки и иконка телефона возле номеров телефона у него не будет отображаться.
Звонки через приложение - при нажатии на иконку телефона звонок будет перенаправлен в приложение, установленное для звонков на Вашем устройстве (Zopier и тд).
Звонки по API Zadarma - при клике на иконку телефона АТС звонок поступит сотруднику, чей id вы указали в карточке, а затем клиенту
После выбора способа совершения телефонных звонков в “Звонки по API Zadarma” появятся дополнительные поля, в которые следует вписать виртуальный номер и id вашего сотрудника в системе.
Для осуществления звонка выбранным методом достаточно в карточке клиента нажать на иконку голубой телефонной трубки рядом с его номером телефона:
Для того чтобы настроить получение колбэков о завершении звонка, необходимо в системе Новофон перейти в раздел “Интеграции” - “Уведомления о событиях v1”. Здесь нажимаем “Подключить интеграцию”.
В поле “URL для уведомлений о звонках АТС” вставьте ссылку на вебхуки вида: https://chatter.salebot.pro/zadarma_webhook/<secret-key>, например, https://chatter.salebot.pro/zadarma_webhook/4aa6***********
Обратите внимание! Secret используется тот, который Вы получили в Zadarma.
Также проставляем галочки на события, по которым хотим получать уведомления.
Обращаем внимание!
Обязательно внизу страницы переключаем ползунок “Интеграция активна”
При подтверждении всплывет уведомление вида:
В результате при завершении звонков в Salebot будет приходить уведомление следующего вида:
В системе используются следующие статусы:
NOTIFY_START | NOTIFY_OUT_START -> начало звонка
NOTIFY_END | NOTIFY_OUT_END -> конец звонка
NOTIFY_INTERNAL -> начало входящего звонка на внутренний номер АТС
NOTIFY_ANSWER -> ответ при звонке на внутренний или на внешний номер
OUT в статусе означает, что звонок исходящий из Новофон.
Также если у звонка будет иметься запись разговора, то у клиента будет создана переменная zadarma_record_link, содержащая ссылку на запись.
