Copperx Telegram Bot
  1. commands
Copperx Telegram Bot
  • index
  • readme
  • setup
  • development
  • api-integration
  • troubleshooting
  • architechture
  • callbacks
    • index (all callbacks)
    • wallet
    • transfer-callback
    • send
  • commands
    • help
    • index(all commands)
    • login
    • logout
    • start
    • transfer
    • transfer
  • notifications
    • deposite-notification
  • Register Telegram Webhook to your url
    POST
  1. commands

start

/start Command#

The /start command is the entry point for users interacting with the CopperX Payout Bot. It provides a personalized welcome message and guides users on next steps based on their authentication and KYC verification status.

Command Overview#

Purpose: Initialize the bot and show welcome message
Authentication Required: No
KYC Required: No
Implementation File: src/bot/handlers/start.handler.ts

Functionality#

When a user sends the /start command, the bot:
1.
Checks if the user is already authenticated
2.
If not authenticated, shows a welcome message with login options
3.
If authenticated but not KYC verified, shows a message prompting KYC verification
4.
If authenticated and KYC verified, shows a personalized welcome back message

Response Examples#

For New/Unauthenticated Users#

šŸš€ Welcome to CopperX Payout Bot!

This bot helps you manage your crypto transactions and wallet with ease. You can:
ā€¢ Check your USDT balance
ā€¢ Send funds to others
ā€¢ View transaction history

To get started, please log in to your CopperX account using the button below or type /login.
With inline keyboard buttons:
šŸ” Login to CopperX
ā„¹ļø Help

For Authenticated Users Without KYC#

šŸ‘‹ Welcome back, username!

āš ļø Your account KYC is not verified. You need to complete verification to use all features.
With inline keyboard buttons:
šŸ” Check Verification Status
Learn how to complete KYC
Complete KYC now

For Fully Verified Users#

šŸ‘‹ Welcome back, username!

Your account is fully verified. You can use all features of the CopperX Payout bot.
With inline keyboard buttons:
šŸ’° Check Wallet
ā„¹ļø Help

Implementation Details#

The start handler is implemented as follows:

Related Files#

src/bot/messages/start.messages.ts - Contains welcome message templates
src/constants/callback.enum.ts - Defines callback data for inline buttons
src/bot/utils/kyc-verification.ts - Utility for checking KYC status

Session Management#

The /start command doesn't specifically update the user's session state, as it's primarily an informational command. However, it does read the current session to check authentication and KYC status.

Best Practices#

Always make the welcome message informative and user-friendly
Provide clear next steps for users based on their current status
Use buttons to guide users to the most common actions
Keep welcome messages concise yet comprehensive
Modified atĀ 2025-03-23 17:07:40
Previous
logout
Next
transfer
Built with