wa-chat-server-microsoft/README.md

wa-chat-server adapter for the Microsoft Bot Framework

# wa-chat-server-microsoft

**wa-chat-server** adapter for the **Microsoft Bot Framework** client.

## Adapter Registration

The initialization of the **wa-chat-server** with a registered
**wa-chat-server-microsoft** adapter looks like this:

```
import { WAChatServer, Types } from 'wa-chat-server';
import { WAChatServerMicrosoftAdapter } from 'wa-chat-server-microsoft';

const server = new WAChatServer((process.env as any) as Types.IWAChatServerConfig);
server.addAdapter('microsoft', WAChatServerMicrosoftAdapter);
server.serve();
```

This code is ready to run and deploy in the directory `demo` (not distributed in NPM).

## Configuration

The configuration is part of the **wa-chat-server** configuration where the keys relevant for
**wa-chat-server-microsoft** have to be prefixed with `adapter.microsoft.`.

* `appId` - Azure application id.
* `appPassword` - Application password.

**NOTE**: When we want to test this adapter with the Microsoft Bot Framework Emulator, we must leave
both `appId` and `appPassword` empty.

## Supported Watson Features

The following Watson features are implemented:

* Markup in `response_type=='text'` (it is converted to markdown)
* `response_type=='option'`
* Disambiguation (`response_type=='suggestion'`)