Bibliothèque de client Azure Communication Call Automation pour Python - version 1.1.0

Article
11/23/2023

Ce package contient un Kit de développement logiciel (SDK) Python pour Azure Communication Call Automation. L’automatisation des appels offre aux développeurs la possibilité de créer des flux de travail d’appels intelligents basés sur le serveur et l’enregistrement des appels pour les canaux vocaux et RTC.

Vue d’ensemble de l’automatisation des appels | Documentation produit

Clause d’exclusion de responsabilité

La prise en charge des packages Python du SDK Azure pour Python 2.7 a pris fin le 1er janvier 2022. Pour obtenir plus d’informations et poser des questions, reportez-vous à https://github.com/Azure/azure-sdk-for-python/issues/20691

Prise en main

Prérequis

Python 3.7 ou version ultérieure est requis pour utiliser ce package.
Vous avez besoin d’un abonnement Azure pour utiliser ce package.
Une ressource Communication Services déployée. Vous pouvez utiliser le portail Azure ou le Azure PowerShell pour le configurer.

Installation de

Installez le Kit de développement logiciel (SDK) Azure Communication Service Call Automation.

pip install azure-communication-callautomation

Concepts clés

Nom	Description
CallAutomationClient	`CallAutomationClient` est l’interface principale pour les développeurs qui utilisent cette bibliothèque cliente. Il peut être utilisé pour lancer des appels par `createCall` ou `answerCall`. Il peut également être utilisé pour effectuer des actions d’enregistrement telles que `startRecording`
CallConnectionClient	`CallConnectionClient` représente un appel en cours. Une fois l’appel établi avec `createCall` ou `answerCall`, d’autres actions peuvent être effectuées pour l’appel, telles que `transfer` ou `play_media`.
Événements de rappel	Les événements de rappel sont des événements renvoyés pendant la durée de l’appel. Il fournit des informations et l’état de l’appel, tels que `CallConnected`. `CallbackUrl` doivent être fournis pendant `createCall` et `answerCall`, et les événements de rappel seront envoyés à cette URL.
Événement d’appel entrant	Lorsque l’appel entrant se produit (auquel vous pouvez répondre avec `answerCall`), l’événement eventgrid d’appel entrant est envoyé. Cela est différent des événements de rappel ci-dessus et doit être configuré sur Portail Azure. Pour plus d’informations, consultez Appel entrant .

Exemples

Initialiser CallAutomationClient

from azure.communication.callautomation import (CallAutomationClient)

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

Créer un appel

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

Lire le mé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)

Dépannage

Étapes suivantes

Fournir des commentaires

Si vous rencontrez des bogues ou si vous avez des suggestions, veuillez déposer un problème dans la section Problèmes du projet

Contribution

Ce projet accepte les contributions et les suggestions. La plupart des contributions vous demandent d’accepter un contrat de licence de contribution (CLA) déclarant que vous avez le droit de nous accorder, et que vous nous accordez réellement, les droits d’utilisation de votre contribution. Pour plus d’informations, visitez https://cla.microsoft.com.

Quand vous envoyez une demande de tirage (pull request), un bot CLA détermine automatiquement si vous devez fournir un contrat CLA et agrémenter la demande de tirage de façon appropriée (par exemple, avec une étiquette ou un commentaire). Suivez simplement les instructions fournies par le bot. Vous ne devez effectuer cette opération qu’une seule fois sur tous les dépôts utilisant notre contrat CLA.

Ce projet a adopté le [Code de conduite Open Source Microsoft][code_of_conduct]. Pour plus d’informations, consultez la FAQ sur le code de conduite ou contactez opencode@microsoft.com pour toute question ou tout commentaire supplémentaire.

Partager via