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 answerCallzu 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 answerCalleingerichtet 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 answerCallbereitgestellt werden, und Rückrufereignisse werden an diese URL gesendet.
Ereignis für eingehende Anrufe	Wenn ein eingehender Anruf erfolgt (der mit answerCallbeantwortet 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.