Registrar um bot com a API de comunicações de nuvem
Você pode usar a API de comunicações de nuvem no Microsoft Graph para criar bots para responder às necessidades de seus clientes e facilitar a colaboração. Este artigo descreve como registrar seu bot e, em seguida, gerenciar 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 entrar e acessar recursos.
- O Azure Serviço de Bot e suas funcionalidades.
Registrar um bot
Os termos "aplicativo de serviço" e "bot" podem ser usados de forma intercambiável. Você pode criar um bot por meio do portal do Azure diretamente ou registrar um bot que não está hospedado no Azure. Para obter mais informações, consulte Registrar um bot de chamada.
Para facilitar as coisas mais tarde, é útil entender os diferentes tipos de permissões dentro de Microsoft Entra ID. Aplicativos com permissões delegadas exigem um usuário conectado. As permissões baseadas em aplicativo não precisam de um usuário conectado e geralmente podem ser executadas como um serviço em segundo plano.
Depois de registrar seu bot, se quiser adicionar seu bot ao Microsoft Teams, entenda como usar o portal do Desenvolvedor para equipes e defina os metadados necessários.
Gerenciar o estado do bot
Depois de registrar seu bot, decida se deseja que sua mídia baseada em áudio e vídeo seja hospedada por aplicativo ou hospedada em serviço. Em alto nível, isso envolve decidir se você quer ou não acessar uma transmissão ao vivo de mídia bruta.
Em seguida, você pode decidir se seu bot deve ser com estado ou sem estado.
Bots sem estado
Qualquer máquina virtual pode lidar com qualquer instância de bot, o que significa que, se uma máquina cair, outra poderá cuidar dela. Isso torna uma solução resiliente.
Por outro lado, um cache compartilhado, como o REDIS, precisa estar acessível a todas as máquinas virtuais.
Bots com estado
Uma máquina virtual pode manipular apenas uma instância de bot por vez. Como todos os estados estão em um computador, não há nenhuma verificação de memória extra ou cache REDIS.
A desvantagem é que ele não é tão resiliente porque a instância do bot está apenas em um computador.
Observação
Os bots de mídia hospedados pelo serviço podem ser com estado ou sem estado. Os bots de mídia hospedados pelo aplicativo devem ter estado para usar o SDK do Bot Media.
Use os SDKs
Os SDKs a seguir estão disponíveis em C#. Forneceremos suporte para outros idiomas no futuro.
- Se você estiver usando bots sem estado , instale o SDK do Graph Communications Core.
- Se você estiver usando bots com estado , instale o SDK de Chamada de Comunicações do Graph.
Exemplos
Saiba como implementar diferentes cenários usando bots com estado, como responder a uma chamada de entrada com mídia hospedada por aplicativo ou hospedada pelo serviço.
Para obter mais exemplos, consulte o repositório de exemplos de comunicações.
Privacidade e conformidade
Nas solicitações para nossas APIs, dados confidenciais não devem ser enviados em IDs geradas no lado do cliente (como IDs de cenário, IDs de solicitação ou outras IDs de correlação) em cabeçalhos ou no corpo da solicitação. Essas IDs são registradas no lado do servidor para diagnóstico.