Pustaka klien Azure Communication Call Automation untuk Python - versi 1.1.0

Paket ini berisi Python SDK untuk Azure Communication Call Automation. Automasi Panggilan memberi pengembang kemampuan untuk membangun alur kerja panggilan cerdas berbasis server, dan perekaman panggilan untuk saluran suara dan PSTN.

Gambaran Umum Automasi | PanggilanDokumentasi produk

Pengelakan

Dukungan paket Azure SDK Python untuk Python 2.7 telah berakhir 01 Januari 2022. Untuk informasi lebih lanjut dan pertanyaan, silakan merujuk ke https://github.com/Azure/azure-sdk-for-python/issues/20691

Memulai

Prasyarat

• Python 3.7 atau yang lebih baru diharuskan untuk menggunakan paket ini.
• Anda memerlukan langganan Azure untuk menggunakan paket ini.
• Sumber daya Communication Services yang disebarkan. Anda dapat menggunakan Portal Microsoft Azure atau Azure PowerShell untuk menyiapkannya.

Menginstal

Instal Azure Communication Service Call Automation SDK.

pip install azure-communication-callautomation

Konsep utama

Nama	Deskripsi
CallAutomationClient	CallAutomationClient adalah antarmuka utama untuk pengembang yang menggunakan pustaka klien ini. Ini dapat digunakan untuk memulai panggilan dengan createCall atau answerCall. Ini juga dapat digunakan untuk melakukan tindakan perekaman seperti startRecording
CallConnectionClient	CallConnectionClient mewakili panggilan yang sedang berlangsung. Setelah panggilan dibuat dengan createCall atau answerCall, tindakan lebih lanjut dapat dilakukan untuk panggilan, seperti transfer atau play_media.
Peristiwa Panggilan Balik	Peristiwa panggilan balik adalah peristiwa yang dikirim kembali selama durasi panggilan. Ini memberikan informasi dan status panggilan, seperti CallConnected. CallbackUrl harus disediakan selama createCall dan answerCall, dan peristiwa panggilan balik akan dikirim ke url ini.
Peristiwa Panggilan Masuk	Ketika panggilan masuk terjadi (yang dapat dijawab dengan answerCall), peristiwa eventgrid panggilan masuk akan dikirim. Ini berbeda dari peristiwa Callback di atas, dan harus diatur pada portal Azure. Lihat Panggilan Masuk untuk detailnya.

Contoh

Menginisialisasi CallAutomationClient

from azure.communication.callautomation import (CallAutomationClient)

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

Buat Panggilan

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

Putar Media

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

Pemecahan Masalah

Langkah berikutnya

• Gambaran Umum Automasi Panggilan
• Konsep Panggilan Masuk
• Membangun alur kerja interaksi pelanggan menggunakan Automasi Panggilan
• Mengalihkan panggilan telepon masuk dengan Automasi Panggilan
• Menyambungkan Azure Communication Services dengan layanan Azure AI
• Mulai cepat: Putar tindakan
• Mulai cepat: Mengenali tindakan
• Baca selengkapnya tentang Perekaman Panggilan di Azure Communication Services
• Merekam dan mengunduh panggilan dengan Event Grid

Berikan Umpan Balik

Jika Anda menemukan bug atau memiliki saran, silakan ajukan masalah di bagian Masalah proyek

Berkontribusi

Proyek ini menyambut baik kontribusi dan saran. Sebagian besar kontribusi mengharuskan Anda menyetujui Perjanjian Lisensi Kontributor (CLA) yang menyatakan bahwa Anda memiliki hak untuk, dan benar-benar melakukannya, memberi kami hak untuk menggunakan kontribusi Anda. Untuk detailnya, kunjungi https://cla.microsoft.com.

Ketika Anda mengirimkan permintaan tarik, CLA-bot akan secara otomatis menentukan apakah Anda perlu memberikan CLA dan menghias PR dengan tepat (misalnya, label, komentar). Cukup ikuti instruksi yang diberikan oleh bot. Anda hanya perlu melakukan ini sekali di semua repos menggunakan CLA kami.

Proyek ini telah mengadopsi [Kode Etik Sumber Terbuka Microsoft][code_of_conduct]. Untuk informasi selengkapnya, lihat Tanya Jawab Umum Kode Etik atau kontak dengan pertanyaan atau komentar opencode@microsoft.com tambahan.