Biblioteca de clientes da Automação de Chamadas de Comunicação do Azure para Python – versão 1.1.0

Artigo
11/29/2023

Este pacote contém um SDK do Python para Automação de Chamadas de Comunicação do Azure. A Automação de Chamadas fornece aos desenvolvedores a capacidade de criar fluxos de trabalho de chamadas inteligentes e baseados em servidor e gravação de chamadas para canais de voz e PSTN.

Visão geral da Automação | de ChamadasDocumentação do produto

Aviso de isenção de responsabilidade

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

Introdução

Pré-requisitos

É necessário ter o Python 3.7 ou posterior para usar esse pacote.
Você precisa de uma assinatura do Azure para usar esse pacote.
Um recurso dos Serviços de Comunicação implantado. Você pode usar o Portal do Azure ou o Azure PowerShell para configurá-lo.

Instalando o

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

pip install azure-communication-callautomation

Principais conceitos

Name	Descrição
CallAutomationClient	`CallAutomationClient` é a interface principal para desenvolvedores que usam essa biblioteca de clientes. Ele pode ser usado para iniciar chamadas por `createCall` ou `answerCall`. Ele também pode ser usado para executar ações de gravação, como `startRecording`
CallConnectionClient	`CallConnectionClient` representa uma chamada em andamento. Depois que a chamada for estabelecida com `createCall` ou `answerCall`, outras ações poderão ser executadas para a chamada, como `transfer` ou `play_media`.
Eventos de retorno de chamada	Eventos de retorno de chamada são eventos enviados de volta durante a duração da chamada. Ele fornece informações e o estado da chamada, como `CallConnected`. `CallbackUrl` deve ser fornecido durante `createCall` e `answerCall`, e os eventos de retorno de chamada serão enviados para essa URL.
Evento de chamada de entrada	Quando a chamada de entrada ocorrer (que pode ser atendida com `answerCall`), o evento eventgrid de chamada de entrada será enviado. Isso é diferente dos eventos de retorno de chamada acima e deve ser configurado no portal do Azure. Consulte Chamada de entrada 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 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)

Solução de problemas

Próximas etapas

Forneça comentários

Se você encontrar bugs ou tiver sugestões, registre um problema na seção Problemas do projeto

Contribuição

Este projeto aceita contribuições e sugestões. A maioria das contribuições exige que você concorde com um CLA (Contrato de Licença do Colaborador) declarando que você tem o direito de nos conceder, e de fato concede, os direitos de usar sua contribuição. Para obter detalhes, visite https://cla.microsoft.com.

Quando você envia uma solicitação de pull, um bot do CLA determina automaticamente se você precisa fornecer um CLA e preencher a PR corretamente (por exemplo, rótulo, comentário). Basta seguir as instruções fornecidas pelo bot. Você só precisará fazer isso uma vez em todos os repositórios que usam nosso CLA.

Este projeto adotou o [Código de Conduta de Software Livre da Microsoft][code_of_conduct]. Para saber mais, confira as Perguntas frequentes sobre o Código de Conduta ou contate o opencode@microsoft.com caso tenha outras dúvidas ou comentários.

Compartilhar via