Клиентская библиотека службы автоматизации вызовов связи Azure для Python версии 1.1.0

Статья
11/23/2023

Этот пакет содержит пакет SDK python для автоматизации вызовов связи Azure. Служба автоматизации звонков предоставляет разработчикам возможность создавать интеллектуальные рабочие процессы вызовов на основе сервера и записывать звонки для голосовых каналов и каналов ТСОП.

Общие сведения об автоматизации вызовов | Документация по продукту

Заявление об отказе

Поддержка пакетов Python пакета Azure SDK для Python 2.7 завершилась 1 января 2022 г. Дополнительные сведения и вопросы см. на https://github.com/Azure/azure-sdk-for-python/issues/20691

Начало работы

Предварительные требования

Для использования этого пакета требуется Python 3.7 или более поздней версии.
Для использования этого пакета требуется подписка Azure .
Развернутый ресурс Служб коммуникации. Для настройки можно использовать портал Azure или Azure PowerShell.

Установка

Установите пакет SDK службы коммуникации Azure Для автоматизации вызовов.

pip install azure-communication-callautomation

Основные понятия

Имя	Описание
CallAutomationClient	`CallAutomationClient` — это основной интерфейс для разработчиков, использующих эту клиентную библиотеку. Его можно использовать для инициации вызовов с помощью `createCall` или `answerCall`. Его также можно использовать для выполнения действий записи, таких как `startRecording`
CallConnectionClient	`CallConnectionClient` представляет текущий вызов. После установки вызова с `createCall` помощью или `answerCall`можно выполнить дополнительные действия для вызова, например `transfer` или `play_media`.
События обратного вызова	События обратного вызова — это события, отправляемые обратно во время вызова. Он предоставляет сведения и состояние вызова, например `CallConnected`. `CallbackUrl` необходимо указать во время `createCall` и `answerCall`, и на этот URL-адрес будут отправляться события обратного вызова.
Событие входящего звонка	При выполнении входящего звонка (на который можно ответить с помощью `answerCall`), будет отправлено событие eventgrid входящего вызова. Это отличается от событий обратного вызова выше и должно быть настроено на портал Azure. Дополнительные сведения см. в разделе Входящие звонки .

Примеры

Инициализация CallAutomationClient

from azure.communication.callautomation import (CallAutomationClient)

# Your unique Azure Communication service endpoint
endpoint_url = '<ENDPOINT>'
client = CallAutomationClient.from_connection_string(endpoint_url)

Создание звонка

from azure.communication.callautomation import (
    CallAutomationClient,
    CommunicationUserIdentifier
)

# target endpoint for ACS User
user = CommunicationUserIdentifier("8:acs:...")

# callback url to receive callback events
callback_url = "https://<MY-EVENT-HANDLER-URL>/events"

# send out the invitation, creating call
result = client.create_call(user, callback_url)

# this id can be used to do further actions in the call
call_connection_id = result.call_connection_id

Воспроизведение мультимедиа

# using call connection id, get call connection
call_connection = client.get_call_connection(call_connection_id)

# from callconnection of result above, play media to all participants
my_file = FileSource(url="https://<FILE-SOURCE>/<SOME-FILE>.wav")
call_connection.play_media(my_file)

Устранение неполадок

Дальнейшие действия

Отзывы

Если вы столкнулись с ошибками или у вас есть предложения, сообщите о проблеме в разделе Проблемы проекта.

Участие

На этом проекте приветствуются публикации и предложения. Для участия в большинстве процессов по разработке документации необходимо принять лицензионное соглашение участника (CLA), в котором указывается, что вы предоставляете нам права на использование ваших публикаций. Для получения подробных сведений посетите веб-страницу https://cla.microsoft.com.

При отправке запроса на включение внесенных изменений CLA-бот автоматически определит необходимость предоставления соглашения CLA и соответствующего оформления запроса на включение внесенных изменений (например, добавление метки, комментария). Просто следуйте инструкциям бота. Будет достаточно выполнить их один раз для всех репозиториев, поддерживающих соглашение CLA.

Этот проект принял [Правила поведения с открытым кодом Майкрософт][code_of_conduct]. Дополнительные сведения: Вопросы и ответы по правилам поведения. С любыми другими вопросами или комментариями обращайтесь по адресу opencode@microsoft.com.

Поделиться через