Belangrijkste concepten in Direct Line API 1.1

U kunt communicatie tussen uw bot en uw eigen clienttoepassing inschakelen met behulp van de Direct Line-API.

Belangrijk

In dit artikel worden belangrijke concepten in Direct Line API 1.1 geïntroduceerd en vindt u informatie over relevante ontwikkelaarsbronnen. Als u een nieuwe verbinding maakt tussen uw clienttoepassing en bot, gebruikt u in plaats daarvan Direct Line API 3.0 .

Verificatie

Direct Line API 1.1-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 1.1 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 bericht verzenden naar de bot voor meer informatie.

Berichten ontvangen

Met behulp van Direct Line API 1.1 kan een client berichten ontvangen door te peilen met HTTP GET aanvragen. Als reactie op elke aanvraag kan een client meerdere berichten van de bot ontvangen als onderdeel van een MessageSet. Zie Berichten ontvangen van de bot voor meer informatie.

Bronnen voor ontwikkelaars

Clientbibliotheek

Bot Framework biedt een clientbibliotheek die de toegang tot Direct Line API 1.1 via C# vergemakkelijkt. Als u de clientbibliotheek in een Visual Studio-project wilt gebruiken, installeert u het Microsoft.Bot.Connector.DirectLine nuGet-pakket v1.x.

Als alternatief voor het gebruik van de C#-clientbibliotheek kunt u uw eigen clientbibliotheek genereren in de taal van uw keuze met behulp van het Swagger-bestand direct line-API 1.1.