machaao 0.1.7

An easy to use module for python developers looking to build and develop chat apps using MessengerX.io

machaao - make personalized chatbots that scale

A module for python developers looking to rapidly build, prototype and publish personalized chatbots

Minimum Requirements

python # 3.6 or higher version

Get your FREE API Key through the Dev Portal

Get your FREE API Key @ https://portal.messengerx.io

Install

# For Linux/MacOS
pip3 install machaao

# For Windows
pip install machaao

Create new chatbot project

machaao start -s <project_name>

Navigate to the newly created chatbot project directory

cd <project_name>

Open chatbot.py in any text editor, update the api key and base url as shown below

MESSENGERX_API_TOKEN = "<API_KEY_FROM_PORTAL>"
MESSENGERX_BASE_URL = "https://ganglia-dev.machaao.com" [for development purposes]

Run the following for machaao to do it's magic.

machaao run -p 5000 -t [CHATBOT-TOKEN]

Your bot should now be available @ [https://dev.messengerx.io/<chatbot_name>] to send a message to your chatbot.

Your chatbot is now ready to start receiving incoming messages from users

# HappyCoding

Optional

Run Machaao Tunnel in a seperate terminal and note down your FORWARDING URL

machaao tunnel -p 5000 -t [CHATBOT-TOKEN]

[https://<....>.tunnel.messengerx.io/]

Go to your bot settings on the portal and update your Chatbot Webhook URL Settings

[https://<....>.tunnel.messengerx.io/machaao/incoming]

Run your simple chatbot on your local server

# For Linux/MacOS
python3 chatbot.py

# For Windows
python chatbot.py

NOTE: UNDER ACTIVE DEVELOPMENT (ACCEPTING PULL REQUESTS)