A Node.js sample app that sends a message to a space in [IBM Watson Workspace] (https://workspace.ibm.com).

The Watson Work platform provides spaces for people to exchange messages in conversations. This sample app shows how to retrieve information about a space, then send a message to the conversation in that space. It also demonstrates how to authenticate an application and obtain the OAuth token needed to make Watson Work API calls.

To try the sample app do the following:

In your Web browser, go to [Watson Work Services - Apps] (https://workspace.ibm.com/developer/apps), add a new app named Sender and write down its app id and app secret.

Install Node.js 6+.

In a terminal window, do the following:

# For more verbose output
export DEBUG=watsonwork-*

# Get the code
git clone https://github.com/watsonwork/watsonwork-sender

# Build the app
cd watsonwork-sender
npm run build

Leave the terminal window open as you'll need it again soon.

In your Web browser, go to Watson Workspace, create a space named Examples, then open the Apps tab for that space and add the Sender app to it.

You're now ready to use the sample app to send a message!

Back in the terminal window, do the following:

# Configure the app id and app secret
export SENDER_APP_ID=<the Sender app id>
export SENDER_APP_SECRET=<the Sender app secret>

npm run sender "Examples" "Hello *there*"

The Sender app will send "Hello there" to the conversation in the Examples space. You should now see a new message in that space.

The sample project source tree is organized as follows:

README.md     - this README
package.json  - Node.js package definition

src/          - Javascript sources

  app.js      - main app script

  test/       - unit tests

The app uses the [Watson Work OAuth API] (https://workspace.ibm.com/developer/docs) to authenticate and get an OAuth token. It then uses the [Watson Work GraphQL API] (https://workspace.ibm.com/developer/docs) to retrieve a list of spaces. Finally, it uses the [Watson Work Spaces API] (https://workspace.ibm.com/developer/docs) to send a message to the conversation in the selected space.

Pull requests welcome!