Как совершать и принимать телефонные звонки с помощью голосового API Plivo и Python
Эта статья о том, как совершать исходящие вызовы и обрабатывать входящие вызовы через Plivo в приложении Python.
Установка Plivo SDK
Предполагается, что у вас уже установлен Python. Перейдите в каталог, в который вы хотите установить пакет Plivo Python и запустите.
Нахождение своего идентификатора аутентификации и токена аутентификации
Вы должны знать свои учетные данные, прежде чем сможете использовать Plivo API. Мы предоставляем Auth ID и Auth Token в разделе Account в верхней части обзорной страницы консоли Plivo .
Выбор номера телефона
Если вы хотите принимать входящие звонки, вам понадобится номер телефона Plivo с поддержкой голосовой связи. Проверьте экран «Номера» на консоли Plivo, чтобы узнать, какие номера у вас есть. Вы также можете брать номера на этом экране.
Использование PHLO для настройки исходящего звонка
Теперь вы можете обратиться в PHLO – студию визуального проектирования рабочих процессов Plivo, чтобы настроить рабочий процесс для исходящего звонка. Щелкните значок PHLO на левой панели навигации, затем выберите «Создать новый PHLO». Во всплывающем окне нажмите «Создать свой собственный» .
Из списка компонентов слева перетащите компонент «Инициировать вызов» на холст, затем подключите узел «Начало» к узлу «Инициировать вызов», используя состояние запуска запроса API.
Теперь вы можете добавить информацию о конфигурации для вызова на правой панели. Допустимые номера телефонов начинаются со знака «плюс» и кода страны. Добавьте номер вызывающего абонента в поле «От кого» и номер адресата в поле «Кому», затем нажмите «Проверить», чтобы сохранить конфигурацию.
Теперь перетащите компонент Play Audio на холст. Подключите узел «Инициировать вызов» к «Воспроизведение звука», используя состояние ответа на вызов. На панели «Конфигурация» введите текст, который вы хотите воспроизвести для получателя вызова, затем нажмите «Подтвердить».
Дайте PHLO имя, щелкнув значок карандаша в верхнем левом углу, затем нажмите кнопку «Сохранить» в верхнем правом углу.
Запуск PHLO, для звонка
Теперь вы можете запустить PHLO и проверить его. Скопируйте идентификатор PHLO из конца URL-адреса только что созданного рабочего процесса. Вам также понадобится ваш идентификатор аутентификации и токен аутентификации. Создайте файл исходного кода Python – назовем его trigger_phlo.py – и вставьте в него этот код:
import plivo auth_id = '<auth_id>'
auth_token = '<auth_token>'
phlo_id = '<PHLO_ID>' # https://console.plivo.com/phlo/list/
phlo_client = plivo.phlo.RestClient(auth_id=auth_id, auth_token=auth_token)
phlo = phlo_client.phlo.get(phlo_id)
response = phlo.run()
print str(response)
Подставьте фактические значения для <auth_id>, <auth_token> и <PHLO_ID>. Сохраните файл и запустите его.
Настройка входящих звонков
Plivo также поддерживает входящие звонки. Чтобы увидеть, как это сделать, давайте создадим еще один PHLO и снова укажем “Создать свой собственный”. На этот раз перетащите аудиокомпонент воспроизведения на холст и подключите к нему узел запуска, используя состояние запуска входящего вызова. На панели конфигурации введите текст, чтобы обратиться к вызывающему абоненту при ответе на вызов, затем нажмите кнопку “Подтвердить”, чтобы сохранить конфигурацию. Дайте этому PHLO имя, затем нажмите кнопку “Сохранить”.
Прежде чем вы сможете принимать вызов с помощью этого PHLO, вам необходимо назначить его на номер Plivo. Вернитесь в консоль Plivo и нажмите «Номера телефонов» на левой панели навигации. В списке ваших номеров нажмите на номер, который хотите использовать. На следующем экране в раскрывающемся списке “Тип приложения” выберите PHLO. В раскрывающемся списке “Имя PHLO” выберите только что созданный PHLO. Затем нажмите «Обновить номер» внизу экрана.
Просто позвоните по указанному вами номеру Plivo, и вы должны услышать настроенное вами сообщение, прочитанное процессором преобразования текста в речь Plivo.