Integrating with Telegram

    Setup Guide

    Link your Telegram account to sync direct contact conversations into Communication and contact timelines.

    By Sebastian StreiffertPublished Jan 10, 2026Updated May 4, 20264 min read

    What the Telegram integration does

    Link your own Telegram account to bring contact conversations into the Communication inbox and contact timelines. Replies sent from Lumenbase go through your linked account one at a time.

    This integration is for direct conversations with CRM contacts. It does not send broadcasts or bulk messages.

    Set up Telegram

    1

    Open integration settings

    Go to My Settings > Integrations > Telegram. Each workspace member links their own account.
    2

    Request a QR code

    Select Get QR code. Keep this page open while the code is active.
    3

    Open Telegram on your phone

    Go to Settings > Devices > Link Desktop Device, then scan the QR code shown in Lumenbase.
    4

    Complete two-step verification

    If Telegram asks for two-step verification, enter your Telegram password in Lumenbase to finish linking.
    5

    Check the connection

    Wait for Lumenbase to show Connected. Open Communication to confirm the Telegram channel appears.

    Conversation sync

    History

    Lumenbase imports recent contact conversations, then keeps new messages in sync.

    Contact matching

    Telegram may hide phone numbers, so some conversations need to be linked to a contact by hand.

    Open the channel history in Communication to review unmatched conversations and link them to contacts.

    Privacy

    Personal and shared visibility follows your Communication privacy setting. Review that setting before sharing conversation history with the workspace.

    Troubleshooting

    The QR code expired

    1. Request a new QR code in integration settings.
    2. Open Telegram on your phone before requesting the code.
    3. Keep both devices online until linking completes.

    Messages are missing

    1. Confirm Telegram still shows as connected.
    2. Check that the sender is linked to a CRM contact.
    3. Confirm conversation sync is enabled.
    4. Review the Needs linking section for unmatched conversations.

    The integration is locked

    Signal and Telegram require Plus or a higher plan. A workspace admin can review the current plan on the billing page.

    Related

    See unified communication for the shared inbox and timeline model.

    Settings: My Settings > Integrations > Telegram
    Link method: QR code from the mobile app
    Messages: Communication and contact timelines
    Sending: Direct replies, one at a time
    Plan: Plus or higher

    Was this article helpful?