Klientská knihovna azure Communication Call Automation pro Python – verze 1.1.0
Tento balíček obsahuje sadu Python SDK pro službu Azure Communication Call Automation. Automatizace volání poskytuje vývojářům možnost vytvářet inteligentní pracovní postupy volání založené na serveru a zaznamenávat hovory pro hlasové kanály a kanály veřejné telefonní sítě.
Přehled automatizace | voláníDokumentace k produktu
Právní omezení
Podpora balíčků Azure SDK Python pro Python 2.7 skončila 1. ledna 2022. Další informace a dotazy najdete na https://github.com/Azure/azure-sdk-for-python/issues/20691
Začínáme
Požadavky
- K použití tohoto balíčku se vyžaduje Python 3.7 nebo novější.
- K použití tohoto balíčku potřebujete předplatné Azure .
- Nasazený prostředek komunikačních služeb K jeho nastavení můžete použít Azure Portal nebo Azure PowerShell.
Instalace
Nainstalujte sadu SDK pro automatizaci volání služby Azure Communication Service.
pip install azure-communication-callautomation
Klíčové koncepty
| Název | Description | |
|---|---|---|
| CallAutomationClient | CallAutomationClient je primární rozhraní pro vývojáře, kteří používají tuto klientskou knihovnu. Dá se použít k inicializaci volání pomocí createCall nebo answerCall. Dá se také použít k provádění akcí nahrávání, jako je startRecording |
|
| CallConnectionClient | CallConnectionClient představuje probíhající hovor. Jakmile je volání navázáno pomocí createCall nebo answerCall, je možné pro volání provést další akce, například transfer nebo play_media. |
|
| Události zpětného volání | Události zpětného volání jsou události odesílané zpět během volání. Poskytuje informace a stav volání, například CallConnected. CallbackUrl musí být zadané během createCall a a answerCallna tuto adresu URL se odesílají události zpětného volání. |
|
| Událost příchozího hovoru | Když dojde k příchozímu hovoru (který lze přijmout pomocí answerCall), bude odeslána událost eventgrid příchozího volání. To se liší od výše uvedených událostí zpětného volání a mělo by být nastaveno na Azure Portal. Podrobnosti najdete v tématu Příchozí hovor . |
Příklady
Inicializace CallAutomationClient
from azure.communication.callautomation import (CallAutomationClient)
# Your unique Azure Communication service endpoint
endpoint_url = '<ENDPOINT>'
client = CallAutomationClient.from_connection_string(endpoint_url)
Vytvořit hovor
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
Přehrát multimédia
# 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)
Řešení potíží
Další kroky
- Přehled automatizace volání
- Koncept příchozího hovoru
- Vytvoření pracovního postupu interakce se zákazníkem pomocí automatizace volání
- Přesměrování příchozích telefonních volání pomocí automatizace volání
- Připojení Azure Communication Services se službami Azure AI
- Rychlý start: Akce přehrávání
- Rychlý start: Akce Rozpoznávání
- Přečtěte si další informace o nahrávání hovorů v Azure Communication Services
- Nahrávání a stahování hovorů pomocí Event Gridu
Zadání zpětné vazby
Pokud narazíte na nějaké chyby nebo máte návrhy, nahlaste problém v části Problémy projektu.
Přispívání
Tento projekt vítá příspěvky a návrhy. Většina příspěvků vyžaduje souhlas s licenční smlouvou s přispěvatelem (CLA), která stanoví, že máte právo udělit nám práva k používání vašeho příspěvku a skutečně tak činíte. Podrobnosti najdete tady: https://cla.microsoft.com
Při odesílání žádosti o přijetí změn robot CLA automaticky určí, jestli je potřeba poskytnout smlouvu CLA, a příslušným způsobem žádost o přijetí změn upraví (např. přidáním jmenovky nebo komentáře). Stačí postupovat podle pokynů robota. Pro všechna úložiště používající naši smlouvu CLA to stačí udělat jenom jednou.
Tento projekt přijal [Pravidla chování open source společnosti Microsoft][code_of_conduct]. Další informace najdete v nejčastějších dotazech k pravidlům chování. V případě jakýchkoli dotazů nebo připomínek kontaktujte opencode@microsoft.com.
Azure SDK for Python