Principais conceitos na Direct Line API 3.0
Você pode habilitar a comunicação entre seu bot e seu próprio aplicativo cliente usando a API de Linha Direta. Este artigo apresenta conceitos-chave na API de Linha Direta 3.0 e fornece informações sobre recursos relevantes do desenvolvedor. Você pode criar um cliente usando o SDK, REST API ou Web Chat.
Autenticação
As solicitações da API de Linha Direta 3.0 podem ser autenticadas usando um segredo obtido na página de configuração do canal da Linha Direta no portal do Azure ou usando um token obtido em tempo de execução. Para obter mais informações, veja Autenticação.
Iniciar uma conversa
As conversas de Linha Direta são explicitamente abertas pelos clientes e podem ser executadas desde que o bot e o cliente participem e tenham credenciais válidas. Para obter mais informações, consulte Iniciar uma conversa.
Enviar mensagens
Usando a API de Linha Direta 3.0, um cliente pode enviar mensagens para seu bot emitindo HTTP POST solicitações. Um cliente pode enviar uma única mensagem por solicitação. Para obter mais informações, consulte Enviar uma atividade para o bot.
Receber mensagens
Usando a API de Linha Direta 3.0, um cliente pode receber mensagens do seu bot via WebSocket stream ou emitindo HTTP GET solicitações. Usando qualquer uma dessas técnicas, um cliente pode receber várias mensagens do bot ao mesmo tempo como parte de um ActivitySetarquivo . Para obter mais informações, consulte Receber atividades do bot.
Recursos para programadores
Bibliotecas de cliente
O Bot Framework fornece bibliotecas de cliente que facilitam o acesso à API de Linha Direta 3.0 via C# e Node.js.
Para usar a biblioteca de cliente .NET em um projeto do Visual Studio, instale o
Microsoft.Bot.Connector.DirectLinepacote NuGet.sPara usar a biblioteca de cliente Node.js, instale a biblioteca usando o
botframework-directlinejsNPM (ou baixe a fonte).
Controle de bate-papo na Web
O Bot Framework fornece um controle que permite incorporar um bot alimentado por linha direta em seu aplicativo cliente. Para obter mais informações, consulte o controle Microsoft Bot Framework WebChat.