Principais conceitos da API de Linha Direta 1.1

  • Artigo

Você pode ativar a comunicação entre seu bot e seu próprio aplicativo cliente usando a API de linha direta.

Importante

Este artigo apresenta os principais conceitos da API de Linha Direta 1.1 e fornece informações sobre recursos relevantes para desenvolvedores. Se você estiver criando uma nova conexão entre o aplicativo cliente e o bot, use Direct Line API 3.0.

Autenticação

As solicitações da Direct Line API 1.1 podem ser autenticadas usando um segredo obtido da página de configuração do canal da Direct Line no Portal do Azure ou usando um token que você obtém em runtime. Para obter mais informações, consulte 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.

Envio de mensagens

Usando a API de Linha Direta 1.1, um cliente pode enviar mensagens ao seu bot emitindo solicitações HTTP POST. Um cliente pode enviar uma mensagem única por solicitação. Para saber mais, veja Enviar uma mensagem para o bot.

Recebendo mensagens

Usando a API de Linha Direta 1.1, um cliente pode receber mensagens por meio da sondagem com solicitações HTTP GET. Em resposta a cada solicitação, um cliente poderá receber várias mensagens do bot como parte de um MessageSet. Para saber mais, veja Receber mensagens do bot.

Recursos para desenvolvedores

Biblioteca do cliente

A Estrutura de Bot fornece uma biblioteca de clientes que facilita o acesso à API de Linha Direta 1.1 por meio do C#. Para usar a biblioteca de clientes em um projeto do Visual Studio, instale o Microsoft.Bot.Connector.DirectLinepacote NuGet v1.x.

Como alternativa ao uso da biblioteca de clientes do C#, você pode gerar sua própria biblioteca de clientes na linguagem da sua preferência usando o arquivo Swagger da API de Linha Direta 1.1.