Skip to content

Commands

Bhargav Rao edited this page Jul 13, 2018 · 7 revisions

The list of commands are

addcheckuser    - Adds a new user to the special users list
addsalute       - Adds a given statement to the list of salutations
alive           - Returns a test reply to inform that the bot is alive
blacklist       - Adds a given statement to the list of blacklisted words
check           - Checks the sanity of a given post
delete          - Deletes a given comment
feedback        - Provides feedback on a given post
fetch           - Returns a list of posts that need feedback, See the wiki for more details
halp            - Plop, check it out
help            - Returns information regarding the chatbot
hi              - Hi, Test it out
isblacklisted   - Checks if the given statement is blacklisted
iswhitelisted   - Checks if the given statement is whitelisted
opt-in          - Notifies the user of the requested posts, see the wiki for more details
opt-out         - Unnotifies the user. 
quota           - Returns the remaining API Quota
reboot          - Reboots the bot
remind          - Adds a reminder to the list of requests
rmblacklist     - Removes the given statement from blacklist
rmreq           - Removes the request from the list of requests
rmwhitelist     - Removes the given statement from whitelist  
report          - Reports the mentioned post as a true negative NAA/VLQ
say             - Echoes the user input
send            - Sends a mass feedback, see the wiki for more details
showreqs        - Shows the list of requests
status          - Returns the status of the bot
stopflagging    - Stops auto flagging
test            - Tests a mock body if it would be caught for any filters
whitelist       - Adds a given statement to the list of whitelisted words
wishBD          - Wishes the user a very happy birthday
commands        - Returns the list of commands associated with this bot

opt-in command format

The command to opt-in for a tag needs three arguments. They are the tag, the type of the post and whether to notify when the user is inside the room or not. The third argument defaults to notifying the user only when they are inside room.

E.g:

  • @Natty opt-in [python] all : This notifies the user of all the posts identified by the bot tagged python, only when they are present in the room.
  • @Natty opt-in [python] naa : This notifies the user of all the posts that are identified as NAA by the bot and tagged python, only when they are present in the room.
  • @Natty opt-in [python] all always : This notifies the user of all the posts identified by the bot tagged python, whether the user is present in the room, or not.
  • @Natty opt-in [python] naa always : This notifies the user of all the posts that are identified as NAA by the bot and tagged python, whether the user is present in the room, or not.
  • @Natty opt-in all naa : This notifies the user of all the posts that are identified as NAA by the bot only when they are present in the room.
  • @Natty opt-in all all always : This notifies the user of all the posts identified by the bot, whether the user is present in the room, or not.

opt-out command format

The opt-out command unlists the users only when the arguments are the same as those provided when they opted in.

fetch command format

The fetch command also takes a few arguments that can be used to get the posts that have not received feedback. The command alone, without any arguments returns a list of answerIds. The other options are

  • links : This returns the answerIds of the posts along with the links to those posts. This is useful to send bulk feedback.
  • posts : This calls the API again and returns the posts with the latest data. This works only when there are less than 10 posts available in the feedback queue.
  • amount : This returns the number of available posts in the feedback queue.

send command format

The send command can be used to send mass feedback. However the feedback must be in the order of what is present in the feedback queue. The argument reverse can be used to send the feedback in the bottoms-up manner.