Manage a Telegram send account in the Chat App Message Service console, including viewing bot information, managing connected bots, and configuring webhooks.
Prerequisites
Procedure
Go to the send account management page
Log on to the Chat App Message Service console.
In the send account list, click the name of the send account that you want to manage. The send account details page appears.
View bot information
On the send account details page, click Chatbot Management to view the Telegram bots that are connected to the send account:
Bot name: The name of the connected Telegram bot.
Bot address: The access URL of the connected Telegram bot.
Token: The API token of the connected Telegram bot.
Bot management
Update a token
If the API token of a bot is leaked or has expired, you can update the token in the console.
Updating a token replaces the existing token. A brief disconnection may occur during the update, which affects message sending. Perform this operation during off-peak hours.
In the Telegram client, open BotFather and generate a new API token for the target bot.
On the Chatbot Management page, click Update Token.
In the dialog box that appears, paste the new API token.
Click OK.
Delete a bot
To delete a bot that is connected to the send account, perform the following steps:
After you delete a bot, you can no longer send messages through the bot. The deletion cannot be undone. Proceed with caution.
On the Chatbot Management page, click Delete.
In the confirmation dialog box that appears, click OK.
Reconnect a bot
If you delete a bot or want to replace an existing bot, you can connect a new bot:
On the Chatbot Management page, click Connect Existing Bot.
Enter the API token of the new bot, and then click Connect to complete the authorization.
Webhook settings
Use a webhook to receive message receipt notifications, such as message delivery and read status callbacks.
For more information about message receipts, see Receipt message overview and configuration.
On the Chatbot Management page, click Configure Webhook.
In the Webhook Settings dialog box, configure the following parameters:
Parameter
Description
HTTP Protocol
Enable or disable HTTP callback URLs. When turned on, the Status Report Callback URL, MO Message Callback URL, and Notification Callback URL fields become required.
Status Report Callback URL
The HTTP callback URL to receive message delivery status reports. Required when HTTP Protocol is turned on.
MO Message Callback URL
The HTTP callback URL to receive mobile-originated (MO) message callbacks. Required when HTTP Protocol is turned on.
Notification Callback URL
The HTTP callback URL to receive audit notification callbacks. Required when HTTP Protocol is turned on.
Message Queue Monitoring
Enable or disable message queue monitoring.
Message Receipt Queue
The queue name for message delivery status. Read-only. Click the copy icon to copy the queue name.
MO Message Queue
The queue name for MO messages. Read-only. Click the copy icon to copy the queue name.
Notification Queue
The queue name for audit notifications. Read-only. Click the copy icon to copy the queue name.
Click OK to save the settings.
Next steps
After you connect a bot to the send account, you can perform the following operations:
Design message templates. For instructions, see Template design.
Send messages to users. For instructions, see Send message.