Bagikan melalui

Konsep utama dalam Direct Line API 3.0

  • Artikel

Anda dapat mengaktifkan komunikasi antara bot dan aplikasi klien Anda sendiri dengan menggunakan Direct Line API. Artikel ini memperkenalkan konsep utama di Direct Line API 3.0 dan menyediakan informasi tentang sumber daya pengembang yang relevan. Anda dapat membangun klien menggunakan SDK, REST API, atau Web Chat.

Autentikasi

Permintaan Direct Line API 3.0 dapat diautentikasi baik dengan menggunakan rahasia yang Anda peroleh dari halaman konfigurasi saluran Direct Line di portal Azure atau dengan menggunakan token yang Anda peroleh saat runtime. Untuk informasi lebih lanjut, lihat Autentikasi.

Memulai percakapan

Percakapan Direct Line secara eksplisit dibuka oleh klien dan dapat berjalan selama bot dan klien berpartisipasi dan memiliki kredensial yang valid. Untuk informasi selengkapnya, lihat Memulai percakapan.

Mengirim pesan

Dengan menggunakan Direct Line API 3.0, klien dapat mengirim pesan ke bot Anda dengan mengeluarkan HTTP POST permintaan. Klien dapat mengirim satu pesan per permintaan. Untuk informasi selengkapnya, lihat Mengirim aktivitas ke bot.

Menerima pesan

Dengan menggunakan Direct Line API 3.0, klien dapat menerima pesan dari bot Anda baik melalui WebSocket streaming atau dengan mengeluarkan HTTP GET permintaan. Menggunakan salah satu teknik ini, klien dapat menerima beberapa pesan dari bot pada satu waktu sebagai bagian ActivitySetdari . Untuk informasi selengkapnya, lihat Menerima aktivitas dari bot.

Sumber daya pengembang

Pustaka klien

Bot Framework menyediakan pustaka klien yang memfasilitasi akses ke Direct Line API 3.0 melalui C# dan Node.js.

  • Untuk menggunakan pustaka klien .NET dalam proyek Visual Studio, instal Microsoft.Bot.Connector.DirectLine paket NuGet.s

  • Untuk menggunakan pustaka klien Node.js, instal pustaka menggunakan NPM (atau unduh sumbernya).botframework-directlinejs

Kontrol obrolan web

Bot Framework menyediakan kontrol yang memungkinkan Anda menyematkan bot yang didukung Direct-Line ke dalam aplikasi klien Anda. Untuk informasi selengkapnya, lihat kontrol Microsoft Bot Framework WebChat.