Delen via

Belangrijke concepten in Direct Line API 3.0

  • Artikel

U kunt communicatie tussen uw bot en uw eigen clienttoepassing inschakelen met behulp van de Direct Line-API. In dit artikel worden belangrijke concepten in Direct Line API 3.0 geïntroduceerd en vindt u informatie over relevante resources voor ontwikkelaars. U kunt een client bouwen met behulp van de SDK, REST API of Webchat.

Verificatie

Direct Line API 3.0-aanvragen kunnen worden geverifieerd met behulp van een geheim dat u verkrijgt op de configuratiepagina van het Direct Line-kanaal in de Azure Portal of met behulp van een token dat u tijdens runtime verkrijgt. Zie Verificatie voor meer informatie.

Een gesprek starten

Direct Line gesprekken worden expliciet geopend door clients en kunnen worden uitgevoerd zolang de bot en client deelnemen en geldige referenties hebben. Zie Een gesprek starten voor meer informatie.

Berichten verzenden

Met behulp van Direct Line API 3.0 kan een client berichten naar uw bot verzenden door aanvragen te verzendenHTTP POST. Een client kan één bericht per aanvraag verzenden. Zie Een activiteit naar de bot verzenden voor meer informatie.

Berichten ontvangen

Met Direct Line API 3.0 kan een client berichten van uw bot ontvangen via WebSocket stream of door het verzenden van HTTP GET aanvragen. Met behulp van een van deze technieken kan een client meerdere berichten van de bot tegelijk ontvangen als onderdeel van een ActivitySet. Zie Activiteiten ontvangen van de bot voor meer informatie.

Bronnen voor ontwikkelaars

Clientbibliotheken

Bot Framework biedt clientbibliotheken die de toegang tot Direct Line API 3.0 via C# en Node.js vergemakkelijken.

  • Als u de .NET-clientbibliotheek in een Visual Studio-project wilt gebruiken, installeert u het Microsoft.Bot.Connector.DirectLineNuGet-pakket.s

  • Als u de Node.js-clientbibliotheek wilt gebruiken, installeert u de botframework-directlinejs bibliotheek met behulp van NPM (of downloadt u de bron).

Besturingselement voor webchat

Het Bot Framework biedt een besturingselement waarmee u een direct-line-bot kunt insluiten in uw clienttoepassing. Zie het besturingselement Microsoft Bot Framework WebChat voor meer informatie.