Registar um bot com a API de comunicações na cloud
Pode utilizar a API de comunicações na cloud no Microsoft Graph para criar bots para responder às necessidades dos seus clientes e facilitar a colaboração. Este artigo descreve como registar o bot e, em seguida, gerir o estado do bot.
Pré-requisitos
Antes de começar, familiarize-se com os seguintes tópicos:
- Microsoft Entra ID (Microsoft Entra ID) e como o serviço ajuda os funcionários a iniciar sessão e a aceder a recursos.
- O Azure Serviço de Bot e as suas capacidades.
Registar um bot
Os termos "aplicação de serviço" e "bot" podem ser utilizados alternadamente. Pode criar um bot através do portal do Azure diretamente ou registar um bot que não esteja alojado no Azure. Para obter mais informações, veja Registar um bot de chamada.
Para facilitar as coisas mais tarde, é útil compreender os diferentes tipos de permissões no Microsoft Entra ID. As aplicações com permissões delegadas requerem um utilizador com sessão iniciada. As permissões baseadas na aplicação não precisam de um utilizador com sessão iniciada e, muitas vezes, podem ser executadas como um serviço em segundo plano.
Depois de registar o bot, se quiser adicionar o bot ao Microsoft Teams, certifique-se de que compreende como utilizar o Portal do programador para equipas e definir os metadados necessários.
Gerir o estado do bot
Depois de registar o bot, decida se pretende que o suporte de dados baseado em áudio e vídeo seja alojado na aplicação ou alojado no serviço. A um nível elevado, isto envolve decidir se quer ou não aceder a uma transmissão em fluxo em direto de suportes de dados não processados.
Em seguida, pode decidir se o bot deve ter monitorização de estado ou sem estado.
Bots sem estado
Qualquer máquina virtual pode processar qualquer instância de bot, o que significa que, se uma máquina ficar inativa, outra pode tratar da mesma. Isto torna uma solução resiliente.
Por outro lado, uma cache partilhada, como o REDIS, tem de estar acessível a todas as máquinas virtuais.
Bots com monitorização de estado
Uma máquina virtual só pode processar uma instância de bot de cada vez. Uma vez que todos os estados estão num computador, não existem verificações de memória extra ou cache redis.
A desvantagem é que não é tão resiliente porque a instância do bot está apenas num computador.
Observação
Os bots de multimédia alojados no serviço podem ter monitorização de estado ou sem estado. Os bots de multimédia alojados na aplicação têm de ter monitorização de estado para utilizar o SDK do Bot Media.
Use os SDKs
Os seguintes SDKs estão disponíveis em C#. Forneceremos suporte para outros idiomas no futuro.
- Se estiver a utilizar bots sem estado , instale o SDK Graph Communications Core.
- Se estiver a utilizar bots com monitorização de estado , instale o SDK de Chamadas de Comunicações do Graph.
Exemplos
Saiba como implementar diferentes cenários com bots com monitorização de estado, como atender uma chamada recebida com suportes de dados alojados na aplicação ou alojados no serviço.
Para obter mais exemplos, veja o repositório de exemplos de Comunicações.
Privacidade e conformidade
Nos pedidos às nossas APIs, os dados confidenciais não devem ser enviados em IDs gerados do lado do cliente (como IDs de cenário, IDs de pedido ou outros IDs de correlação) em cabeçalhos ou no corpo do pedido. Estes IDs são registados no lado do servidor para diagnóstico.