Difference between revisions of "Help:IoTForIndiaBoT"

From IoTWiki
Jump to: navigation, search
m (Using the BOT)
 
(25 intermediate revisions by 2 users not shown)
Line 4: Line 4:
 
Telegram (TG) is a messaging app built for speed and security, it’s super-fast, simple and free. You can use TG on all your devices at the same time — your messages sync seamlessly across your phones, tablets or computers (PC & Mac). With TG you can send messages, photos, videos and files of any type (doc, zip, mp4, etc.) each of large sizes  (250MB+), as well as create groups for up to 100,000+  people or channels like our @IoTForIndia for broadcasting to almost unlimited (  a million users ?)  audiences. Once you have the TG app, you can write to your phone contacts and find people by their usernames. TG is like SMS and email combined!.
 
Telegram (TG) is a messaging app built for speed and security, it’s super-fast, simple and free. You can use TG on all your devices at the same time — your messages sync seamlessly across your phones, tablets or computers (PC & Mac). With TG you can send messages, photos, videos and files of any type (doc, zip, mp4, etc.) each of large sizes  (250MB+), as well as create groups for up to 100,000+  people or channels like our @IoTForIndia for broadcasting to almost unlimited (  a million users ?)  audiences. Once you have the TG app, you can write to your phone contacts and find people by their usernames. TG is like SMS and email combined!.
  
Telgram is similar to WhatsApp but has more features. Here is a link to [https://t.me/IoTForIndia IoTForIndia Channe]. This is a web view and will work on your Laptop or PC too. The Channel is an RSS style curated service. We also operate WhatsApp style ‘by invitation only’ discussion groups.
+
Telgram is similar to WhatsApp but has more features. Here is a link to [https://t.me/IoTForIndia IoTForIndia Channel]. This is a web view and will work on your Laptop or PC too. The Channel is an RSS style curated service. We also operate WhatsApp style ‘by invitation only’ discussion groups.
 
The UI in this document is based  on Windows Desktop version as of Aug 2018. For more details visit the [https://telegram.org/faq Telegram FAQ]
 
The UI in this document is based  on Windows Desktop version as of Aug 2018. For more details visit the [https://telegram.org/faq Telegram FAQ]
  
{| class="wikitable" style="width: 70%;"
+
{|  
|style="width: 30%"|1 The left frame is Contact list.Will show Users, Bots, Groups and Channels. App menu lets you add a new contact or create a group||rowspan=3 style="width: 50%"|https://gallery.mailchimp.com/a41358ae3be676457b007413f/images/e2239904-0aa5-46e5-8210-a0bcc3096aff.gif
+
|style="width: 70%"|1 The left frame is Contact list.Will show Users, Bots, Groups and Channels. App menu lets you add a new contact or create a group||rowspan=3 style="width: 30%"|http://www.iotforindia.org/wp-content/uploads/2019/11/TG2-GIF-small.gif
 
|-
 
|-
|style="width: 30%"|2 The middle frame is messages history or timeline.There is a search icon to search messages. Profile icon shows details of selected contact. User or Bot? You can make voice calls on TG like in WhatsApp (WA)
+
|style="width: 70%"|2 The middle frame is messages history or timeline
 +
*There is a search icon to search messages.  
 +
*Profile icon shows details of selected contact.  
 +
*User or Bot? You can make voice calls on TG like in WhatsApp (WA)
 
|-
 
|-
|style="width: 30%"|3 The bottom frame is to create new message, add attachment and icons or stickers||  ||
+
|style="width: 70%"|3 The bottom frame is to create new message, add attachment and icons or stickers
 
|}
 
|}
  
  
For a gentle introduction see [http://eepurl.com/gz_Jsn IoTForum Welcome Email]
+
===Welcome Newsletter===
  
 +
For a gentle introduction see [http://eepurl.com/gz_Jsn IoTForum Welcome Email].
 +
Members of our IoTForum groups also have a Welcome series of newsletters and the 4th one covers this aspect well.
 +
* [https://us19.campaign-archive.com/?u=a41358ae3be676457b007413f&id=954eb9c301 IoTForum Welcome  Education  #0]
 +
* [https://us19.campaign-archive.com/?u=a41358ae3be676457b007413f&id=86957663ecIoTForum Question Questions & Answer Education Series  #1]
 +
* [https://us19.campaign-archive.com/?u=a41358ae3be676457b007413f&id=ea41da3735 IoTForum Seeking & Finding... Education Series #2]
 +
*[https://us19.campaign-archive.com/?u=a41358ae3be676457b007413f&id=28d231bdad IoTForum Join exclusive Groups  Education Series #3]
 +
*[https://us19.campaign-archive.com/?u=a41358ae3be676457b007413f&id=c8d7f97cb6 Make friends and get WORK from a BOT! Welcome Series #4]
  
 
== IoTForum on TG  ==
 
== IoTForum on TG  ==
Line 30: Line 40:
 
A Telegram bot is an application hosted on a server that uses Telegram bot API to connect to Telegram Messenger clients.
 
A Telegram bot is an application hosted on a server that uses Telegram bot API to connect to Telegram Messenger clients.
 
Bots in Telegram have a global unique username just like public Channels and Groups. The bot @Iot4i is a global name for the working bot.
 
Bots in Telegram have a global unique username just like public Channels and Groups. The bot @Iot4i is a global name for the working bot.
 +
==== Safe and Secure Bot usage ====
 
*''BOTS can not read your phone as they operate on the server not your phone''.
 
*''BOTS can not read your phone as they operate on the server not your phone''.
 
*BOTS are restricted and can not message you as an individual unless they are replying to a message you sent them.  
 
*BOTS are restricted and can not message you as an individual unless they are replying to a message you sent them.  
Line 36: Line 47:
 
The bot connects to users using text messages and  custom keyboards. The BOT will replace the standard keyboard with buttons which are the expected options. When you press the button that text is sent from your device to the BOT. This reduces spelling errors..
 
The bot connects to users using text messages and  custom keyboards. The BOT will replace the standard keyboard with buttons which are the expected options. When you press the button that text is sent from your device to the BOT. This reduces spelling errors..
  
You initiate a conversation with a command to the bot. In TG commands begin with / some commands for IoTForum TG groups are  
+
You initiate a conversation with a command to the bot. In TG commands begin with / some commands for IoTForum TG groups are
 +
 
 +
as of June 2020 the  IoTForum TG bots are
 +
* '''IoTWorkerBoT''' ( @Iot4ibot  ) for commands like /list,/ news
 +
* '''IoTAdminBoT''' for publishing from Website etc
 +
* '''IoTHelperBoT''' for miscellaneous work
 +
* '''IoTHelper2BoT''' for notifications on errors, exceptions and profile registrations on NWS
 +
 
 +
The [https://new.iotforindia.org New Web Site (NWS)] is a mobile first fast website for IoTForIndia.
 +
Bookmark https://new.iotforindia.org
  
 
=== Commands ===
 
=== Commands ===
Line 44: Line 64:
 
*/info about overall
 
*/info about overall
 
*/tnc Terms and Conditions.  
 
*/tnc Terms and Conditions.  
==== Enquires====
+
==== Enquiry====
 
*/topic Search past or future announcements, events, awards company or product  
 
*/topic Search past or future announcements, events, awards company or product  
 
*/list select from 1500+ startups by 60+ City, 10+ Vertical, 12+ Horizonatal , 14+Services and 12+ Offerings
 
*/list select from 1500+ startups by 60+ City, 10+ Vertical, 12+ Horizonatal , 14+Services and 12+ Offerings
Line 61: Line 81:
 
*/register to allow 2 way interaction with us. Premium features will be available in future only to registered users
 
*/register to allow 2 way interaction with us. Premium features will be available in future only to registered users
 
*/vote to express likes or dislikes on topics etc. Will help us tailor to your needs
 
*/vote to express likes or dislikes on topics etc. Will help us tailor to your needs
 +
 
== Using the BOT==
 
== Using the BOT==
 
When you open up a group’s message board, check the pinned message at the top to see if the Bots are active. If yes, you are all set!
 
When you open up a group’s message board, check the pinned message at the top to see if the Bots are active. If yes, you are all set!
 
If the bots are not active, then the pinned message would say ‘Bots are sleeping…”. It is better to let sleeping bots lie!
 
If the bots are not active, then the pinned message would say ‘Bots are sleeping…”. It is better to let sleeping bots lie!
For [[#Informational]] commands you can initiate the command like /help in the group directly. The BOT will reply as a group message and all users in the group will the conversation. This is a ''public'' conversation.
+
For [[#Informational| information]] commands you can initiate the command like /help in the group directly. The BOT will reply as a group message and all users in the group will the conversation. This is a ''public'' conversation.
 +
 
 +
For [[#Enquiry|enquiry]] or [[#Posting to Website|posting]] commands like /register /news /event /list etc. there are several to and fro messages between you and the bot. It is not a good idea to flood the group timeline with this, so we recommend a One-to-One private conversation directly with the Bot. For one-to-one conversations you need to be friends with the Bot! You can become its friend simply by saving the Bot as a Telegram contact, in this case @IoT4i.  Bots are [[ Safe and Secure Bot usage| safe]] to add to your TG contacts. ''They are not on your phone but on server''
 +
 
 +
use as of June 2020 use  '''IoTWorkerBoT''' ( @Iot4ibot  ) for commands like /list,/ news
 +
 
 +
 
 +
https://gallery.mailchimp.com/a41358ae3be676457b007413f/images/146d70a1-64af-4e98-ae26-fdaca1b7247a.gif
 +
 
 +
=== Flow of Interaction===
 +
{| class="wikitable" style="width: 85%;"
 +
|
 +
# Initiate command /news in animation shown on right
 +
# within 1 second get a initial message box and a custom Keyboard.
 +
##Network latency may delay to 5 seconds.
 +
##Watch the double tick mark at the edge of the message (like WhatsApp)
 +
# Reply by pressing a Button on Custom Keyboard
 +
# Get a message from Bot confirming receipt and re-displaying data captured so far
 +
##Network latency may delay up to 2 minutes
 +
##Watch the double tick mark at the edge of the message (like WhatsApp)
 +
##TG will timeout if you do not receive a reply within 3 minutes. Re start the command
 +
#when using first few times carefully check the reply after you submit any data.
 +
## Did it store and re-display that data?
 +
## Bot will show a list of all data collected so far
 +
##Re-sending previous data or button does not hurt.
 +
###Check the message box and at worst the entry may have been removed.
 +
###copy and resend
 +
#Done button will finish the converation
 +
#Skip or Back are available in [[#Posting to Website|posting]] commands
 +
|https://gallery.mailchimp.com/a41358ae3be676457b007413f/images/7fc5369e-7e62-4efb-af48-17ba97270183.gif
 +
|}
 +
=== Custom Keyboard Register Example===
 +
*Register lets you update personal email(P.Email), twitter (P.Twitter) as well as your professional email in your company (C.Email)
 +
*We suggest share personal email as well as our mailing list will not loose you as you change roles
 +
*Twitter etc will let us tag you in our tweets and occasionally promote your tweets
 +
http://www.iotforindia.org/wp-content/uploads/2019/11/RegisterFLow.png
 +
http://www.iotforindia.org/wp-content/uploads/2019/11/RegisterFLow2.png
 +
 
 +
==Error==
 +
Sometimes things do not work as expected
 +
* Bots may be sleeping. Try /help to confirm
 +
* Network may be timing out. Try in  better situation.
 +
** You can use TG from desktop, laptop or tablet with WiFi connectivity
 +
* Some code change may have lead to a error.
 +
** if same data leads to ''hanging'' do report to @TiEIoTForum  handle or on email
 +
* [[#Posting to Website|posting]] commands have 3 stages
 +
** Your post is kept in a Q at Bot server. You will get a message after Done button
 +
** Within a few seconds ( depends on usage load) the Q is posted to a draft topic on Website.
 +
** You should get a tracker number [ WPID] for future interaction
 +
** if for some reason the website is unavailable this will happen later . Sometimes a day later.
 +
* After review by editor your submission will be posted
 +
** In rare case you may get a query
 +
* Once the topic is published you will get a message from the bot on it being live.
 +
** The graphic below shows the flow. The snapshots are from different dates are unrelated post
 +
http://www.iotforindia.org/wp-content/uploads/2019/11/PostFeedback_edit.png
  
For [[#Enquiries]] or [[#Posting to Website]] commands like /register /news /event /list etc. there are several to and fro messages between you and the bot. It is not a good idea to flood the group timeline with this, so we recommend a One-to-One private conversation directly with the Bot. For one-to-one conversations you need to be friends with the Bot! You can become its friend simply by saving the Bot as a Telegram contact, in this case @IoT4i.
+
== Topic Tags==
 +
See [[Help:TopicTags | Guide on Topic Tag]]

Latest revision as of 11:31, 26 February 2021

Why Telegram?

Telegram (TG) is a messaging app built for speed and security, it’s super-fast, simple and free. You can use TG on all your devices at the same time — your messages sync seamlessly across your phones, tablets or computers (PC & Mac). With TG you can send messages, photos, videos and files of any type (doc, zip, mp4, etc.) each of large sizes (250MB+), as well as create groups for up to 100,000+ people or channels like our @IoTForIndia for broadcasting to almost unlimited ( a million users ?) audiences. Once you have the TG app, you can write to your phone contacts and find people by their usernames. TG is like SMS and email combined!.

Telgram is similar to WhatsApp but has more features. Here is a link to IoTForIndia Channel. This is a web view and will work on your Laptop or PC too. The Channel is an RSS style curated service. We also operate WhatsApp style ‘by invitation only’ discussion groups. The UI in this document is based on Windows Desktop version as of Aug 2018. For more details visit the Telegram FAQ

1 The left frame is Contact list.Will show Users, Bots, Groups and Channels. App menu lets you add a new contact or create a group TG2-GIF-small.gif
2 The middle frame is messages history or timeline
  • There is a search icon to search messages.
  • Profile icon shows details of selected contact.
  • User or Bot? You can make voice calls on TG like in WhatsApp (WA)
3 The bottom frame is to create new message, add attachment and icons or stickers


Welcome Newsletter

For a gentle introduction see IoTForum Welcome Email. Members of our IoTForum groups also have a Welcome series of newsletters and the 4th one covers this aspect well.

IoTForum on TG

We have an “official “ @TiEIoTForum account on Telegram for servicing the private groups. You can communicate with us there.

  • loT4l_Advisorsstartups  : Private and closed Telegram Group: for subscribing members of IoTForum.
  • IoT4IndiaStartups : Private ‘by Invite’ group open only to IoT Startups listed in IoT Directory. To apply to be listed in the directory, use this Link https://tinyurl.com/IoTDirectory .
  • IoTForIndiaGroup Public WhatsApp style group. Anyone can join. Intended for TiE IoTForum and IoTforIndia topics. Public You can join by searching for them in TG Contacts by username or clicking this LINK.

However, the key reason why we use TG is because of its BOTS. We have created a few Bots ourselves to serve our community on TG! More on Bots below..

What is a BOT?

A Telegram bot is an application hosted on a server that uses Telegram bot API to connect to Telegram Messenger clients. Bots in Telegram have a global unique username just like public Channels and Groups. The bot @Iot4i is a global name for the working bot.

Safe and Secure Bot usage

  • BOTS can not read your phone as they operate on the server not your phone.
  • BOTS are restricted and can not message you as an individual unless they are replying to a message you sent them.
  • BOTS can act like a "user" in a group and they can read and reply to messages posted in a TG Group.

The bot connects to users using text messages and custom keyboards. The BOT will replace the standard keyboard with buttons which are the expected options. When you press the button that text is sent from your device to the BOT. This reduces spelling errors..

You initiate a conversation with a command to the bot. In TG commands begin with / some commands for IoTForum TG groups are

as of June 2020 the IoTForum TG bots are

  • IoTWorkerBoT ( @Iot4ibot ) for commands like /list,/ news
  • IoTAdminBoT for publishing from Website etc
  • IoTHelperBoT for miscellaneous work
  • IoTHelper2BoT for notifications on errors, exceptions and profile registrations on NWS

The New Web Site (NWS) is a mobile first fast website for IoTForIndia. Bookmark https://new.iotforindia.org

Commands

Informational

  • /start First and once only when the user registers the BOT as a contact (explained later)
  • /help information on overall usage of bots
  • /info about overall
  • /tnc Terms and Conditions.

Enquiry

  • /topic Search past or future announcements, events, awards company or product
  • /list select from 1500+ startups by 60+ City, 10+ Vertical, 12+ Horizonatal , 14+Services and 12+ Offerings

Posting to Website

  • all Posts are queued for review by human editors before being published on the website
  • /news Smart posting of news. BoT extracts text and images from webpage and creates post
  • /company to profile your Startup or Consultancy
  • /product your product "advertisement"
  • /skill your freelancing skills or consultancy profile
  • /celebration let us know your achievements
  • /event publish a forthcoming IoT event anywhere in the world or webinars
  • /invite asking applications to a challenge, award, pitching or survey
  • /post Heavy Duty super set of all previous commands. Gives more fine-grained control.

Under beta

  • /register to allow 2 way interaction with us. Premium features will be available in future only to registered users
  • /vote to express likes or dislikes on topics etc. Will help us tailor to your needs

Using the BOT

When you open up a group’s message board, check the pinned message at the top to see if the Bots are active. If yes, you are all set! If the bots are not active, then the pinned message would say ‘Bots are sleeping…”. It is better to let sleeping bots lie! For information commands you can initiate the command like /help in the group directly. The BOT will reply as a group message and all users in the group will the conversation. This is a public conversation.

For enquiry or posting commands like /register /news /event /list etc. there are several to and fro messages between you and the bot. It is not a good idea to flood the group timeline with this, so we recommend a One-to-One private conversation directly with the Bot. For one-to-one conversations you need to be friends with the Bot! You can become its friend simply by saving the Bot as a Telegram contact, in this case @IoT4i. Bots are safe to add to your TG contacts. They are not on your phone but on server

use as of June 2020 use IoTWorkerBoT ( @Iot4ibot ) for commands like /list,/ news


146d70a1-64af-4e98-ae26-fdaca1b7247a.gif

Flow of Interaction

  1. Initiate command /news in animation shown on right
  2. within 1 second get a initial message box and a custom Keyboard.
    1. Network latency may delay to 5 seconds.
    2. Watch the double tick mark at the edge of the message (like WhatsApp)
  3. Reply by pressing a Button on Custom Keyboard
  4. Get a message from Bot confirming receipt and re-displaying data captured so far
    1. Network latency may delay up to 2 minutes
    2. Watch the double tick mark at the edge of the message (like WhatsApp)
    3. TG will timeout if you do not receive a reply within 3 minutes. Re start the command
  5. when using first few times carefully check the reply after you submit any data.
    1. Did it store and re-display that data?
    2. Bot will show a list of all data collected so far
    3. Re-sending previous data or button does not hurt.
      1. Check the message box and at worst the entry may have been removed.
      2. copy and resend
  6. Done button will finish the converation
  7. Skip or Back are available in posting commands
7fc5369e-7e62-4efb-af48-17ba97270183.gif

Custom Keyboard Register Example

  • Register lets you update personal email(P.Email), twitter (P.Twitter) as well as your professional email in your company (C.Email)
  • We suggest share personal email as well as our mailing list will not loose you as you change roles
  • Twitter etc will let us tag you in our tweets and occasionally promote your tweets

RegisterFLow.png RegisterFLow2.png

Error

Sometimes things do not work as expected

  • Bots may be sleeping. Try /help to confirm
  • Network may be timing out. Try in better situation.
    • You can use TG from desktop, laptop or tablet with WiFi connectivity
  • Some code change may have lead to a error.
    • if same data leads to hanging do report to @TiEIoTForum handle or on email
  • posting commands have 3 stages
    • Your post is kept in a Q at Bot server. You will get a message after Done button
    • Within a few seconds ( depends on usage load) the Q is posted to a draft topic on Website.
    • You should get a tracker number [ WPID] for future interaction
    • if for some reason the website is unavailable this will happen later . Sometimes a day later.
  • After review by editor your submission will be posted
    • In rare case you may get a query
  • Once the topic is published you will get a message from the bot on it being live.
    • The graphic below shows the flow. The snapshots are from different dates are unrelated post

PostFeedback_edit.png

Topic Tags

See Guide on Topic Tag