Viktiga begrepp i Direct Line API 1.1

Du kan aktivera kommunikation mellan din robot och ditt eget klientprogram med hjälp av Direct Line-API:et.

Viktigt!

Den här artikeln beskriver viktiga begrepp i Direct Line API 1.1 och innehåller information om relevanta utvecklarresurser. Om du skapar en ny anslutning mellan klientprogrammet och roboten använder du Direct Line API 3.0 i stället.

Autentisering

Direktrads-API 1.1-begäranden kan autentiseras antingen med hjälp av en hemlighet som du hämtar från konfigurationssidan för Direct Line-kanalen i Azure-portalen eller med hjälp av en token som du får vid körning. Mer information finns i Autentisering.

Starta en konversation

Direct Line-konversationer öppnas uttryckligen av klienter och kan köras så länge roboten och klienten deltar och har giltiga autentiseringsuppgifter. Mer information finns i Starta en konversation.

Skicka meddelanden

Med Direct Line API 1.1 kan en klient skicka meddelanden till din robot genom att utfärda HTTP POST begäranden. En klient kan skicka ett enda meddelande per begäran. Mer information finns i Skicka ett meddelande till roboten.

Ta emot meddelanden

Med direktrads-API 1.1 kan en klient ta emot meddelanden genom att avsöka med HTTP GET begäranden. Som svar på varje begäran kan en klient ta emot flera meddelanden från roboten som en del av en MessageSet. Mer information finns i Ta emot meddelanden från roboten.

Resurser för utvecklare

Klientbibliotek

Bot Framework tillhandahåller ett klientbibliotek som underlättar åtkomsten till Direct Line API 1.1 via C#. Om du vill använda klientbiblioteket i ett Visual Studio-projekt installerar Microsoft.Bot.Connector.DirectLine du nuGet-paketet v1.x.

Som ett alternativ till att använda C#-klientbiblioteket kan du generera ett eget klientbibliotek på det språk du väljer med hjälp av Swagger-filen Direct Line API 1.1.