Getting a US number's texts in Telegram

How the connection is made

Cleat runs its own Telegram bot, with its own token and its own name. You connect an account by opening a one-time link rather than typing anything into a chat (Telegram):

1. 01In Settings, ask for a Telegram link. Cleat generates a one-time code and hands you a t.me link carrying it.
2. 02Open it. Telegram describes the mechanism: “In private chats, you can use the start parameter to automatically pass any value to your bot whenever a user presses the link.”
3. 03The bot receives that code, matches it to your account, and the chat is connected.
4. 04The link expires in 15 minutes. Ask for another if you were slow. An unused code is worth nothing on its own.

Disconnecting is one click in Settings, which clears the chat from your account. One Telegram account connects to one Cleat account.

What a message looks like

Messages arrive as plain text, deliberately. A mangled verification code is worse than an unstyled one. A message carries the code on its own first line when one was found. Then the full text. Then where it came from and which line it arrived on.

Who in the team receives them

Each person connects their own Telegram account, and each person decides whether to. Someone who connects receives the texts for every line in that workspace. They cannot pick one line. A workspace with several numbers sends all of them to everyone who opted in.

Nothing is forwarded to someone whose account the team has disabled. How a team shares one number covers the rest of that arrangement. For the webhook, see the developer notes. A phone can also be notified directly, with no Telegram and no email: installing the dashboard as an app is how.

What this is not

• Not a phone. You cannot reply or place a call from Telegram, and the line cannot send a text. It receives.
• Not a replacement for the inbox. Telegram is an extra copy. The inbox is where every text is kept, and where you go if a delivery failed.
• Webhooks are retried, other channels aren't. A webhook that fails is tried again five times over about an hour. A failed email or Telegram send is recorded, not repeated. The text is still in the inbox and still readable through the API.
• Not an emergency line. No 911, by text or by call.
• Not a way to hide who owns the number. Every line has an identity-verified owner; what we hold and who can read it is the detail.

Calls arrive here too

An incoming call is transcribed and delivered on the same channels as a text. A code read out by an automated call reaches Telegram as a message. What each kind of verification call expects covers the flows that ask for a key to be pressed.

If you are here about registering Telegram itself

That is the other question, and it deserves a straight answer. Telegram publishes that accounts “can only be connected to a mobile number” and that it does not support landline numbers (Telegram). A Cleat line is a real US mobile line, not an internet one. That is why it gets through screens that reject VoIP. No provider can promise a particular service accepts a particular number. How line type decides what a service accepts is the mechanism.

A line costs $24.99 a month and you can cancel it yourself. If that is the deciding factor, test it in the first month.