The Bot Libre Android SDK makes it easy to develop your own chat bot app, or add a chat bot to your own app. You can create an app for your business, or to make money from mobile ads and upgrades, or just for fun.
Bot Libre's own demo apps have over 1 million downloads on Google Play.
The Bot Libre SDK is more than just a library, it includes a complete Android app. The SDK includes a connection API that wraps Bot Libre's web API, and a user interface for all of Bot Libre's components including:
- Chat bots
- Live chat
- Issue tracking
- User management
- Graphics library
- Script library
The SDK chat bot interface includes support for:
- Text chat
- Continuous speech recogition
- Animated avatars
- Mobile assitant commands
You have 4 choices when using the Bot Libre SDK, depending on your functionality requirements and programming ability.
- Use the complete Bot Libre app or Demo app. You only need to change the bot information, logos, and redeploy the app.
- Use some of the UI components of the Bot Libre app and customize them to suite your needs (refer to the SDK source code).
- Use the botlibre-sdk.jar and the SDKConnection Java class. This gives you access to the low level API to build your own app interface (refer to the JavaDoc for more information).
- Use the Bot Libre web API directly using HTTP calls and XML (refer to our web API for more information).
This "how to" article follows the first method, which is the easiest way to build an app.
Although this method requires minimal programming, developing an Android app requires you use and understand Java, Android Studio, and how to build and deploy an Android app. For information on developing Android apps see, developer.android.com.
If you are not an Android developer we would recommend Bot Libre's app development service. We can develop you your own app for as little as $100 through our Diamond upgrade, contact firstname.lastname@example.org for more information.
Step 1 - Download Android Studio
Android apps are normally developed using Android Studio. You can download Android Studio here.
You will need to install Android Studio on your computer, and also install the Android SDK, and an Android emulator.
Step 2 - Open Bot Libre Demo app
The Bot Libre SDK includes a complete demo chat bot app, with the full source code. You can download the demo "SantaBot" app from GitHub here.
The demo app includes an Android Studio project, so you can open the project in Android Studio. You should be able to build and run the project from Android Studio in the emulator, or on your phone.
Step 3 - Change the Bot Info
The demo app uses the "Santa Bot" app. You will want to change it to use your own bot. If you do not have a bot yet, you can create on Bot Libre by following this article.
If you go to you're bot's main page on Bot Libre, you can get its "Id" from its "Details" tab. You can also get your user accounts "Application ID" from your "User Details" page. Copy both of these values.
Open the "MainActivity.java" file in Android Studio and update the static variables, "applicationId", "launchInstanceId", "launchInstanceName", and save the file.
Now when you run your app it should use your bot.
Step 4 - Change Icons and Images
Next you will want to change the app's splash image and icon for your own bot.
To change the app's icon in Android Studio right click on project or select the menu "File", "New", "Image Asset", and create a new icon for the app.
You will also want to update the image files "icon.png", "logo.png", and "bot.png" in the "res" "drawables" directory.
Step 5 - Change the App Info
An Android app is defined by its manifest.xml file and application package. You need to choose your own app/package name and update your manifest file.
The Android package also affects how the special "R" class is generated in Android. Unfortunately this R class must match the application package, so you need to rename all imports to the "org.botlibre.santabot" package. To do this select the menu "Edit", "Find", "Replace in Path". Enter the old package and the new package and replace all references.
You should be able to new build and deploy your new app. You can also build an "apk" file, and upload the file to Android app stores such as Google Play.