Aracılığıyla paylaş


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

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

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 answerCalltarafı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_mediagibi 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. CallbackUrlve answerCallsı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.