Biblioteca de cliente da Automatização de Chamadas de Comunicação do Azure para Python – versão 1.1.0

Artigo
11/23/2023

Este pacote contém um SDK Python para a Automatização de Chamadas de Comunicação do Azure. A Automatização de Chamadas fornece aos programadores a capacidade de criar fluxos de trabalho de chamadas inteligentes e baseados em servidores e gravar chamadas para canais de voz e RTPC.

Descrição geral da Automatização de Chamadas | Documentação do produto

Exclusão de Responsabilidade

O suporte de pacotes Python do SDK do Azure para Python 2.7 terminou a 01 de janeiro de 2022. Para obter mais informações e perguntas, consulte https://github.com/Azure/azure-sdk-for-python/issues/20691

Introdução

Pré-requisitos

O Python 3.7 ou posterior é necessário para utilizar este pacote.
Precisa de uma subscrição do Azure para utilizar este pacote.
Um recurso dos Serviços de Comunicação implementado. Pode utilizar o Portal do Azure ou o Azure PowerShell para configurá-lo.

Instalação

Instale o SDK de Automatização de Chamadas do Serviço de Comunicação do Azure.

pip install azure-communication-callautomation

Conceitos-chave

Nome	Descrição
CallAutomationClient	`CallAutomationClient` é a interface principal para programadores que utilizam esta biblioteca de cliente. Pode ser utilizado para iniciar chamadas por `createCall` ou `answerCall`. Também pode ser utilizado para efetuar ações de gravação, como `startRecording`
CallConnectionClient	`CallConnectionClient` representa uma chamada em curso. Assim que a chamada for estabelecida com `createCall` ou `answerCall`, podem ser realizadas outras ações para a chamada, como `transfer` ou `play_media`.
Eventos de Chamada de Retorno	Os eventos de chamada de retorno são eventos enviados durante a chamada. Fornece informações e estado da chamada, como `CallConnected`. `CallbackUrl` tem de ser fornecido durante `createCall` e `answerCall`, e os eventos de chamada de retorno serão enviados para este URL.
Evento de Chamada recebida	Quando a chamada recebida ocorrer (que pode ser atendida com `answerCall`), o evento eventgrid de chamada recebida será enviado. Isto é diferente dos eventos de Chamada de Retorno acima e deve ser configurado no portal do Azure. Consulte Chamada recebida para obter detalhes.

Exemplos

Inicializar CallAutomationClient

from azure.communication.callautomation import (CallAutomationClient)

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

Criar Chamada

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

Reproduzir Multimé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)

Resolução de problemas

Passos seguintes

Enviar Comentários

Se encontrar erros ou tiver sugestões, submeta um problema na secção Problemas do projeto

Contribuir

Agradecemos todas as contribuições e sugestões para este projeto. A maioria das contribuições requerem que celebre um Contrato de Licença de Contribuição (CLA) no qual se declare que tem o direito de conceder e que, na verdade, concede-nos os direitos para utilizar a sua contribuição. Para mais detalhes, visite https://cla.microsoft.com.

Quando submete um pedido Pull, um bot do CLA determina automaticamente se tem de fornecer um CLA e decorar o PR de forma adequada (por exemplo, etiqueta, comentário). Só tem de seguir as instruções fornecidas pelo bot. Apenas terá de fazer isto uma vez em todos os repositórios com o nosso CLA.

Este projeto adotou o [Código de Conduta do Microsoft Open Source][code_of_conduct]. Para obter mais informações, veja a Code of Conduct FAQ (FAQ do Código de Conduta) ou envie um e-mail para opencode@microsoft.com com quaisquer perguntas ou comentários adicionais.

Partilhar via