botframework-connector
Bot Connector is autorest generated connector client.
Last updated 4 hours ago by botframework .
MIT · Repository · Bugs · Original npm · Tarball · package.json
$ cnpm install botframework-connector 
SYNC missed versions from official npm registry.

Microsoft Bot Framework Connector for Node.js

Within the Bot Framework, the Bot Connector service enables your bot to exchange messages with users on channels that are configured in the Bot Framework Portal.

Requirement

  • Node.js version: 6.x.x or higher

How to Install

npm install botframework-connector

How to Use

Authentication

Your bot communicates with the Bot Connector service using HTTP over a secured channel (SSL/TLS). When your bot sends a request to the Connector service, it must include information that the Connector service can use to verify its identity.

To authenticate the requests, you'll need configure the Connector with the App ID and password that you obtained for your bot during registration and the Connector will handle the rest.

More information: https://docs.microsoft.com/en-us/bot-framework/rest-api/bot-framework-rest-connector-authentication

Example

Client creation (with authentication), conversation initialization and activity send to user.

var BotConnector = require('botframework-connector');

var credentials = new BotConnector.MicrosoftAppCredentials({
    appId: '<your-app-id>',
    appPassword: '<your-app-password>'
});

var botId = '<bot-id>';
var recipientId = '<user-id>';

var client = new BotConnector.ConnectorClient(credentials, 'https://slack.botframework.com')

client.conversations.createConversation({
    bot: { id: botId },
    members: [
        { id: recipientId }
    ],
    isGroup: false
}).then(result => {
    var conversationId = result.id;
    return client.conversations.sendToConversation(conversationId, {
        type: "message",
        from: { id: botId },
        recipient: { id: recipientId },
        text: 'This a message from Bot Connector Client (NodeJS)'
    });
}).then(result => {
    var activityId = result.id;
    console.log('Sent reply with ActivityId:', activityId);
});

Simple EchoBot Example (source code)

EchoBot is a minimal bot that receives message activities and replies with the same content. The sample shows how to use restify/express for listening to activities and the ConnectorClient for sending activities.

Rest API Documentation

For the Connector Service API Documentation, please see our API reference.

Contributing

This project welcomes contributions and suggestions. Most contributions require you to agree to a Contributor License Agreement (CLA) declaring that you have the right to, and actually do, grant us the rights to use your contribution. For details, visit https://cla.microsoft.com.

When you submit a pull request, a CLA-bot will automatically determine whether you need to provide a CLA and decorate the PR appropriately (e.g., label, comment). Simply follow the instructions provided by the bot. You will only need to do this once across all repos using our CLA.

This project has adopted the Microsoft Open Source Code of Conduct. For more information see the Code of Conduct FAQ or contact opencode@microsoft.com with any additional questions or comments.

License

Copyright (c) Microsoft Corporation. All rights reserved.

Licensed under the MIT License.

Current Tags

  • 4.6.2                                ...           latest (4 hours ago)
  • 4.0.0-preview1.2                                ...           preview (2 years ago)

36 Versions

  • 4.6.2                                ...           4 hours ago
  • 4.6.1                                ...           8 days ago
  • 4.6.0                                ...           23 days ago
  • 4.6.0-preview1                                ...           a month ago
  • 4.5.3                                ...           4 months ago
  • 4.5.2                                ...           4 months ago
  • 4.5.1                                ...           4 months ago
  • 4.5.0                                ...           4 months ago
  • 4.4.0                                ...           7 months ago
  • 4.3.4                                ...           8 months ago
  • 4.3.2                                ...           9 months ago
  • 4.2.1                                ...           10 months ago
  • 4.2.0                                ...           a year ago
  • 4.1.7                                ...           a year ago
  • 4.1.6                                ...           a year ago
  • 4.1.5                                ...           a year ago
  • 4.1.3                                ...           a year ago
  • 4.0.8                                ...           a year ago
  • 4.0.6                                ...           a year ago
  • 4.0.0-preview1.2                                ...           2 years ago
  • 4.0.0-preview1.1                                ...           2 years ago
  • 4.0.0-preview1.0                                ...           2 years ago
  • 4.0.0-m4.2                                ...           2 years ago
  • 4.0.0-m4.1                                ...           2 years ago
  • 4.0.0-m4.0                                ...           2 years ago
  • 4.0.0-m3.0                                ...           2 years ago
  • 4.0.0-m2.2                                ...           2 years ago
  • 4.0.0-m2.1                                ...           2 years ago
  • 4.0.0-m1.10                                ...           2 years ago
  • 4.0.0-m1.9                                ...           2 years ago
  • 4.0.0-m1.7                                ...           2 years ago
  • 4.0.0-m1.6                                ...           2 years ago
  • 4.0.0-m1.5                                ...           2 years ago
  • 4.0.0-m1.2                                ...           2 years ago
  • 4.0.0-m1.0                                ...           2 years ago
  • 4.0.0-alpha2                                ...           2 years ago
Maintainers (1)
Downloads
Today 16
This Week 26
This Month 172
Last Day 6
Last Week 56
Last Month 294
Dependencies (9)
Dev Dependencies (10)

Copyright 2014 - 2016 © taobao.org |