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
How it runs
One code, two chances to arrive
-
Add a Telegram step
In an OTP campaign, with the code and its lifetime, and SMS after it if you want a second channel.
-
Telegram checks the number
Before sending, the platform asks Telegram whether the number can receive a code.
-
The code is sent — or passed on
If Telegram cannot deliver, the recipient moves on to the next channel in the campaign.
-
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.