Azure Communication Call Automation-Clientbibliothek für Python – Version 1.1.0
Dieses Paket enthält ein Python SDK für die Azure Communication Call Automation. Die Anrufautomatisierung bietet Entwicklern die Möglichkeit, serverbasierte, intelligente Anrufworkflows und Anrufaufzeichnungen für Sprach- und PSTN-Kanäle zu erstellen.
Übersicht über die Anrufautomatisierung | Produktdokumentation
Haftungsausschluss
Die Unterstützung von Python-Paketen für Das Azure SDK für Python 2.7 wurde am 01. Januar 2022 eingestellt. Weitere Informationen und Antworten finden Sie unter https://github.com/Azure/azure-sdk-for-python/issues/20691.
Erste Schritte
Voraussetzungen
- Für die Verwendung dieses Pakets ist Python 3.7 oder höher erforderlich.
- Sie benötigen ein Azure-Abonnement , um dieses Paket verwenden zu können.
- Eine bereitgestellte Communication Services-Ressource. Sie können das Azure-Portal oder das Azure PowerShell verwenden, um es einzurichten.
Installieren von
Installieren Sie das Azure Communication Service Call Automation SDK.
pip install azure-communication-callautomation
Wichtige Begriffe
Name | BESCHREIBUNG | |
---|---|---|
CallAutomationClient | CallAutomationClient ist die primäre Schnittstelle für Entwickler, die diese Clientbibliothek verwenden. Sie kann verwendet werden, um Aufrufe von createCall oder answerCall zu initiieren. Es kann auch verwendet werden, um Aufzeichnungsaktionen durchzuführen, z. B. startRecording |
|
CallConnectionClient | CallConnectionClient stellt einen fortlaufenden Aufruf dar. Sobald der Aufruf mit createCall oder answerCall eingerichtet wurde, können weitere Aktionen für den Aufruf ausgeführt werden, z transfer . B. oder play_media . |
|
Rückrufereignisse | Rückrufereignisse sind Ereignisse, die während der Dauer des Anrufs zurückgesendet werden. Es gibt Informationen und den Zustand des Aufrufs, z. B CallConnected . . CallbackUrl müssen während createCall und answerCall bereitgestellt werden, und Rückrufereignisse werden an diese URL gesendet. |
|
Ereignis für eingehende Anrufe | Wenn ein eingehender Anruf erfolgt (der mit answerCall beantwortet werden kann), wird ein eingehender Anruf eventgrid-Ereignis gesendet. Dies unterscheidet sich von den oben genannten Rückrufereignissen und sollte für Azure-Portal eingerichtet werden. Weitere Informationen finden Sie unter Eingehender Anruf . |
Beispiele
Initialisieren von CallAutomationClient
from azure.communication.callautomation import (CallAutomationClient)
# Your unique Azure Communication service endpoint
endpoint_url = '<ENDPOINT>'
client = CallAutomationClient.from_connection_string(endpoint_url)
Anruf erstellen
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
Medien wiedergeben
# 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)
Problembehandlung
Nächste Schritte
- Übersicht über die Anrufautomatisierung
- Konzept für eingehende Anrufe
- Erstellen eines Kundeninteraktionsworkflows mithilfe von Anrufautomatisierung
- Umleiten eingehender Telefonanrufe mit der Anrufautomatisierung
- Herstellen einer Verbindung Azure Communication Services mit Azure KI-Diensten
- Schnellstart: Wiedergabeaktion
- Schnellstart: Erkennen von Aktion
- Weitere Informationen zur Anrufaufzeichnung in Azure Communication Services
- Aufzeichnen und Herunterladen von Anrufen mit Event Grid
Feedback geben
Wenn Sie Fehler oder Vorschläge haben, melden Sie ein Problem im Abschnitt Probleme des Projekts.
Mitwirken
Beiträge und Vorschläge für dieses Projekt sind willkommen. Most contributions require you to agree to a Contributor License Agreement (CLA) declaring that you have the right to, and actually do, grant us the rights to use your contribution. Ausführliche Informationen finden Sie unter https://cla.microsoft.com.
Wenn Sie einen Pull Request (PR) übermitteln, überprüft ein CLA-Bot automatisch, ob Sie eine Lizenzvereinbarung bereitstellen und den PR entsprechend ergänzen müssen (z.B. mit einer Bezeichnung oder einem Kommentar). Führen Sie einfach die Anweisungen des Bots aus. Sie müssen dies nur einmal für alle Repositorys ausführen, die unsere CLA verwenden.
Dieses Projekt hat den [Microsoft Open Source Code of Conduct][code_of_conduct]. Weitere Informationen finden Sie in den FAQ zum Verhaltenskodex, oder wenden Sie sich mit weiteren Fragen oder Kommentaren an opencode@microsoft.com.
Azure SDK for Python