Chatva

Search documentation

Search titles, instructions and image captions. Use ↑ ↓ to choose a result, Enter to open, Esc to close.

Enter a channel name or describe the step you need.

    Documentation: Telegram

    Telegram

    Updated October 11, 2026

    On this page

    A personal profile receives messages for your account. A bot provides a separate customer contact with its own name and link. Choose a method before entering credentials.

    Before you connect

    • For a personal profile: a phone with Telegram access and your cloud password if enabled.
    • For a bot: access to @BotFather and the correct bot token.

    Open the correct workspace in Chatva → Channels → the channel card → Connect. On first connection, use Next to go through the introductory steps. In the mobile app, the same guide is available during onboarding and under Channels.

    Choose your connection method

    Personal profile

    Open Telegram on your phone and check the selected account in Settings. If two-step verification is enabled, have its password ready: Settings → Privacy and Security → Two-Step Verification. The login code may arrive in the Telegram service chat on an already connected device. Sign-in and two-step verification.

    1. Choose Personal profile

      Choose this mode in the Telegram card. Use an account whose conversations may be shared with your team.

    2. Enter your number and request a code

      Enter the number with its country code and confirm it is the intended account.

    3. Enter the received code → Next

      Check the Telegram service chat and the available code delivery method. Do not forward login codes to support.

    4. Provide your cloud password if prompted

      This is Telegram’s two-factor password, separate from your phone PIN. The account appears in the connected list after sign-in.

    Bot

    Get your bot’s token in Telegram, then paste it into Chatva. For an existing bot, use /token in BotFather.

    Create a bot with BotFather

    1. Open @BotFather

      Follow the direct BotFather link, press Start Bot and open the chat in Telegram. Check the @BotFather username and verification badge.

    The official BotFather public page: Start Bot opens Telegram.

    Source: Telegram · @BotFather ↗

    The official BotFather public page: Start Bot opens Telegram.

    Source: Telegram · @BotFather ↗
    The official BotFather public page: Start Bot opens Telegram.
    1. Send /newbot and choose two names

      Send /newbot in BotFather. Enter a customer-facing name, then an available Latin-character username ending in bot. These are different fields: for example, “Shop support” and shop_support_bot. Telegram requirements.

    2. Copy the token from BotFather’s reply

      In BotFather’s reply, copy the complete HTTP API token. For an existing bot, send /token and select your bot. Token help.

    Diagram · Command sequence diagram, not a chat screenshot. Names are examples.

    Source: Telegram · BotFather commands ↗

    Diagram · Command sequence diagram, not a chat screenshot. Names are examples.

    Source: Telegram · BotFather commands ↗
    Command sequence diagram, not a chat screenshot. Names are examples.

    Paste the token into Chatva

    Return to Chatva → Telegram → Bot. Paste the complete BotFather token into Bot token and press Connect. The web form also allows an optional first bot reply.

    After connecting, open your bot from another Telegram account, press Start and send a message. For a regular private conversation, the user must contact the bot first. Starting a conversation.

    Manage your bot

    The /mybots command in @BotFather opens your bot list. Select a bot to manage its name, description and token. Update its Chatva connection after replacing the token.

    Test an incoming message and a reply

    1. Write from a different account

      Send “Connection test” to the connected account or bot. Use a different account to test an incoming customer message.

    2. Find the conversation in Chatva

      Open the correct workspace’s Inbox and check the channel and sender. If an assignee or status filter is active, switch to all conversations.

    3. Reply from the inbox

      Send “Message received” and confirm on the customer’s side that it arrived from the correct number, bot or page. Connection status alone does not confirm two-way delivery.

    Troubleshooting

    What happenedWhat to check
    Code rejected or expiredCheck the number and use the latest code. Restart connection if the login session has expired.
    Password requestedEnter your Telegram cloud password. Account recovery is handled in Telegram.
    Bot token rejectedRemove whitespace and check the bot. If BotFather regenerated its token, save the new token.
    Bot connected but no replyStart a conversation with the bot first and check that another service is not using the same token.