@freeMIRRORBOT

From NP Tracker projects
Revision as of 07:34, 16 April 2021 by NPTracker (talk | contribs)
Jump to navigation Jump to search

This is our Telegram BOT used to scan for lookouts containing number plates to add to the NP Tracker suspect and suspicious vehicle database. Each message this bot receives are scanned and tested for a plate lookout, users can setup the ignore keyword scanner - defaults to "##" - for groups linked on their freemirror account, these messages will not be scanned and added to NP Tracker crime-fighting database.

To assist our development team to provide state-of-the art software to communities, dominantly free please help them by donating to the project to keep it alive and funded.

Telegram


Enquire plates

  • Find the bot @freemirrorBOT (Goto Contacts and search for it)
  • Tap to open (Click on START if required to initialize comms with BOT)
  • To test a numberplate send /lookup ABC123GP to the bot
  • By using a question mark (?) within a search criteria, you can indicate to the system that you will accept in your search results any individual(s) character in the place of the question mark.

Results

The bot will test the vehicle registration number against:

  • The national suspect and suspicious NP Tracker database
  • The NPS-VCR vehicle database (providing make, model and colour info)
  • The NPS-LAW sought vehicle list (optional and available after user vetting)
  • Linked NPS-CLOUD accounts private hotlists.

and show a Vehicle Lookout report if the plate is registered in the system, alternatively, if more than 3 users inquired the plate previously you will be notified.

Link group to freemirror account

Adding BOT to group

Initialize a conversation with the Telegram bot search for @freeMIRRORBOT (in Telegram) click on START

Android
  • Find the bot @freeMIRRORBOT (Goto Contacts and search for it)
  • Tap to open
  • Tap the bot name on the top bar
  • Now, tap the triple ... and you will get the Add to Group button
  • Now select your group and add the bot - and confirm the addition.
iOS

Some help needed from an iOS user!

Authorizing BOT on the group

  • Login to your www.freemirror.co.za account
  • Goto Telegram -> Setup (On menu)
  • Copy the Auth string from the textbox
  • Paste this string on the group you want to link to your freeMIRROR account.

The BOT will confirm that the group have been added to the control panel. To control bot goto Telegram -> Communicator on your freemirror account.

Functionality

If the bot has admin rights: it will remove group members join and leave messages generated by telegram on the group.

Commands

/ping

This is a communication test command the bot will reply with a pong if it recieves this command.

/exit

If the bot has admin rights: it will remove the user that sent this command from the group.

/removeplate

Usage /removeplate ABC123GP - it will remove lookout report for the specific vehicle registration number IF the report was send on the specific group the command was sent on OR the user that send the lookout report send the command to the bot.

/ban

If the bot has admin rights: it will remove the user from the group and any other groups the user are on plus ban the user from thouse groups and remove ALL messages posted by this user.
An group moderator need only reply with this command to a message on the group from the user.

/help

Bot will display commands available through the bot for advanced help related to a command send /help command

/kick

If the bot has admin rights: it will remove the user from the group and ban them for 10 minutes on rejoining.
An group moderator need only reply with this command to a message on the group from the user.

/modon

If the bot has admin rights: it will remove ANY messages posted on the group and send it to the group moderator for approval. Messages not declined will be send to the group after timeout (adjustable in the freemirror control pages).

/modoff

If the bot has admin rights: it will disable the /modon command and normal message posting will continue on the group.

/whoami

The bot will send the user his/her Telegram details ie:

  • Profile pic
  • Telegram user ID
  • Name
  • Telegram Username

/lookup

To inquire an SADC vehicle registration number send /lookup ABC123GP

/review

Manual request to verify data on a NPS-VCR report if suspecting that the info is wrong.

/auth

Vet user and enable NPS-LAW reports.