Difference between revisions of "FreeMIRROR user manual"

From NP Tracker projects
Jump to navigation Jump to search
(Adding BOT to group (Option 1))
 
(11 intermediate revisions by the same user not shown)
Line 1: Line 1:
 +
{{#seo:
 +
|title=User Manual
 +
|titlemode=append
 +
|keywords=NPS freemirror, FreeMirror, free mirror, social chats, group management, instant messaging, telegram, facebook, twitter, whatsapp
 +
|description=freeMIRROR is a social media management platform to manage and control social media and groups on Facebook, Twitter, WhatsApp and Telegram.
 +
}}
 +
Check out our user manual for the [[freemirror web]]site.
 
[[File:DatasheetSP-2.png|200px|thumb|right|DatasheetSP-2 Freemirror. Inter group communication toolset]]<br>
 
[[File:DatasheetSP-2.png|200px|thumb|right|DatasheetSP-2 Freemirror. Inter group communication toolset]]<br>
 
== Telegram ==
 
== Telegram ==
 
Telegram is a free cloud-based instant messaging service. Telegram clients exist for both mobile (Android, iOS, Windows Phone, Ubuntu Touch) and desktop systems (Windows, macOS, Linux). Users can send messages and exchange photos, videos, stickers and files of any type.
 
Telegram is a free cloud-based instant messaging service. Telegram clients exist for both mobile (Android, iOS, Windows Phone, Ubuntu Touch) and desktop systems (Windows, macOS, Linux). Users can send messages and exchange photos, videos, stickers and files of any type.
 
=== Adding BOT to group ===
 
=== Adding BOT to group ===
Initialize a conversation with the Telegram bot search for @freeMIRRORBOT (in Telegram) or follow this link [https://t.me/freeMIRRORBOT @freeMIRRORBOT] then click on START
+
Initialize a conversation with the Telegram bot search for [https://t.me/freemirrorbot @freeMIRRORBOT] (in Telegram) then click on START.
 
==== Android ====
 
==== Android ====
 
* Find the bot [https://t.me/freemirrorBOT @freeMIRRORBOT] (Goto Contacts and search for it)
 
* Find the bot [https://t.me/freemirrorBOT @freeMIRRORBOT] (Goto Contacts and search for it)
Line 13: Line 20:
 
==== iOS ====
 
==== iOS ====
 
Some help needed from an iOS user!
 
Some help needed from an iOS user!
 +
 
=== Authorizing BOT on the group ===
 
=== Authorizing BOT on the group ===
* Login to you [https://www.freemirror.co.za/login.php www.freemirror.co.za] account
+
* Login to you [https://www.freemirror.co.za/login.php www.freemirror.co.za] account.
* Goto Telegram -> Setup (On menu)
+
* Goto Telegram -> Setup (On menu).
* Copy the Auth string from the textbox
+
* Copy the Auth string from the textbox. - It will look like ''Freemirror AUTH key (xxxx) - DO NOT REPLY''.
 
* Paste this string on the group you want to link to your freeMIRROR account.
 
* 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.
+
The BOT will confirm that the group has been added to the control panel.
 
To control bot goto Telegram -> Communicator on your freemirror account.
 
To control bot goto Telegram -> Communicator on your freemirror account.
=== Setup group interlinking ===
 
=== Setup group keyword scanning ===
 
 
== Whatsapp ==
 
== Whatsapp ==
All Whatsapp messages recieved on the device will be stored on your freeMIRROR account only messages containing vehicle registration numbers will be stored as lookout reports on NP Tracker.
+
All Whatsapp messages received on the device will be stored on your freeMIRROR account only messages containing vehicle registration numbers will be stored as lookout reports on NP Tracker.
=== Install app on Android device ===
+
=== Adding BOT to group (Option 1) ===
 +
Initialize a conversation with the Whatsapp bot 0606088166.
 +
* Add 060 608 8166 to your phone's contacts - call it '''freeMIRROR Communicator''' - or any name to identify the BOT.
 +
* Open Whatsapp and search for your contact called '''freeMIRROR Communicator'''.
 +
* *Optional Send the word '''ping''' to the BOT it should reply with a '''pong''' message - this indicates that the bot is online and active.
 +
* Goto an existing Whatsapp group.
 +
* Add the '''freeMIRROR Communicator''' as you would a normal user ex. ''Add participants''
 +
 
 +
==== Authorizing BOT on the group ====
 +
* Login to you [https://www.freemirror.co.za/login.php www.freemirror.co.za] account.
 +
* Goto Whatsapp -> Setup (On menu).
 +
* Copy the '''Communicator''' Auth string from the textbox. - It will look like ''Freemirror AUTH key (xxxx) - DO NOT REPLY''.
 +
* Paste this string on the group you want to link to your freeMIRROR account.
 +
The BOT will confirm that the group has been added to the control panel.
 +
To control the bot goto Telegram -> Communicator on your freeMIRROR account.
 +
 
 +
=== Install app on Android device (Option 2) ===
 
* Download and install the freeMIRROR android application on your phone [https://play.google.com/store/apps/details?id=com.nptracker.android.freemirror Google Play store]
 
* Download and install the freeMIRROR android application on your phone [https://play.google.com/store/apps/details?id=com.nptracker.android.freemirror Google Play store]
 
* Grant notification permissions for the freeMIRROR service on the app
 
* Grant notification permissions for the freeMIRROR service on the app
=== Linking app to your account ===
+
==== Linking app to your account ====
* Copy the auth code from your freeMIRROR app on your phone (this will be used to link the apps messages to your freemirror account)
+
* Copy the auth code from your freeMIRROR app on your phone (this will be used to link the app's messages to your freemirror account)
 
* Login to you [https://www.freemirror.co.za/login.php www.freemirror.co.za] account
 
* Login to you [https://www.freemirror.co.za/login.php www.freemirror.co.za] account
 
* Goto Whatsapp -> Setup (On menu)
 
* Goto Whatsapp -> Setup (On menu)
Line 34: Line 56:
 
== Facebook ==
 
== Facebook ==
 
=== Linking app to your account ===
 
=== Linking app to your account ===
 +
Not available currently, please consider [https://www.npscloud.co.za/donate.php?s=wiki donating] to this project to enhance the system.
 
== Twitter ==
 
== Twitter ==
 
=== Linking app to your account ===
 
=== Linking app to your account ===
 +
Not available currently, please consider [https://www.npscloud.co.za/donate.php?s=wiki donating] to this project to enhance the system.
 +
== freemirror Control pages ==
 +
=== User Management ===
 +
Knowing and controlling users on social media groups are a pain but necessary to have control on groups for better communication for all users.<br>
 +
The freeMIRROR control pages will show the following info regarding users.
 +
*Vetting status
 +
*Contact / platform numbers
 +
*All linked groups the user are a member of
 +
*Joining info provided by users
 +
** Vetting level 1
 +
*** Name Surname
 +
*** email address
 +
*** Contact details
 +
*** Location/Address
 +
==Howto==
 +
*[[Select the group]] the user is on
 +
*Goto tab '''Users'''
 +
*Select the user you want to view (click on the user in the user column of the table
 +
Info tabs available
 +
*'''Messages''' - Shows all messages across groups the user posted
 +
*'''Groups''' - List all the groups the user are a member off
 +
*'''Location''' - The location the user-provided OR set the users location manually
 +
*'''Verify/Join Info''' - Display Platform and user-provided info from the vetting forms.
 +
 +
=== Setup group interlinking ===
 +
Group interlinking is where the magic starts with freeMIRROR.<br>
 +
Effective user management starts with users having the right information at the right time to act on.<br>
 +
To enable and engage users groups communication should be structured and fast.<br>
 +
Group interlinking is used to forward messages between groups and between platforms.<br>
 +
====Schenario====
 +
We have WhatsApp groups called '''Street Group A''','''Street Group B''', '''Street Group C''' and '''Broadcast Group'''.<br>
 +
* '''Street Group A''' has reached its maximum user count limited by the platform so we can set up the group interlinking to post messages between '''Street Group A''' AND '''Street Group B''' messages between this groups will first be tested against the forwarding rules the posted to the other group. Ensuring users of the '''Street Group B'''  gets the same info as users on '''Street Group A''' and visa-versa.
 +
* We can also set up the group interlinking to use '''Broadcast Group''' and messages posted to that group can be forwarded to '''Street Group A''', '''Street Group B''' and '''Street Group C'''.
 +
====Setup====
 +
*[[Select the group]] to set up the group interlinking on
 +
*Goto group tab '''Interlink/Mirror'''
 +
*Under the heading '''Group forwarder (To/From)'''  select '''Forward To the selected group'''
 +
*Select the group the message FROM the current group gets posted to.
 +
*Save settings by clicking on the '''Update''' button.
 +
 +
=== Setup group keyword scanning ===
 +
Gone are the days "expensive" resources are needed to sit and monitor group communication to act on situations.<br>
 +
Introducing the keyword scanner function of freeMIRROR where messages are scanned and if a message contains a monitored keyword a notification is sent to the applicable reaction resource group(s).<br>
 +
====Schenario====
 +
In our example, we have two groups '''Street Group A''' and '''Reaction Group (Fire)'''.
 +
*Our fire responders are added to the '''Reaction Group (Fire)'''.
 +
*Normal group communications are ongoing on '''Street Group A''', responders not needed to sit and monitor this group as freeMIRROR keyword scanner will notify them if a monitored keyword as mentioned on this group.
 +
One of the users on '''Street Group A''' post ''My neighbour's house is on fire can we get someone to assist''. With the freeMIRROR keyword scanner set up to monitor this group for the keyword ''fire'' AND notify group '''Reaction Group (fire)''' it will notify the responders on '''Reaction Group (fire)''' without them having to monitor and read all group communication on '''Street Group A'''.
 +
====Setup====
 +
*[[Select the group]] to set up the keyword scanner on
 +
*Goto tab '''Notify/Keyword'''
 +
*Enter the keyword to scan for in the textbox for ''Keyword(s) to scan for'' (split different keywords with , ie. ''keyword1, keyword2'')
 +
*Select the group to get the notification on if the CURRENT group message contains the monitored keyword
 +
*Save settings by clicking on the '''Update''' button.

Latest revision as of 13:09, 16 March 2022

Check out our user manual for the freemirror website.

DatasheetSP-2 Freemirror. Inter group communication toolset


Telegram

Telegram is a free cloud-based instant messaging service. Telegram clients exist for both mobile (Android, iOS, Windows Phone, Ubuntu Touch) and desktop systems (Windows, macOS, Linux). Users can send messages and exchange photos, videos, stickers and files of any type.

Adding BOT to group

Initialize a conversation with the Telegram bot search for @freeMIRRORBOT (in Telegram) then 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 you www.freemirror.co.za account.
  • Goto Telegram -> Setup (On menu).
  • Copy the Auth string from the textbox. - It will look like Freemirror AUTH key (xxxx) - DO NOT REPLY.
  • Paste this string on the group you want to link to your freeMIRROR account.

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

Whatsapp

All Whatsapp messages received on the device will be stored on your freeMIRROR account only messages containing vehicle registration numbers will be stored as lookout reports on NP Tracker.

Adding BOT to group (Option 1)

Initialize a conversation with the Whatsapp bot 0606088166.

  • Add 060 608 8166 to your phone's contacts - call it freeMIRROR Communicator - or any name to identify the BOT.
  • Open Whatsapp and search for your contact called freeMIRROR Communicator.
  • *Optional Send the word ping to the BOT it should reply with a pong message - this indicates that the bot is online and active.
  • Goto an existing Whatsapp group.
  • Add the freeMIRROR Communicator as you would a normal user ex. Add participants

Authorizing BOT on the group

  • Login to you www.freemirror.co.za account.
  • Goto Whatsapp -> Setup (On menu).
  • Copy the Communicator Auth string from the textbox. - It will look like Freemirror AUTH key (xxxx) - DO NOT REPLY.
  • Paste this string on the group you want to link to your freeMIRROR account.

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

Install app on Android device (Option 2)

  • Download and install the freeMIRROR android application on your phone Google Play store
  • Grant notification permissions for the freeMIRROR service on the app

Linking app to your account

  • Copy the auth code from your freeMIRROR app on your phone (this will be used to link the app's messages to your freemirror account)
  • Login to you www.freemirror.co.za account
  • Goto Whatsapp -> Setup (On menu)
  • Enter the auth code from the freemirror app in the Auth string Textbox and click Submit.

Facebook

Linking app to your account

Not available currently, please consider donating to this project to enhance the system.

Twitter

Linking app to your account

Not available currently, please consider donating to this project to enhance the system.

freemirror Control pages

User Management

Knowing and controlling users on social media groups are a pain but necessary to have control on groups for better communication for all users.
The freeMIRROR control pages will show the following info regarding users.

  • Vetting status
  • Contact / platform numbers
  • All linked groups the user are a member of
  • Joining info provided by users
    • Vetting level 1
      • Name Surname
      • email address
      • Contact details
      • Location/Address

Howto

  • Select the group the user is on
  • Goto tab Users
  • Select the user you want to view (click on the user in the user column of the table

Info tabs available

  • Messages - Shows all messages across groups the user posted
  • Groups - List all the groups the user are a member off
  • Location - The location the user-provided OR set the users location manually
  • Verify/Join Info - Display Platform and user-provided info from the vetting forms.

Setup group interlinking

Group interlinking is where the magic starts with freeMIRROR.
Effective user management starts with users having the right information at the right time to act on.
To enable and engage users groups communication should be structured and fast.
Group interlinking is used to forward messages between groups and between platforms.

Schenario

We have WhatsApp groups called Street Group A,Street Group B, Street Group C and Broadcast Group.

  • Street Group A has reached its maximum user count limited by the platform so we can set up the group interlinking to post messages between Street Group A AND Street Group B messages between this groups will first be tested against the forwarding rules the posted to the other group. Ensuring users of the Street Group B gets the same info as users on Street Group A and visa-versa.
  • We can also set up the group interlinking to use Broadcast Group and messages posted to that group can be forwarded to Street Group A, Street Group B and Street Group C.

Setup

  • Select the group to set up the group interlinking on
  • Goto group tab Interlink/Mirror
  • Under the heading Group forwarder (To/From) select Forward To the selected group
  • Select the group the message FROM the current group gets posted to.
  • Save settings by clicking on the Update button.

Setup group keyword scanning

Gone are the days "expensive" resources are needed to sit and monitor group communication to act on situations.
Introducing the keyword scanner function of freeMIRROR where messages are scanned and if a message contains a monitored keyword a notification is sent to the applicable reaction resource group(s).

Schenario

In our example, we have two groups Street Group A and Reaction Group (Fire).

  • Our fire responders are added to the Reaction Group (Fire).
  • Normal group communications are ongoing on Street Group A, responders not needed to sit and monitor this group as freeMIRROR keyword scanner will notify them if a monitored keyword as mentioned on this group.

One of the users on Street Group A post My neighbour's house is on fire can we get someone to assist. With the freeMIRROR keyword scanner set up to monitor this group for the keyword fire AND notify group Reaction Group (fire) it will notify the responders on Reaction Group (fire) without them having to monitor and read all group communication on Street Group A.

Setup

  • Select the group to set up the keyword scanner on
  • Goto tab Notify/Keyword
  • Enter the keyword to scan for in the textbox for Keyword(s) to scan for (split different keywords with , ie. keyword1, keyword2)
  • Select the group to get the notification on if the CURRENT group message contains the monitored keyword
  • Save settings by clicking on the Update button.