How to Integrate Rasa with Microsoft Teams

Setup Your Rasa Bot

• Ensure your Rasa bot is up and running. You need a trained Rasa model to respond to user queries.

 

• Start your Rasa server using the command below. This will serve your Rasa assistant on the localhost.

rasa run --enable-api

Create a Microsoft Teams App

• Access the Microsoft Teams Developer Portal with your Microsoft account.

 

• Click on "Create a new app" and provide a name and other necessary details like package name, app ID, etc.

Configure the Bot Framework

• Navigate to Microsoft Bot Framework portal and log in with your account.

 

• Register a new bot and fill in the required details such as bot handle and messaging endpoint. The endpoint should point to the publicly accessible URL where your Rasa server is accessible.

 

• Obtain your Microsoft App ID and Microsoft App Password. These will be used in your integration setup.

Middleware Setup to Relay Messages to Rasa

• Create a middleware application that communicates between Microsoft Teams and your Rasa server. You can use platforms such as Flask or Express.js for this purpose.

from flask import Flask, request
import requests

app = Flask(__name__)

@app.route('/bot', methods=['POST'])
def bot_message():
    incoming_message = request.json
    # Process incoming message here
    # Relay to Rasa
    response = requests.post('http://localhost:5005/webhooks/rest/webhook', json=incoming_message)
    return response.json()

if __name__ == '__main__':
    app.run(port=3978)

Deploy Your Middleware

• Use services like Heroku, AWS, or Azure to deploy your middleware application so it's publicly accessible.

 

• Ensure the endpoint URL of the deployed middleman application is registered in the Microsoft Bot Framework as the Messaging endpoint.

Test the Integration

• Use the Microsoft Teams client to add your bot by searching for the app name you provided.

 

• Test messaging functionality to ensure messages from Teams reach your Rasa bot and provide appropriate responses back to the Teams client.

Debugging and Logging

• Implement logging within your middleware to capture incoming and outgoing requests for debugging purposes.

 

• Use Developer Tools in Microsoft Teams to observe network activity and debug potential issues with message routes and responses.