September 17, 2020
Telegram Bot Subscription Settings
Retain your users with personalized transactional, bulk and/or automated Telegram Bot Messages.
| Command | Description |
| 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 Source | Sample | Description |
| 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_bot | User 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 identificatorhttps | https://t.me/nameBot_bot | User 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 Generation | You 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
| Component | Description |
| 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. |
