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.s

• Para usar a biblioteca de cliente Node.js, instale a biblioteca usando o botframework-directlinejs NPM (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.