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 ophaalt via de configuratiepagina van het Direct Line-kanaal in 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 verzenden naar uw bot door aanvragen uit te geven HTTP POST . Een client kan per aanvraag één bericht verzenden. Zie Een activiteit naar de bot verzenden voor meer informatie.

Berichten ontvangen

Met behulp van Direct Line API 3.0 kan een client berichten van uw bot ontvangen via WebSocket stream of door aanvragen uit te geven HTTP GET . 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.DirectLine NuGet-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 webchats

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