This FAQ (Frequently Asked Questions) list is a work in progress - if you have any comments or
suggestions for questions to include, please send e-mail to firstname.lastname@example.org
with the word "FAQ" somewhere in the subject line.
There are two mailing lists directly related to Pandorabots.
If you created your Pandorabots.com account after February
28th 2003, you were presented in the account signup form
with two check-boxes – one to subscribe to
pandorabots-announce and the other to subscribe to
pandorabots-general. Depending on
whether or not these check-boxes were checked when you clicked on
'Submit Account Request', you were automatically subscribed to
zero, one or both of the mailing lists.
You should have received a welcome email message including your
password and instructions for unsubscribing from the mail list. You
should also have received monthly reminder messages, again with your
password and instructions for unsubscribing. If you didn't receive
these messages but have been receiving messages sent to the mailing
list, please send mail to
email@example.com as appropriate.
If you no longer wish to receive messages on the Pandorabots mailing
lists see questions A.2 and A.3.
B. Hosting and Publishing
C. Botmaster Control
D. Instant Messaging
D.2. Can I have my pandorabot respond on IRC?
An Eggdrop TCL script is available from
Download alice.tcl and egghttp.tcl. A README.txt is included which
gives details on how to configure the TCL script and your Pandorabot.
Note that the alice.tcl bundle contains a file named alice.html. You
need to save this on your local machine and then from Botmaster
Control, click on Edit for the appropriate
Pandorabot. Scroll down to Personalized published html page, and
enter the path to your saved copy of alice.html in the text field
labelled Filename: (alternatively in IE, you can click on the
Browse... button to open a File Chooser dialog to help you locate
the file). Finally, click on Upload file and you're done.
D.3. Can I train my AOL IM pandorabot to respond based on the Screen Name of the user talking to it?
Yes. You need to use the (pseudo-) predicate "screename"
– Pandorabots automatically sets this to be the screen name of
the AOL IM user talking with your bot. You can access the predicate in
templates using the <get> element and you can also use it as a
regular predicate within <condition> elements. For example, the
following category responds with the user's screen name if set.
<pattern>WHAT IS MY SCREEN NAME</pattern>
<li value="*">Your Screen Name is: <get name="screenname"></get></li>
<li>You're not talking to me via AOL IM.</li>
You can either place the above category in an AIML file to upload, or
using the Training interface, cut and paste the green text as the
E. Oddcast VHost
F. Customized HTML
G.1 Can I change the name of my Pandorabot?
You cannot change the name of the bot as it appears in the list of
bots in 'Botmaster Control'. However, you can change the bot's name
for the processing of any AIML templates - this is controlled by the
value of the 'name' property.
To change this, from 'Botmaster Control', click on 'Edit', change the
property 'name' and click on 'Set Bot Properties'. If you then ask
your bot its name it should reply with the new name.
H.2 Is there an API allowing other programs to talk to a Pandorabot?
A client can interact with a Pandorabot by POST'ing to:
The form variables the client needs to POST are:
- botid - see H.1 above.
- input - what you want said to the bot.
- custid - an ID to track the conversation with a particular customer. This variable is optional. If you don't send a value Pandorabots will return a custid attribute value in the <result> element of the returned XML. Use this in subsequent POST's to continue a conversation.
This will give a text/xml response. For example:
<result status="0" botid="c49b63239e34d1d5" custid="d2228e2eee12d255">
The <input> and <that> elements are named after the corresponding AIML elements for bot input and last response. If there is an error, status will be non-zero and there will be a human readable <message> element included describing the error. For example:
<result status="1" custid="d2228e2eee12d255">
Note that the values POST'd need to be form-urlencoded.