Começar a trabalhar com comunicações na nuvemGet started with cloud communications

As APIs de comunicações na nuvem no Microsoft Graph adicionam uma nova dimensão à forma como seus aplicativos e serviços interagem com os usuários por meio de vários recursos relacionados à comunicação, como chamada e reuniões online.The cloud communications APIs in Microsoft Graph add a new dimension to how your apps and services interact with users through various communications related features, such as calling and online meetings. Este artigo descreve como você pode usar bots para responder às necessidades de seus clientes e facilitar a colaboração.This article describes how you can use bots to respond to your customers' needs and facilitate collaboration.

Pré-requisitosPrerequisites

Se você começar, será útil se familiarizar com o seguinte:Beore you get started, it will be helpful to familiarize yourself with the following:

Registrar um botRegister a bot

Os termos "aplicativo de serviço" e "bot" podem ser usados de forma intercambiável.The terms "service application" and "bot" can be used interchangeably. Você pode criar um bot por meio do portal do Azure diretamente ou registrar um bot que não está hospedado no Azure.You can either create a bot through the Azure portal directly or register a bot that isn't hosted on Azure. Para obter mais detalhes sobre o processo de registro do bot, consulte Registrando um bot de chamada.For more details about the bot registration process, see Registering a calling bot.

Para facilitar as coisas mais tarde, é útil entender os diferentes tipos de permissões no Azure AD.To make things easier later, it's helpful to understand the different types of permissions within Azure AD. Os aplicativos com permissões delegadas exigem um usuário in-locar.Apps with delegated permissions require a signed-in user. As permissões baseadas em aplicativos não precisam de um usuário in-locado e geralmente podem ser executados como um serviço em segundo plano.Application-based permissions don't need a signed-in user, and can often run as a background service.

Depois de registrar seu bot, se quiser adicionar seu bot ao Microsoft Teams,entenda como usar o app studio e defina os metadados necessários.After you register your bot, if you'd like to add your bot to Microsoft Teams, make sure you understand how to use app studio and define the required metadata.

Gerenciar o estado do botManage the state of the bot

Depois de registrar seu bot, decida se deseja que sua mídia baseada em áudio e vídeo seja hospedada pelo aplicativo ou pelo serviço.After you register your bot, decide whether you want your audio and video-based media to be application-hosted or service-hosted. Em um nível alto, isso envolve decidir se você deseja ou não acessar um fluxo ao vivo de mídia bruta.At a high level, this involves deciding whether or not you want to access a live-stream of raw media.

Em seguida, você pode decidir se é melhor para o bot ser stateful ou stateless.Next, you can decide whether it's best for your bot to be stateful or stateless.

Bots sem estadoStateless bots

Qualquer máquina virtual pode manipular qualquer instância de bot, o que significa que, se uma máquina cair, outra poderá cuidar dela.Any virtual machine can handle any bot instance, which means that if one machine goes down, another can take care of it. Isso torna uma solução resiliente.This makes for a resilient solution.

Por outro lado, um cache compartilhado, como REDIS, precisa estar acessível a todas as máquinas virtuais.On the other hand, a shared cache, such as REDIS, needs to be accessible to all the virtual machines.

Bots statefulStateful bots

Uma máquina virtual pode manipular apenas uma instância de bot por vez.A virtual machine can handle only one bot instance at a time. Como todos os estados estão em um computador, não há nenhuma verificação de memória extra ou verificações de cache REDIS.Because all the states are on one machine, there aren't any extra memory checks or REDIS cache checks.

A desvantagem é que, como a instância do bot está apenas em um computador, ela não é tão resiliente.The drawback is that because the bot instance is just on one machine, it isn't as resilient.

Observação: Os bots de mídia hospedados pelo serviço podem ser stateful ou stateless.Note: Service-hosted media bots can be stateful or stateless. Os bots de mídia hospedados pelo aplicativo devem ter estado para usar o SDKde Mídia bot .Application-hosted media bots must be stateful in order to use the Bot Media SDK.

Use os SDKsUse the SDKs

Os SDKs a seguir estão disponíveis no C#.The following SDKs are available in C#. Forneceremos suporte para outros idiomas no futuro.We will provide support for other languages in the future.

ExemplosExamples

Saiba como implementar diferentes cenários usando bots de estado, como atender uma chamada de entrada com mídia hospedada por aplicativo ou hospedada pelo serviço.Learn how to implement different scenarios using stateful bots, such as answering an incoming call with either application-hosted or service-hosted media.

Para obter mais exemplos, consulte o repositório de exemplos de comunicações.For more examples, see the Communications samples repository.

Privacidade e conformidadePrivacy and compliance

Nas solicitações para nossas APIs, os 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) nos headers ou no corpo da solicitação.In the requests to our APIs, sensitive data should not be sent in any client-side generated IDs (such as scenario IDs, request IDs, or other correlation IDs) in headers or the request body. Essas IDs serão registradas no lado do servidor para diagnóstico.These IDs will be logged on the server side for diagnostics.