Telegram bot
This article explains how to create and connect a Telegram bot for sending messages from Wooxy. Additionally, it describes how to manage connected Telegram bots and how to subscribe the first contact to a bot and a communications channel.
Things to know before starting
- Permanent loss of all subscriptions if the bot settings are deleted.
- Definition of chatbot subscribers as users who follow a link and click “Start” or subscribe via a website widget.
- Display of subscription results in the Telegram column within the contact list.
Create a Telegram bot
Step-by-step instructions
Open Telegram Messenger and sign in to an existing account or create a new one.
Searching for the @BotFather bot and selecting the official version (noted by the blue checkmark).
Sending the /start command to initialize interaction with BotFather.
Select the /newbot command from the provided list to begin the creation process.
Assign a display name (for contacts) and a unique username (search identifier) to the new bot.
Obtaining the unique access token, which serves as the primary identifier for the bot.
Copy the token value for subsequent connection to the Wooxy platform as described in the final section of the article.
Connect a Telegram bot
Step-by-step instructions
Navigate to the “Apps & Add-ons” page.
Press the “Telegram” button.
Click the “Create bot” button.
Entry of the previously obtained access token into the corresponding field.
Select the appropriate domain name from the drop-down menu.
Assign the specific Contact List for the bot.
Access the bot settings for further configuration.
Optional adjustment of telegram message settings if required.
Click the “Save” button to finalize the setup.
Telegram bot management
This section covers how to customize standard Telegram chatbot messages. By default, the system provides pre-configured flows for the “Welcome message,” “Standard messages,” and “Unsubscribe from the bot” actions, ensuring the bot is ready for immediate use.
Welcome Message - triggers automatically right after a user hits "/Start." It’s fully customizable to make a great first impression.
Standard Reply - allows flexible editing of text and buttons at any stage of the flow, such as adding a final thank-you note or a subscription confirmation.
Unsubscription from Bot - a single-message flow that activates instantly when a user sends the "/Stop" command.
Step-by-step instructions
Navigate to the “Apps & Add-ons” page.
Press the “Telegram” button.
Locate the specific Telegram bot and click on the “Settings” icon.
Customizing standard text messages to meet specific requirements.
Click the “Save” button to apply the changes.
Telegram bot subscription
This section covers the various methods for subscribing a contact to a Telegram bot and managing their interactions. It is crucial to remember that Telegram strictly prohibits sending messages to users who have not explicitly opted in by subscribing to the bot first.
-
Key interaction commands
- /start - initiates the subscription. Users see a "Start" button upon opening the chat, which grants the necessary permissions to receive messages.
- /end - handles the opt-out. The user unsubscribes from the specific bot while remaining in the general contact list, allowing for continued communication via other active bots.
-
Methods of subscription
- Telegram Search & Direct Links - users can find the bot via @nameBot_bot or a t.me link. For a successful match, the user must click "Start" and share their phone number. If the number is missing from the contact list, the subscription will not be processed.
- Deep Links (Recommended) - a specialized link format (https://apps.wooxy.com/telegram/subscribe?...) designed to automatically pair the Telegram user with existing contact data using unique identifiers.
- JS API & Variables - with the Wooxy JS API installed, subscriptions can be triggered directly on the website or via dynamic variables in outgoing messages.
-
Deep link configuration
To ensure a successful connection, a Deep Link requires a botId and at least one unique identifier:
- userId: Other platform’s internal unique ID.
- email: The contact’s registered email address.
- phone: A valid phone number formatted in E.164.
