Direct Line API 3.0'daki temel kavramlar

Direct Line API'sini kullanarak botunuzla kendi istemci uygulamanız arasında iletişimi etkinleştirebilirsiniz. Bu makalede, Direct Line API 3.0'daki temel kavramlar tanıtılarak ilgili geliştirici kaynakları hakkında bilgi sağlanır. SDK, REST API veya Web Sohbeti kullanarak bir istemci oluşturabilirsiniz.

Kimlik Doğrulaması

Direct Line API 3.0 istekleri, Azure portal Direct Line kanalı yapılandırma sayfasından aldığınız bir gizlidizi kullanılarak veya çalışma zamanında edindiğiniz bir belirteç kullanılarak doğrulanabilir. Daha fazla bilgi için bkz. Kimlik doğrulaması.

Konuşma başlatma

Direct Line konuşmalar istemciler tarafından açıkça açılır ve bot ve istemci katıldığı ve geçerli kimlik bilgilerine sahip olduğu sürece çalıştırılabilir. Daha fazla bilgi için bkz. Konuşma başlatma.

İleti gönderme

İstemci, Direct Line API 3.0'ı kullanarak istekler göndererek HTTP POST botunuza ileti gönderebilir. İstemci, istek başına tek bir ileti gönderebilir. Daha fazla bilgi için bkz. Bota etkinlik gönderme.

İleti alma

İstemci, Direct Line API 3.0'ı kullanarak botunuzdan akış yoluyla WebSocket veya istekler göndererek HTTP GET ileti alabilir. Bu tekniklerden birini kullanarak, bir istemci bir botun parçası ActivitySetolarak bottan aynı anda birden çok ileti alabilir. Daha fazla bilgi için bkz. Bottan etkinlik alma.

Geliştirici kaynakları

İstemci kitaplıkları

Bot Framework, C# ve Node.js aracılığıyla Direct Line API 3.0'a erişimi kolaylaştıran istemci kitaplıkları sağlar.

• Visual Studio projesinde .NET istemci kitaplığını kullanmak için NuGet paketini yükleyin.s Microsoft.Bot.Connector.DirectLine

• Node.js istemci kitaplığını kullanmak için NPM kullanarak kitaplığı yükleyin botframework-directlinejs (veya kaynağı indirin).

Web sohbeti denetimi

Bot Framework, istemci uygulamanıza Direct-Line destekli bir bot eklemenizi sağlayan bir denetim sağlar. Daha fazla bilgi için bkz. Microsoft Bot Framework WebChat denetimi.