Compartilhar via

Conceitos principais no Direct Line API 3.0

  • Artigo

Você pode ativar a comunicação entre seu bot e seu próprio aplicativo cliente usando a API de linha direta. Este artigo apresenta os conceitos principais 3.0 de API de linha direta e fornece informações sobre recursos para desenvolvedores relevantes. Você pode criar um cliente usando o SDK, a API REST ou o Webchat.

Autenticação

As solicitações da API 3.0 do Direct Line podem ser autenticadas usando um segredo obtido na página de configuração do canal Direct Line no portal do Azure ou usando um token obtido em runtime. Para obter mais informações, confira Autenticação.

Iniciando uma conversa

As conversas de linha diretas explicitamente são abertas pelos clientes e podem ser executadas desde que o cliente e o bot participarem e tem credenciais válidas. Para saber mais, veja Iniciar uma conversa.

Enviar mensagens

Usando o Direct Line API 3.0, um cliente pode enviar mensagens para o bot emitindo solicitações HTTP POST. Um cliente pode enviar uma mensagem única por solicitação. Saiba mais em Enviar uma atividade para o bot.

Recebendo mensagens

Usando a linha API 3.0 direto, um cliente pode receber mensagens de seu bot via WebSocket transmitir ou emitindo HTTP GET solicitações. Usando qualquer uma dessas técnicas, um cliente pode receber várias mensagens do bot cada vez como parte de um ActivitySet. Para obter mais informações, consulte atividades de recebimento do bot.

Recursos para desenvolvedores

Bibliotecas de cliente

A estrutura de Bot fornece bibliotecas de cliente que facilitam o acesso à API de linha direta 3.0 por meio do c# e Node. js.

  • Para usar a biblioteca de clientes do .NET em um projeto do Visual Studio, instale o Microsoft.Bot.Connector.DirectLine pacote NuGet.s

  • Para usar a biblioteca de cliente do Node. js, instale o botframework-directlinejs biblioteca usando NPM (ou baixar o código-fonte).

Controle de webchat

O Bot Framework fornece um controle que permite incorporar um bot de linha direta em seu aplicativo cliente. Para obter mais informações, consulte o controle WebChat do Microsoft Bot Framework.