Biblioteka klienta usługi Azure Communication Call Automation dla języka Python — wersja 1.1.0
Ten pakiet zawiera zestaw SDK języka Python dla usługi Azure Communication Call Automation. Usługa Call Automation zapewnia deweloperom możliwość tworzenia przepływów pracy opartych na serwerze, inteligentnych wywołań oraz rejestrowania połączeń na potrzeby kanałów głosowych i PSTN.
Omówienie automatyzacji wywołań | Dokumentacja produktu
Zrzeczenie odpowiedzialności
Obsługa pakietów języka Python zestawu Azure SDK dla języka Python 2.7 została zakończona 01 stycznia 2022 r. Aby uzyskać więcej informacji i pytań, zapoznaj się z artykułem https://github.com/Azure/azure-sdk-for-python/issues/20691
Wprowadzenie
Wymagania wstępne
- Do korzystania z tego pakietu wymagany jest język Python w wersji 3.7 lub nowszej.
- Do korzystania z tego pakietu potrzebna jest subskrypcja platformy Azure .
- Wdrożony zasób usług komunikacyjnych. Aby go skonfigurować, możesz użyć witryny Azure Portal lub Azure PowerShell.
Instalowanie
Zainstaluj zestaw SDK usługi Azure Communication Service Call Automation.
pip install azure-communication-callautomation
Kluczowe pojęcia
| Nazwa | Opis | |
|---|---|---|
| CallAutomationClient | CallAutomationClient jest podstawowym interfejsem dla deweloperów korzystających z tej biblioteki klienta. Może służyć do inicjowania wywołań za pomocą elementu createCall lub answerCall. Może również służyć do nagrywania akcji, takich jak startRecording |
|
| CallConnectionClient | CallConnectionClient reprezentuje trwające wywołanie. Po nawiązaniu połączenia z elementem createCall lub answerCallmożna wykonać kolejne akcje dla wywołania, takie jak transfer lub play_media. |
|
| Zdarzenia wywołania zwrotnego | Zdarzenia wywołania zwrotnego to zdarzenia wysyłane z powrotem w czasie trwania wywołania. Zawiera informacje i stan wywołania, takie jak CallConnected. CallbackUrl Należy podać zdarzenia podczas createCall i , answerCalla zdarzenia wywołania zwrotnego zostaną wysłane do tego adresu URL. |
|
| Zdarzenie połączenia przychodzącego | Po wystąpieniu połączenia przychodzącego (na które można odpowiedzieć za pomocą answerCallpolecenia ), zdarzenie eventgrid połączenia przychodzącego zostanie wysłane. Różni się to od powyższych zdarzeń wywołania zwrotnego i powinno być skonfigurowane w Azure Portal. Aby uzyskać szczegółowe informacje, zobacz Połączenie przychodzące . |
Przykłady
Inicjowanie klasy CallAutomationClient
from azure.communication.callautomation import (CallAutomationClient)
# Your unique Azure Communication service endpoint
endpoint_url = '<ENDPOINT>'
client = CallAutomationClient.from_connection_string(endpoint_url)
Tworzenie połączenia
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
Odtwarzanie multimediów
# 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)
Rozwiązywanie problemów
Następne kroki
- Omówienie automatyzacji wywołań
- Koncepcja połączenia przychodzącego
- Tworzenie przepływu pracy interakcji z klientem przy użyciu usługi Call Automation
- Przekierowywanie przychodzących połączeń telefonicznych za pomocą usługi Call Automation
- Łączenie Azure Communication Services za pomocą usług Azure AI
- Szybki start: akcja odtwarzania
- Szybki start: akcja rozpoznawania
- Przeczytaj więcej na temat nagrywania połączeń w Azure Communication Services
- Rejestrowanie i pobieranie wywołań za pomocą usługi Event Grid
Przekazywanie opinii
Jeśli wystąpią jakiekolwiek usterki lub sugestie, zgłoś problem w sekcji Problemy w projekcie
Współtworzenie
W tym projekcie zachęcamy do współtworzenia i zgłaszania sugestii. Współtworzenie w większości przypadków wymaga zgody na umowę licencyjną dotyczącą współautorów (CLA, Contributor License Agreement), zgodnie z którą współautor ma prawo udzielić i faktycznie udziela nam praw do używania wytworzonej przez siebie zawartości. Aby uzyskać szczegółowe informacje, odwiedź stronę https://cla.microsoft.com.
Po przesłaniu żądania ściągnięcia robot CLA automatycznie określi, czy musisz przekazać umowę CLA, i doda odpowiednie informacje do tego żądania (na przykład etykietę czy komentarz). Po prostu postępuj zgodnie z instrukcjami robota. Wystarczy zrobić to raz dla wszystkich repozytoriów, w przypadku których jest używana nasza umowa CLA.
Ten projekt przyjął kodeks postępowania [Microsoft Open Source Code of Conduct][code_of_conduct]. Aby uzyskać więcej informacji, zobacz artykuł Code of Conduct FAQ (Często zadawane pytania dotyczące kodeksu postępowania). Jeśli będziesz mieć jeszcze jakieś pytania lub komentarze, wyślij wiadomość e-mail na adres opencode@microsoft.com.
Azure SDK for Python