Телефония/Zadarma
Zadarma — сервис облачной телефонии, который позволяет быстро телефонизировать ваш бизнес без лишнего оборудования, проводов и географического присутствия.
Чтобы начать работу с провайдером, необходимо создать аккаунт или выполнить вход.
Как подключить сервис
- Для подключения Zadarma к Salebot необходимо активировать АТС и получить ключи интеграции.
- Для осуществления звонков сотрудниками следует выполнить подключение внутренних номеров АТС.
Без подключенного внутреннего номера для сотрудника звонки из Salebot работать не будут!
Шаг 1. Создание АТС
Создание АТС и CRM Novofon.
Если АТС еще не создана, её нужно создать при помощи мастера в разделе «Услуги» → «ZCRM» или по ссылке: https://my.zadarma.com/mypbx/master/:
Настройте в соответствии с вашими потребностями.
На втором шаге, можно задать голосовое меню или приветствие:
Если в шаге 1 мастера настройки вы отметили «Создать бесплатную CRM», тогда сервис предложит ввести данные сотрудников. Здесь нужно придумать имя для вашей CRM (subdomain), заполнить другие поля и указать личные или рабочие номера телефонов, и нажать кнопку Создать CRM:
Шаг 2. Настройка АТС
Подключение внутреннего номера сотрудника.
Когда АТС создана, добавляем необходимые внутренние номера сотрудникам в разделе «Моя АТС» → «Внутренние номера» или по ссылке:https://my.zadarma.com/mypbx/, кнопка «Создать внутренний номер АТС»:
Шаг 3. Подключение к Salebot
Чтобы подключить сервис к Salebot понадобятся ключи: Key, Secret.
Переходим в раздел «Настройки» → «Интеграции и API» и на вкладке «Ключи и API» нажимаем кнопку Создать ключи:
На основную почту придет ссылка. После перехода по ней в соответствующих полях на сайте, будут показаны ключи:
В salebot открываем вкладку Телефония и нажимаем Подключить:
Копируем наши ключи в соответствующие поля:
.png)
И, нажимаем Сохранить настройки. На этом подключение завершено.
При успешном подключении вы увидите статус интеграции – Подключено:
Сопоставление клиента
Последовательность сопоставления данных о клиенте:
- Осуществляется поиск клиента Телефонии. Если клиент не найден, то происходит поиск по значениям всех переменных по всему списку клиентов проекта. Первая найденная запись о клиенте считается тем самым "искомым" клиентом.
- Если клиент не найден среди клиентов Телефонии и:
- к проекту подключен любой мессенджер, например, Whatsapp, то будет создан клиент Whatsapp с данным номером телефона.
- к проекту не подключены иные виды мессенджеров (Whatsapp, Viber, Instagram и т.д.), то будет создан клиент Телефонии. Такому клиенту Вы сможете совершать только звонки с получением информации о них. Написать такому клиенту возможности нет.
Функция Salebot обратный звонок
Для работы с телефонией используются номера в формате 71234567890, номер телефона клиента, должен:
- начинаться с 7 или с иного кода другой страны, например, 375,
- состоять из 11 и более цифр,
- не иметь лишних знаков и отступов.
 |
Для приведения номеров к данному формату используется функция normalizePhone()
|
Чтобы совершить звонок из бота, необходимо использовать функцию zadarma_call(short_number, client_phone), которая принимает на вход следующие параметры:
- short_number – короткий номер сотрудника в системе, строка, пример - '100'. При звонке по сценарию следует поставить номер в формате '0-12', ( где 0 - номер голосового меню, 12 - номер сценария).
- client_phone – номер телефона клиента, которому должен быть совершен звонок, строка, пример - '79004443322'.
Код:
zadarma = zadarma_call('100', '79004443322')
Настройка звонков из карточки клиента
Чтобы осуществлять звонки из карточки клиента, необходимо внести сотрудников в систему Salebot во вкладке Сотрудники.
После регистрации сотрудника, зайдите в редактирование его данных:
Редактирование данных сотрудников
Выбор способа совершения телефонных звонков
Выберите способ совершения телефонных звонков:
| Отключить звонки | сотрудник не сможет совершать звонки и иконка телефона возле номеров телефона у него не будет отображаться |
| Звонки через приложение | при нажатии на иконку телефона звонок будет перенаправлен в приложение, установленное для звонков на Вашем устройстве (Zopier или другое) |
| Звонки по API Zadarma(нужно указать короткий номер сотрудника) | при нажатии на иконку телефона звонок поступит сначала сотруднику, а затем происходит дозвон клиенту |
После всех настроек, рядом с номером телефона клиента появится изображение телефонной трубки и можно осуществлять вызов:
Настройка вебхуков
Отправка вебхуков настраивается в системе Zadarma. На стороне salebot никаких действий не требуется.
Строка URL:
https://chatter.salebot.pro/zadarma_webhook/ZadarmaApiKey
Шаг 1
Скопируйте ваш Ключ API в разделе «Настройки» → «Интеграции и API» на вкладке Ключи и API (если ключа нет, нажмите кнопку Создать ключи):
Шаг 2
Перейдите в раздел «Настройки» → «Интеграции и API» и выберите “Уведомления о событиях”:
Включение уведомлений о событиях в Zadarma
Окно Уведомления о событиях
Откроется окно Уведомления о событиях, где нужно указать скопированный Ключ API в формате:
https://chatter.salebot.pro/zadarma_webhook/10ec2c4d855773c62d66
Нажимаем кнопку Добавить, после чего, можно выбрать типы уведомлений, которые будут поступать в Salebot:
В системе используются следующие уведомления:
| Callback | Триггер | |
|---|---|---|
| zadarma_call_event | NOTIFY_START | начало входящего звонка в АТС |
| zadarma_call_event | NOTIFY_INTERNAL | начало входящего звонка на внутренний номер АТС |
| zadarma_call_event | NOTIFY_ANSWER | ответ при звонке на внутренний или на внешний номер |
| zadarma_call_event | NOTIFY_END | конец входящего звонка на внутренний номер АТС |
| zadarma_call_event | NOTIFY_OUT_START | начало исходящего звонка с АТС |
| zadarma_call_event | NOTIFY_OUT_END | конец исходящего звонка с АТС |
| zadarma_call_event | NOTIFY_RECORD | запись разговора доступна для скачивания |
| zadarma_call_event | NOTIFY_IVR | реакция абонента на назначенное действие |