Python 用 Azure Communication Call Automation クライアント ライブラリ - バージョン 1.1.0
このパッケージには、Azure Communication Call Automation 用の Python SDK が含まれています。 通話オートメーションを使用すると、開発者は、サーバーベースのインテリジェントな通話ワークフローを構築し、音声チャネルと PSTN チャネルの通話記録を作成できます。
免責事項
Python 2.7 の Azure SDK Python パッケージのサポートは、2022 年 1 月 1 日に終了しました。 詳細と質問については、https://github.com/Azure/azure-sdk-for-python/issues/20691 を参照してください
作業の開始
前提条件
- このパッケージを使用するには、Python 3.7 以降が必要です。
- このパッケージを使用するには 、Azure サブスクリプション が必要です。
- デプロイ済みの Communication Services リソース。 Azure Portal またはAzure PowerShellを使用して設定できます。
［インストール中］
Azure Communication Service Call Automation SDK をインストールします。
pip install azure-communication-callautomation
主要な概念
| 名前 | 説明 | |
|---|---|---|
| CallAutomationClient | CallAutomationClient は、このクライアント ライブラリを使用する開発者のための主要なインターフェイスです。 または によってcreateCallanswerCall呼び出しを開始するために使用できます。 また、次のような記録アクションを実行するためにも使用できます。 startRecording |
|
| CallConnectionClient | CallConnectionClient は、進行中の呼び出しを表します。 または answerCallを使用してcreateCall呼び出しが確立されたら、 や play_mediaなどのtransfer呼び出しに対してさらにアクションを実行できます。 |
|
| コールバック イベント | コールバック イベントは、呼び出し中に返送されるイベントです。 これは、 などの CallConnected呼び出しの情報と状態を提供します。 CallbackUrlは と の間にcreateCallanswerCall指定する必要があり、コールバック イベントはこの URL に送信されます。 |
|
| 着信イベント | 着信が発生すると (で応答 answerCallできます)、着信呼び出し eventgrid イベントが送信されます。 これは上記のコールバック イベントとは異なり、Azure portalに設定する必要があります。 詳細については、「 着信呼び出し 」を参照してください。 |
例
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)
トラブルシューティング
次のステップ
- Call Automation の概要
- 着信の概念
- Call Automation を使用して顧客対話ワークフローを構築する
- Call Automation を使用して着信テレフォニー呼び出しをリダイレクトする
- Azure AI サービスを使用してAzure Communication Servicesを接続する
- クイックスタート: 再生アクション
- クイックスタート: アクションを認識する
- 詳細については、「Azure Communication Servicesでの通話記録」を参照してください
- Event Grid を使用した通話の記録とダウンロード
フィードバックの提供
バグが発生した場合、または提案がある場合は、プロジェクトの [問題 ] セクションに問題を報告してください
共同作成
このプロジェクトでは、共同作成と提案を歓迎しています。 ほとんどの共同作成では、共同作成者使用許諾契約書 (CLA) にご同意いただき、ご自身の共同作成内容を使用する権利を Microsoft に供与する権利をお持ちであり、かつ実際に供与することを宣言していただく必要があります。 詳細については、 https://cla.microsoft.com を参照してください。
pull request を送信すると、CLA を提供して PR (ラベル、コメントなど) を適宜装飾する必要があるかどうかを CLA ボットが自動的に決定します。 ボットによって提供される手順にそのまま従ってください。 この操作は、Microsoft の CLA を使用するすべてのリポジトリについて、1 回だけ行う必要があります。
このプロジェクトでは、[Microsoft Open Source Code of Conduct][code_of_conduct] が採用されています。 詳細については、「倫理規定の FAQ」をご覧ください。追加の質問やコメントがある場合は opencode@microsoft.com にお問い合わせください。
Azure SDK for Python