About the Pandorabots API
The Pandorabots API allows you to integrate our bot hosting service and natural language processing engine into your own application.
The current offering allows you to create a bot, upload files, compile, talk to a bot (in a variety of ways), and delete a bot.
Please take some time to read over the documentation below. To explore how to build a bot using Artificial Intelligence Markup Language on the Pandorabots Platform, please visit the Playground.
1 - User Key
In order to connect to the Pandorabots API, you have to register for a plan and await approval from an administrator. Once your account and plan have been approved, you can retrieve your
user_key. This is required for all API calls, and should be kept secret.
You should include your user key as a URL parameter to each API call that you make:
Your Application ID is required in the path of your request. This can be found on your application's page. You may have multiple bots under the same
2 - Rate Limits
When you registered for an account, you picked a plan that specified some limits on API and usage of our server. If you want to upgrade your plan or discuss customized options, feel free to contact firstname.lastname@example.org
NOTE: This platform is independent of the Playground. If you built bots on the Playground that you want to deploy on AIaaS, you will have to download your bot files, and create bots on AIaaS using the API.
AIML is a markup language that contains many rich features for creating chatbots. If you have written AIML before, or if you already have bot files, you can start from scratch and upload files via the API.
We have released a base bot called Rosie, which will serve as a great starting place for any bot developer. Rosie is a fork of the A.L.I.C.E. project, and is optimized for use on the Pandorabots platform. She comes preloaded with tons of reductions, sets, and maps, which means you won't have to reinvent the wheel in order to have a conversational bot.
If you do not wish to use Rosie as a chatbot base, we suggest you at least grab the substitution files available on Github and upload them to your bot. These files perform input pre-processing as well as allow certain string transformations to take place in AIML templates. Refer to this blog post for more information regarding the use of substitutions and substitution files.
You may download the AIML utilities repository from our Github as well.
If you are a user of the Playground, one concept that may be unclear to you is that of bot compilation. Each time you modify or upload a new file, the bot must be compiled before the changes are available during conversation.
If you have just created bot, you must compile it before using the Talk API.
If you have previously compiled a bot, but have since made changes or uploaded a new file, the changes will not be apparent until you re-compile the bot. You may still use the Talk API, however, you will be talking to the previously compiled version of the bot.
Explore each API resource below and test them out using your own parameters.
**NOTE: The current standard of open source Swagger.js has a bug causing a problem with file upload. There is a current workaround implemented; if you want to use this interface for uploading a file, you will need to copy the file content into the input field. For file upload, we recommend using our own CLI or a REST client of your choice (e.g. Postman Chrome extension).
We offer a number of free SDKs that support various languages, available for download on Github:
These modules provide easy-to-use methods for all of our APIs.
Also available are SDKs developed by the PB community (please contact the individual contributor regarding any questions you may have on the following SDKs):
Special thanks to the PB community for contributing to these open-source efforts, including:
Dr. Richard Wallace
We strongly encourage anyone interested to develop and share their own SDK projects! If you’d like us to evaluate and link to your pb- SDK on this page, email email@example.com.