September 17, 2020

Telegram Bot Subscription Settings

Retain your users with personalized transactional, bulk and/or automated Telegram Bot Messages.

CommandDescription
Users will see a Start button when they first open a conversation with your bot.
'/start'User initiate subscription to Telegram bot and provide permission to send him/her messages.
'/end'User unsubscribes from specific Telegram bot, but not from Telegram channel in general. You can still continue communication with the user if you have other active bot subscriptions with the same user.

Subscription options:

Subscription SourceSampleDescription
IMPORTANT: Please note that Telegram does not allow you to send messages or receive information regarding users who have not subscribed to your bot beforehand. The IDs of contacts that were not previously added to your Contact List will be ignored.
Telegram Search@nameBot_botUser will be prompted to '/start' subscription and 'share' phone number by clicking coresponding button in Telegram. Warning: If user fails to share phone number or the phone number wasn’t added to contact list beforehand, the subsription will fail due to no way to match the user in the contact list.
Direct Link without user identificatorhttpshttps://t.me/nameBot_botUser will be prompted to '/start' subscription and 'share' phone number by clicking coresponding button in Telegram. Warning: If user fails to share phone number or the phone number wasn’t added to contact list beforehand, the subsription will fail due to no way to match the user in the contact list.
Deep Link with user identificator 'recomended'https://apps.wooxy.com/telegram/subscribe?botId=XXXXXX&email=example@mail.com&userId=user_id&phone=+xxxxxxxxxxx
Manual GenerationYou can generate and place the link anywhere on your website. User will be prompted to '/start' subscription. If user wasn’t added to contact list beforehand, the subsription will fail due to no way to match the user in the contact list.
Variable  
'recomended'
Generated only in messages sent our from Wooxy. User will be prompted to '/start' subscription.
JS Code Snippet  
'recomended'
Generated only on your website if Wooxy JS Code Snippet is properly installed. User will be prompted to '/start' subscription.

https://apps.wooxy.com/telegram/subscribe?botId=XXXXXX&email=example@mail.com&userId=user_id&phone=+xxxxxxxxxxx

ComponentDescription
Deep linking hostname 
'required'
https://apps.wooxy.com/telegram/subscribe? required format
botId 
'required'
Bot’s unique ID in the system Wooxy
WARNING: Minimum one unique user identificator (userId | email | phoneNumber) is required.
userId 
'optional'
Contact’s unique user ID from your platform to enable management of the contact in the list based on it.
email 
'optional'
Contact’s email address.
phone 
'optional'
IMPORTANT: should be valid E.164 phone number.