Biblioteca cliente de Azure Communication Call Automation para Python: versión 1.1.0

Este paquete contiene un SDK de Python para Azure Communication Call Automation. La automatización de llamadas proporciona a los desarrolladores la capacidad de crear flujos de trabajo de llamadas inteligentes, basados en servidor y grabación de llamadas para canales RTC y voz.

Introducción a la automatización | de llamadasDocumentación del producto

Declinación de responsabilidades

Los paquetes de Python del SDK de Azure admiten Python 2.7 finalizó el 01 de enero de 2022. Para más información y preguntas, consulte https://github.com/Azure/azure-sdk-for-python/issues/20691.

Introducción

Requisitos previos

• Se requiere Python 3.7 o posterior para usar este paquete.
• Necesita una suscripción de Azure para usar este paquete.
• Un recurso de Communication Services implementado. Puede usar Azure Portal o el Azure PowerShell para configurarlo.

Instalación de

Instale el SDK de Automatización de llamadas de Azure Communication Service.

pip install azure-communication-callautomation

Conceptos clave

Nombre	Descripción
CallAutomationClient	CallAutomationClient es la interfaz principal para los desarrolladores que usan esta biblioteca cliente. Se puede usar para iniciar llamadas mediante createCall o answerCall. También se puede usar para realizar acciones de grabación, como startRecording
CallConnectionClient	CallConnectionClient representa una llamada en curso. Una vez establecida la llamada con createCall o answerCall, se pueden realizar otras acciones para la llamada, como transfer o play_media.
Eventos de devolución de llamada	Los eventos de devolución de llamada son eventos enviados durante la duración de la llamada. Proporciona información y estado de la llamada, como CallConnected. CallbackUrl debe proporcionarse durante createCall y answerCall, y los eventos de devolución de llamada se enviarán a esta dirección URL.
Evento de llamada entrante	Cuando se produce una llamada entrante (que se puede responder con answerCall), se enviará el evento eventgrid de llamada entrante. Esto es diferente de los eventos de devolución de llamada anteriores y debe configurarse en Azure Portal. Consulte Llamada entrante para obtener más información.

Ejemplos

Inicializar CallAutomationClient

from azure.communication.callautomation import (CallAutomationClient)

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

Crear llamada

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

Reproducir elementos multimedia

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

Solución de problemas

Pasos siguientes

• Información general sobre la automatización de llamadas
• Concepto de llamada entrante
• Creación de un flujo de trabajo de interacción del cliente mediante Automatización de llamadas
• Redireccionamiento de llamadas entrantes de telefonía con la automatización de llamadas
• Conexión de Azure Communication Services con servicios de Azure AI
• Inicio rápido: Acción de reproducción
• Inicio rápido: Reconocer acción
• Obtenga más información sobre la grabación de llamadas en Azure Communication Services
• Grabación y descarga de llamadas con Event Grid

Envío de comentarios

Si encuentra algún error o tiene sugerencias, envíe un problema en la sección Problemas del proyecto.

Contribuciones

Este proyecto agradece las contribuciones y sugerencias. La mayoría de las contribuciones requieren que acepte un Contrato de licencia para el colaborador (CLA) que declara que tiene el derecho a concedernos y nos concede los derechos para usar su contribución. Para más detalles, visite https://cla.microsoft.com.

Cuando se envía una solicitud de incorporación de cambios, un bot de CLA determinará de forma automática si tiene que aportar un CLA y completar la PR adecuadamente (por ejemplo, la etiqueta, el comentario). Solo siga las instrucciones que le dará el bot. Solo será necesario que lo haga una vez en todos los repositorios con nuestro CLA.

Este proyecto ha adoptado el [Código de conducta de código abierto de Microsoft][code_of_conduct]. Para obtener más información, vea las preguntas más frecuentes sobre el código de conducta o póngase en contacto con opencode@microsoft.com si tiene preguntas o comentarios.