Zadarma
Сервис облачной телефонии позволяет быстро телефонизировать ваш бизнес без лишнего оборудования, проводов и географического присутствия
Как подключить сервис
В некоторых случаях Zadarma не работает. Обязательно проверьте следующее: - Zadarma просит активацию через e-mail - CRM Zadarma должна быть активна
Для подключения Zadarma к Salebot необходимо получить api-ключ и секретный ключ. Для этого следует зайти в настройки -> интеграции и API, и активировать АТС
Пройдите по Всем представленным пунктам, создав удобную для Вас АТС (любые настройки в данном случае опциональны) и сохраните ее. После создания своей АТС в той же вкладке настройки -> интеграции и API - спуститесь вниз страницы и дойдите до пункта “Ключи авторизации” и нажмите “Получить ключи”.
В поле Key Вы найдете zadarma_api_key, а в поле secret Вы найдете zadarma_secret_key. Сохраните их в надежное место, через некоторое время они будут скрыты. Вы всегда можете использовать ранее полученные ключи или перегенерировать их (стоит помнить, что после перегенерации ключей придется заменять их на новые во всех местах, где они использовались)
Далее следует перейти в Salebot во вкладку телефония и ввести полученные данные в окно Zadarma.
Zadarma подключена! Однако для успешной работы с телефонией нам также понадобится информация о сотрудниках и схемах работы.
Для осуществления звонков сотрудниками следует выполнить подключение внутренних номеров Zadarma. Такая настройка осуществляется в «Моя АТС» → «Внутренние номера».
Без подключенного внутреннего номера для сотрудника звонки из Salebot работать не будут!
Внутренние номера, которые могут быть использованы для сотрудников, можно найти в настройках моя АТС -> внутренние номера (например: ‘100’,’101’,’219’):
Если потребуется звонок по сценарию, тогда номер сценария следует искать на вкладке ZCRM -ATC (пункт в меню слева). Номер сценария будет указан рядом с названием (на скриншоте 12)
Как происходит сопоставление клиента
Для работы с телефонией используются номера в формате 71234567890 (должен начинаться с 7( или с иного кода другой страны, например, 375), состоять из 11 и более цифр и не иметь лишних знаков и отступов).
Последовательность сопоставления данных о клиенте: 1. Осуществляется поиск клиента Телефонии. Если клиент не найден, то происходит поиск по значениям всех переменных по всему списку клиентов проекта. Первая найденная запись о клиенте считается тем самым "искомым" клиентом. 2.Если клиент не найден среди клиентов Телефонии и:
если к проекту подключен любой мессенджер, например, Whatsapp, то будет создан клиент Whatsapp с данным номером телефона;
если к проекту не подключены иные виды мессенджеров (Whatsapp, Viber, Instagram и т.д.), то будет создан клиент Телефонии. Такому клиенту Вы сможете совершать только звонки с получением информации о них. Написать такому клиенту возможности нет.
Функция Salebot обратный звонок
Для того чтобы совершить звонок из бота, необходимо использовать функцию zadarma_call(short_number, client_phone), которая принимает на вход следующие параметры:
client_phone - номер клиента, которому должен быть совершен звонок, строка, пример - '79004443322'.
short_number - короткий номер сотрудника в системе, строка, пример - ‘100’. При звонке по сценарию следует поставить номер в формате ‘0-12’, ( где 0 - номер голосового меню, 12 - номер сценария).
Пример реализации функции в боте:
Настройка звонков из карточки клиента
Для настройки возможности осуществлять звонки непосредственно из карточки клиента введите сотрудников в систему Salebot. После регистрации сотрудника зайдите в редактирование его данных.
В позиции “Способ совершения телефонных звонков” выберите звонки по API Sipuni.
Если выбрать пункт Отключить звонки, то этот сотрудник не сможет совершать звонки и иконка телефона возле номеров телефона у него не будет отображаться.
Звонки через приложение - при нажатии на иконку телефона звонок будет перенаправлен в приложение, установленное для звонков на Вашем устройстве (Zopier и тд).
Звонки по API Zadarma - при клике на иконку телефона АТС звонок поступит сначала сотруднику, чей id вы указали в карточке, а затем перенаправляет звонок клиенту.
После выбора способа совершения телефонных звонков в “Звонки по API Zadarma” появится дополнительное поле, в которое следует вписать короткий номер Вашего сотрудника в системе Zadarma.
Для осуществления звонка выбранным методом достаточно в карточке клиента нажать на иконку голубой телефонной трубки рядом с его номером телефона:
Настройка вебхуков
Для того чтобы настроить получение колбэков о завершении звонка, необходимо в системе Zadarma перейти в “Настройки”-”Интеграции и Api”” и проскролить вниз до “Уведомления о звонках в АТС” и “Другие уведомления (webhooks)”.
В полях “Ссылка вашего ресурса” и в том, и в другом поле вставьте ссылку на вебхуки вида: https://chatter.salebot.pro/zadarma_webhook/<апи-ключ>, например, https://chatter.salebot.pro/zadarma_webhook/4aa6***********
Обратите внимание! API-key используется тот, который Вы получили в Zadarma.
При подтверждении всплывет уведомление вида:
В результате при завершении звонков в Salebot будет приходить уведомление следующего вида:
В системе используются следующие статусы: NOTIFY_START -> начало входящего звонка в АТС NOTIFY_INTERNAL -> начало входящего звонка на внутренний номер АТС NOTIFY_ANSWER -> ответ при звонке на внутренний или на внешний номер NOTIFY_END -> конец входящего звонка на внутренний номер АТС NOTIFY_OUT_START -> начало исходящего звонка с АТС NOTIFY_OUT_END -> конец исходящего звонка с АТС
Last updated
