Python için Azure İletişim Çağrı Otomasyonu istemci kitaplığı - sürüm 1.1.0

Makale
11/23/2023

Bu paket, Azure İletişim Çağrı Otomasyonu için bir Python SDK'sı içerir. Çağrı Otomasyonu, geliştiricilere sunucu tabanlı, akıllı arama iş akışları ve ses ve PSTN kanalları için arama kaydı oluşturma olanağı sağlar.

Çağrı Otomasyonuna | Genel BakışÜrün belgeleri

Bildirim

Python 2.7 için Azure SDK Python paketleri desteği 01 Ocak 2022'de sona erdi. Daha fazla bilgi ve soru için bkz. https://github.com/Azure/azure-sdk-for-python/issues/20691

Başlarken

Önkoşullar

Bu paketi kullanmak için Python 3.7 veya üzeri gereklidir.
Bu paketi kullanmak için bir Azure aboneliğine ihtiyacınız vardır.
Dağıtılan bir İletişim Hizmetleri kaynağı. Ayarlamak için Azure Portal'ı veya Azure PowerShell kullanabilirsiniz.

Yükleme

Azure İletişim Hizmeti Çağrı Otomasyonu SDK'sını yükleyin.

pip install azure-communication-callautomation

Önemli kavramlar

Ad	Açıklama
CallAutomationClient	`CallAutomationClient` , bu istemci kitaplığını kullanan geliştiriciler için birincil arabirimdir. veya `answerCall`tarafından `createCall` çağrı başlatmak için kullanılabilir. Ayrıca, `startRecording`
CallConnectionClient	`CallConnectionClient` devam eden bir çağrıyı temsil eder. veya ile `createCallanswerCall`çağrı oluşturulduktan sonra, çağrı için veya `play_media`gibi `transfer` başka eylemler gerçekleştirilebilir.
Geri Çağırma Olayları	Geri çağırma olayları, çağrı süresince geri gönderilen olaylardır. Çağrının bilgilerini ve durumunu verir, örneğin `CallConnected`. `CallbackUrl`ve `answerCall`sırasında `createCall` sağlanmalıdır ve geri çağırma olayları bu URL'ye gönderilir.
Gelen Arama Olayı	Gelen arama gerçekleştiğinde (ile yanıtlanabilir `answerCall`), gelen çağrı eventgrid olayı gönderilir. Bu, yukarıdaki Geri Çağırma olaylarından farklıdır ve Azure portal'da ayarlanmalıdır. Ayrıntılar için bkz . Gelen Arama .

Örnekler

CallAutomationClient'ı başlatma

from azure.communication.callautomation import (CallAutomationClient)

# Your unique Azure Communication service endpoint
endpoint_url = '<ENDPOINT>'
client = CallAutomationClient.from_connection_string(endpoint_url)

Arama Oluştur

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

Medya Yürütme

# 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)

Sorun giderme

Sonraki adımlar

Geri Bildirim Sağlama

Herhangi bir hatayla karşılaşırsanız veya önerileriniz varsa lütfen projenin Sorunlar bölümünde bir sorun oluşturun

Katkıda bulunma

Bu proje, katkı ve önerilere açıktır. Çoğu durumda, sağladığınız katkıyı kullanmamız için bize hak tanıma hakkına sahip olduğunuzu ve bu hakkı bize tanıdığınızı bildiren bir Katkıda Bulunan Lisans Sözleşmesi’ni (CLA) kabul etmeniz gerekir. Ayrıntılar için bkz. https://cla.microsoft.com.

Bir çekme isteği gönderdiğinizde, CLA robotu bir CLA sağlamanız gerekip gerekmediğini otomatik olarak belirler ve çekme isteğini uygun şekilde donatır (örn. etiket, açıklama). Robot tarafından sağlanan yönergeleri izlemeniz yeterlidir. Bu işlemi, CLA’mızı kullanarak tüm depolarda yalnızca bir kere yapmanız gerekir.

Bu proje [Microsoft Açık Kaynak Kullanım Kuralları][code_of_conduct] benimsemiştir. Daha fazla bilgi için Kullanım Kuralları hakkında SSS bölümüne bakın veya başka soru ya da görüşleriniz olursa opencode@microsoft.com ile iletişime geçin.

Aracılığıyla paylaş