iPhone guide

iPhone SMS to Telegram: Shortcut Setup

Forward iPhone text messages to Telegram with a one-tap iCloud Shortcut and a device key. Setup takes a few minutes, then it runs on its own.

What you need

  • An active TG Auto Forwarder account with the SMS add-on.
  • An iPhone with the Shortcuts app.
  • The Telegram chat that will receive the messages.

Step 1: Add the iPhone in the dashboard

  1. Open the SMS add-on in the Web App.
  2. Accept the terms. You are responsible for keeping the device key secret.
  3. Add a device and give it a name.
  4. Copy the device key. It is shown only once, so keep it ready for step 3.

Step 2: Install the Shortcut

Tap the install button on the add-on page. The ready-made Shortcut opens on your iPhone and adds itself to the Shortcuts app with one tap.

Step 3: Paste your key

Open the Shortcut in the Shortcuts app and find the Authorization header. Enter Bearer, then a space, then your device key. Save the Shortcut.

Step 4: Turn on the automation

Each text needs the Shortcut to run when it arrives. In the Shortcuts app, open the Automation tab, create a personal automation for when a message is received, choose this Shortcut and turn off "Ask Before Running" so it runs on its own. Exact labels can vary with your iOS version.

Step 5: Test it

Send yourself a text from another phone. It should appear in your Telegram chat within a short time, with the device name in the footer. If it does not arrive, check that the automation is on, that the key was pasted exactly after "Bearer ", and that the device has not been revoked.

Troubleshooting

  • Nothing arrives: check that the automation runs for incoming messages and that the Shortcut can reach the network.
  • Authorization error: the key was pasted incorrectly, or the device was revoked. Rotate the key and paste the new one.
  • Lost key: rotate it. The old key stops working.
  • Lost or sold phone: revoke the device from the dashboard.

Choose which texts pass

Add rules for specific senders or words. Rules run in order, the first match decides, and blocked texts are never stored or sent. See how SMS rules work.

Frequently asked questions

Do I need a Mac?

No. Setup uses the Shortcuts app on your iPhone and the Web App in any browser.

Can I connect more than one iPhone?

Yes. Each iPhone gets its own key and can be managed separately, within your device limit.

Does the Shortcut store my texts?

That depends on your privacy settings. You can turn off keeping text and choose how long history is kept.

Ready to try it? Create an account, open the Telegram bot or see current plans for limits.
Responsible use: only forward content you are allowed to access and share, follow Telegram's rules, and respect copyright and privacy. TG Auto Forwarder is independent software, not affiliated with Telegram.