Concepts clés de l’API Direct Line 3.0

  • Article

Vous pouvez activer la communication entre votre bot et votre propre application cliente à l’aide de l’API Direct Line. Cet article présente les concepts clés de Direct Line API 3.0 et fournit des informations sur les ressources de développement associées. Vous pouvez créer un client avec le SDK, l’API REST ou Web Chat.

Authentification

Les requêtes de l’API Direct Line 3.0 peuvent être authentifiées à l’aide d’un secret que vous obtenez à partir de la page de configuration du canal Direct Line dans le Portail Azure ou à l’aide d’un jeton que vous obtenez au moment de l’exécution. Pour en savoir plus, consultez Authentification.

Démarrage d’une conversation

Les conversations Direct Line sont explicitement ouvertes par les clients et peuvent durer tant que le robot et le client y participent et tant que leurs informations d’identification sont valides. Pour plus d’informations, consultez Démarrer une conversation.

Envoi de messages

À l’aide de Direct Line API 3.0, un client peut envoyer des messages à votre bot en émettant des requêtes HTTP POST. Un client peut envoyer un seul message par demande. Pour plus d’informations, consultez Envoyer une activité au bot.

Réception de messages

Avec Direct Line API 3.0, un client peut recevoir des messages de votre bot via un flux WebSocket ou en envoyant des requêtes HTTP GET. Avec ces techniques, un client peut recevoir plusieurs messages à la fois de la part d’un bot, dans le cadre d’un ActivitySet. Pour plus d’informations, consultez Recevoir des activités du bot.

Ressources pour les développeurs

Bibliothèques clientes

Bot Framework fournit des bibliothèques de client qui facilitent l’accès à Direct Line API 3.0 via le langage C# et Node.js.

  • Pour utiliser la bibliothèque cliente .NET au sein d’un projet Visual Studio, installez le Microsoft.Bot.Connector.DirectLine package NuGet.s

  • Pour utiliser la bibliothèque de client Node.js, installez la bibliothèque botframework-directlinejs à l’aide de NPM (ou téléchargez le code source).

Contrôle de webchat

Bot Framework fournit un contrôle qui vous permet d’incorporer un bot Direct-Line dans votre application cliente. Pour plus d’informations, consultez Contrôle WebChat Microsoft Bot Framework.