VeloConnect — home Get started
Get started

Telegram

Verification codes delivered inside Telegram through Telegram's Gateway, as a step in a campaign — with SMS after it for the numbers Telegram cannot reach.

Telegram

Codes delivered inside Telegram

Telegram’s Gateway API delivers verification codes as Telegram messages to a phone number. VeloConnect sends through it as the Telegram step of a campaign: you supply the code and how long it stays valid, and the platform checks what the user types back.

Put SMS after the Telegram step and a number Telegram cannot deliver to gets the SMS instead, in the same campaign.

  • Codes sent through Telegram's own Gateway API
  • A code lifetime you set, in seconds
  • The code stored hashed and checked by the platform
  • SMS — or another channel — after Telegram in the same campaign

See OTP verification

How it runs

One code, two chances to arrive

  1. Add a Telegram step

    In an OTP campaign, with the code and its lifetime, and SMS after it if you want a second channel.

  2. Telegram checks the number

    Before sending, the platform asks Telegram whether the number can receive a code.

  3. The code is sent — or passed on

    If Telegram cannot deliver, the recipient moves on to the next channel in the campaign.

  4. Check what the user typed

    Submit it to the verification endpoint; an expired or wrong code is refused.

Telegram at a glance

Delivery
Telegram Gateway API, as the Telegram step of a campaign
Message type
Verification codes only — a Telegram step must be an OTP step
Recipient
The Telegram phone number on the contact
Code lifetime
Set per step, in seconds
Checking
POST /api/v2/campaigns/{id}/telegram/verifications/{verificationId}/verify
Fallback
The next channel in the campaign's order, per recipient
Authentication
Campaign API, with a dashboard (JWT) token
Inbox
Conversations on Telegram come in through TG-Link, under its own inbox tab

Telegram questions

Do my users have to start a bot first?

No. Codes go through Telegram’s Gateway API, which delivers them as Telegram messages to the phone number. There is no bot for the user to find.

What if the number is not on Telegram?

Then Telegram cannot deliver, and the recipient moves on to the next channel in the campaign. Put SMS there and the code still arrives.

Can I send marketing messages on Telegram?

Not through campaigns: a Telegram step carries verification codes only. For promotional sends, use SMS, Viber, WhatsApp or email. To talk with customers on Telegram from the shared inbox, connect an account or a bot with TG-Link.

Send codes through Telegram

Talk to us about adding a Telegram step to your verification flow.