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

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

• Visão geral da Automação de Chamadas
• Conceito de chamada de entrada
• Criar um fluxo de trabalho de interação do cliente usando a Automação de Chamadas
• Redirecionar chamadas de telefonia de entrada com a Automação de Chamadas
• Conectar Serviços de Comunicação do Azure com os serviços de IA do Azure
• Guia de Início Rápido: ação de reprodução
• Guia de Início Rápido: Ação de reconhecimento
• Leia mais sobre Gravação de Chamadas no Serviços de Comunicação do Azure
• Gravar e baixar chamadas com a Grade de Eventos

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.