# Zvonobot ## Как подключить сервис Для подключения Zvonobot к Salebot необходимо получить api-ключ. Для этого следует зайти в личный кабинет -> профиль. Внизу вы найдете кнопку **сгенерировать Api-ключ**.

Сохраните его в надежное место. Вы всегда можете использовать ранее полученный ключ или перегенерировать его {% hint style="warning" %} Стоит помнить, что после перегенерации ключа придется поменять его на новые во всех местах, где он использовался. {% endhint %} Далее следует перейти в Salebot во вкладку телефония и ввести полученные данные в форму подключения Zvonobot.

Zvonobot подключен! Далее для успешной работы с телефонией нам понадобится номер сотрудника и идентификатор аудиозаписи, которая будет использоваться в рассылках. Для добавления номера следует зайти в **Другое-Номера телефонов** и установить номер, с которого будут рассылаться сообщения. Номеров может быть несколько, и они могут быть прикреплены ко всем вашим сотрудникам. Можете использовать системные номера сервиса либо добавить личный номер, чтобы абонентам приходили звонки с него. Если вы арендуете системный номер, то все, кто перезвонит по этому номеру, услышат ваш голосовой ролик.

Для того чтобы добавить аудиозапись, следует пройти в меню аудиоролики и нажать создать видеоролик. Вам будут доступны несколько вариантов создания: загрузить аудиозапись заранее, надиктовать ее или же прописать текстом - после чего робот прочтет ее за вас. На выбор есть мужской и женский голос прочтения.

После того как вы добавите ролик, его необходимо послать на модерацию. {% hint style="info" %} Перед использованием Ваш аудиоролик должен быть обработан модератором. **Требования:** Длительность ролика не менее 7 секунд {% endhint %} После обработки модератором аудиозаписи будет присвоен идентификатор - например, 1484915.

## **Как происодит сопоставление клиента** {% hint style="success" %} **Требования к формату номера телефона**: \ \- Номер должен начинаться с 7 или иного кода страны, например 375 \ \- Номер должен состоять из 11 и более цифр и не иметь лишних знаков и отступов.\ Например: 71234567890 {% endhint %} Последовательность сопоставления данных о клиенте: \ 1\. Осуществляется поиск клиента Телефонии. Если клиент не найден, то происходит поиск по значениям всех переменных по всему списку клиентов проекта. Первая найденная запись о клиенте считается тем самым "искомым" клиентом. \ 2.Если клиент не найден среди клиентов Телефонии и: \ ● к проекту подключен любой мессенджер, например, Whatsapp, то будет создан клиент Whatsapp с данным номером телефона. \ ● к проекту не подключены иные виды мессенджеров (Whatsapp, Viber, Instagram и т.д.), то будет создан клиент Телефонии. Такому клиенту Вы сможете совершать только звонки с получением информации о них. Написать такому клиенту возможности нет. ## Функция Salebot звонок на номер Для того чтобы совершить звонок из бота, необходимо использовать функцию **zvonobot\_call(number, client\_phone, record\_id)**, которая принимает на вход следующие параметры: \ **number** - номер, с которого будет совершаться звонок. \ **client\_phone** - номер клиента, которому должен быть совершен звонок, строка, пример - '79004443322'. \ **record\_id** - идентификатор аудиозаписи. **Пример реализации функции в боте:**

## Функция Salebot звонок на номер и последующее нажатие на кнопку Иногда предполагается, что после проигрывания сообщения клиент должен нажать кнопку, чтобы оставить свое намерение. Функция **zvonobot\_digits\_call (number, client\_phone, record\_id, payload)** позволит передать назначения на цифры от 0 до 9, среди которых \ а) включить следующую аудиозапись, \ б) прислать смс с текстом, \ в) перенаправить звонок на менеджера, \ г) разрешить клиенту добавить этот номер в чс. Функция принимает на вход следующие параметры: \ **number** - номер, с которого будет совершаться звонок. \ **client\_phone** - номер клиента, которому должен быть совершен звонок, строка, пример - '79004443322'. \ **record\_id** - идентификатор аудиозаписи. \ **payload** - список действий, состоящий из словарей, где ключи состоят из ключевых слов, обозначающих действие: \ \&#xNAN;**"record"** - проиграть запись с указанным идентификатором, \ \&#xNAN;**"managerPhone"** - перенаправить звонок на менеджера с указанным телефоном, \ \&#xNAN;**"smsText"** - отправить на номер клиента смс с указанным текстом \ \&#xNAN;**"needBlock"** - установить значение 1 для добавления номера в чс. payload может состоять из 10 словарей, каждый из которых соответствует цифре индекса в списке, т.е от 0 до 9 Пример оформления **payload**: payload = \[{"record" : "1460168"},{"managerPhone": "74242490764"},{"smsText": "Привет, это Толик"},{"needBlock": "1"}] В данном примере при нажатии на цифру 0 будет проигрываться аудиосообщение с идентификатором 1460168, при нажатии на цифру 1 звонок будет перенаправлен менеджеру на номер 74242490764, при нажатии на цифру 2 будет отправлено смс с текстом “Привет, это Толик, а при нажатии на цифру 3 номер будет занесен в ЧС для данного клиента. Пример реализации функции в боте:

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

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

В позиции “Способ совершения телефонных звонков” выберите звонки по API Zvonobot. ● Если выбрать пункт Отключить звонки, то этот сотрудник не сможет совершать звонки и иконка телефона возле номеров телефона у него не будет отображаться. ● Звонки через приложение - при нажатии на иконку телефона звонок будет перенаправлен в приложение, установленное для звонков на Вашем устройстве (Zopier и тд). ● Звонки по API Zvonobot - при клике на иконку телефона АТС звонок поступит c номера, указанного в карточке сотрудника, и проиграется указанная аудиозапись. После выбора способа совершения телефонных звонков в “Звонки по API Zvonobot” появится дополнительное поле, в которое следует вписать номер, с которого будет идти звонок, и ид аудиозаписи.

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

Отображение данных в карточке клиента Salebot

## Настройка вебхуков После совершения звонка в карточку клиента будет доставлено уведомление о его завершении или отмене.