Libreria client di Automazione chiamate di comunicazione di Azure per Python - versione 1.1.0

Articolo
11/23/2023

Questo pacchetto contiene un SDK Python per Automazione chiamate di comunicazione di Azure. Call Automation offre agli sviluppatori la possibilità di creare flussi di lavoro di chiamata intelligenti, basati su server e chiamate per canali vocali e PSTN.

Panoramica dell'automazione | delle chiamateDocumentazione del prodotto

Dichiarazione di non responsabilità

Il supporto dei pacchetti Python di Azure SDK per Python 2.7 è terminato 01 gennaio 2022. Per altre informazioni e domande, vedere https://github.com/Azure/azure-sdk-for-python/issues/20691

Introduzione

Prerequisiti

Python 3.7 o versione successiva è necessario per usare questo pacchetto.
È necessaria una sottoscrizione di Azure per usare questo pacchetto.
Una risorsa di Servizi di comunicazione distribuita. È possibile usare il portale di Azure o il Azure PowerShell per configurarlo.

Installazione

Installare Azure Communication Service Call Automation SDK.

pip install azure-communication-callautomation

Concetti chiave

Nome	Descrizione
CallAutomationClient	`CallAutomationClient` è l'interfaccia primaria per gli sviluppatori che usano questa libreria client. Può essere usato per avviare chiamate da `createCall` o `answerCall`. Può essere usato anche per eseguire azioni di registrazione, ad esempio `startRecording`
CallConnectionClient	`CallConnectionClient` rappresenta una chiamata in corso. Dopo aver stabilito la chiamata con `createCall` o `answerCall`, è possibile eseguire altre azioni per la chiamata, ad esempio `transfer` o `play_media`.
Eventi di callback	Gli eventi di callback sono eventi inviati di nuovo durante la durata della chiamata. Fornisce informazioni e stato della chiamata, ad esempio `CallConnected`. `CallbackUrl` deve essere fornito durante `createCall` e `answerCall`, e gli eventi di callback verranno inviati a questo URL.
Evento di chiamata in ingresso	Quando si verifica una chiamata in ingresso (che può essere risposta con `answerCall`), verrà inviato l'evento eventgrid di chiamata in ingresso. Questo è diverso dagli eventi di Callback precedenti e deve essere configurato in portale di Azure. Per informazioni dettagliate, vedere Chiamata in ingresso .

Esempio

Inizializzare CallAutomationClient

from azure.communication.callautomation import (CallAutomationClient)

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

Creare una chiamata

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

Riprodurre supporti

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

Risoluzione dei problemi

Passaggi successivi

Commenti e suggerimenti

Se si verificano bug o suggerimenti, segnalare un problema nella sezione Problemi del progetto

Contributo

In questo progetto sono benvenuti i contributi e i suggerimenti. Per la maggior parte dei contenuti è necessario sottoscrivere un contratto di licenza di collaborazione (CLA, Contributor License Agreement) che stabilisce che l'utente ha il diritto di concedere, e di fatto concede a Microsoft i diritti d'uso del suo contributo. Per informazioni dettagliate, vedere https://cla.microsoft.com.

Quando si invia una richiesta pull, un bot CLA determina automaticamente se è necessario specificare un contratto CLA e completare la richiesta pull in modo appropriato (ad esempio con un'etichetta e un commento). Seguire le istruzioni specificate dal bot. È sufficiente eseguire questa operazione una sola volta per tutti i repository che usano il contratto CLA Microsoft.

Questo progetto ha adottato il [Codice di comportamento di Microsoft Open Source][code_of_conduct]. Per altre informazioni, vedere Code of Conduct FAQ (Domande frequenti sul Codice di comportamento) oppure contattare opencode@microsoft.com per eventuali altre domande o commenti.

Condividi tramite