Concetti chiave sull'API Direct Line 3.0Key concepts in Direct Line API 3.0

Usando l'API Direct Line è possibile consentire la comunicazione tra il bot e l'applicazione client.You can enable communication between your bot and your own client application by using the Direct Line API. Questo articolo illustra i concetti chiave sull'API Direct Line 3.0 e fornisce informazioni sulle relative risorse per sviluppatori.This article introduces key concepts in Direct Line API 3.0 and provides information about relevant developer resources.

AuthenticationAuthentication

Le richieste dell'API Direct Line 3.0 possono essere autenticate usando un segreto che si ottiene dalla pagina di configurazione del canale Direct Line nel portale di Bot Framework o un token che si ottiene in fase di esecuzione.Direct Line API 3.0 requests can be authenticated either by using a secret that you obtain from the Direct Line channel configuration page in the Bot Framework Portal or by using a token that you obtain at runtime. Per altre informazioni, vedere Autenticazione.For more information, see Authentication.

Avviare una conversazioneStarting a conversation

Le conversazioni Direct Line vengono aperte esplicitamente dai client e possono essere eseguite fintanto che il bot e il client partecipano e hanno credenziali valide.Direct Line conversations are explicitly opened by clients and may run as long as the bot and client participate and have valid credentials. Per altre informazioni, vedere Avviare una conversazione.For more information, see Start a conversation.

Invio di messaggiSending messages

Con l'API Direct Line 3.0, un client può inviare messaggi al bot inviando delle richieste HTTP POST.Using Direct Line API 3.0, a client can send messages to your bot by issuing HTTP POST requests. I client possono inviare un solo messaggio per richiesta.A client may send a single message per request. Per altre informazioni, vedere Inviare un'attività al bot.For more information, see Send an activity to the bot.

Ricezione di messaggiReceiving messages

Con l'API Direct Line 3.0, un client può ricevere messaggi dal bot tramite il flusso WebSocket o inviando delle richieste HTTP GET.Using Direct Line API 3.0, a client can receive messages from your bot either via WebSocket stream or by issuing HTTP GET requests. Usando una di queste due tecniche, un client può ricevere più messaggi dal bot alla volta nell'ambito di un ActivitySet.Using either of these techniques, a client may receive multiple messages from the bot at a time as part of an ActivitySet. Per altre informazioni, vedere Ricevere attività dal bot.For more information, see Receive activities from the bot.

Risorse per sviluppatoriDeveloper resources

Librerie clientClient libraries

Bot Framework fornisce librerie client che facilitano l'accesso all'API Direct Line 3.0 con C# e Node.js.The Bot Framework provides client libraries that facilitate access to Direct Line API 3.0 via C# and Node.js.

  • Per usare la libreria client .NET in un progetto di Visual Studio, installare il pacchetto NuGet Microsoft.Bot.Connector.DirectLine.To use the .NET client library within a Visual Studio project, install the Microsoft.Bot.Connector.DirectLine NuGet package.

  • Per usare la libreria client Node.js, installare la libreria botframework-directlinejsusando NPM (o scaricare il codice sorgente).To use the Node.js client library, install the botframework-directlinejs library using NPM (or download the source).

Codice di esempioSample code

Il repository di GitHub BotBuilder-Samples contiene più esempi che illustrano come usare l'API Direct Line 3.0 con C# e Node.js.The BotBuilder-Samples GitHub repo contains multiple samples that show how to use Direct Line API 3.0 with C# and Node.js.

EsempioSample LinguaggioLanguage DESCRIZIONEDescription
Esempio di bot Direct LineDirect Line Bot Sample C#C# Bot di esempio e client personalizzato che comunicano tra loro usando l'API Direct Line.A sample bot and a custom client communicating to each other using the Direct Line API.
Esempio di bot Direct Line (con WebSocket client)Direct Line Bot Sample (using client WebSockets) C#C# Bot di esempio e client personalizzato che comunicano tra loro usando l'API Direct Line e WebSocket.A sample bot and a custom client communicating to each other using the Direct Line API and WebSockets.
Esempio di bot Direct LineDirect Line Bot Sample JavaScriptJavaScript Bot di esempio e client personalizzato che comunicano tra loro usando l'API Direct Line.A sample bot and a custom client communicating to each other using the Direct Line API.
Esempio di bot Direct Line (con WebSocket client)Direct Line Bot Sample (using client WebSockets) JavaScriptJavaScript Bot di esempio e client personalizzato che comunicano tra loro usando l'API Direct Line e WebSocket.A sample bot and a custom client communicating to each other using the Direct Line API and WebSockets.

Controllo della chat WebWeb chat control

Bot Framework fornisce un controllo che consente di incorporare un bot basato su Direct Line nell'applicazione client.The Bot Framework provides a control that enables you to embed a Direct-Line-powered bot into your client application. Per altre informazioni, vedere Microsoft Bot Framework WebChat control (Controllo WebChat di Microsoft Bot Framework).For more information, see the Microsoft Bot Framework WebChat control.