Smstunnel Frappe

SMSTunnel for Frappe and ERPNext: texts and sign-in codes from your own Android phone and number

Install Smstunnel Frappe

bench get-app https://github.com/narcisbodea/smstunnel-frappe

Tags

  • android
  • erpnext
  • frappe
  • frappe-app
  • sms

Add the Frappe Gems badge to your README

Maintain Smstunnel Frappe? Paste this into your README:

[![Listed on Frappe Gems](https://frappegems.com/api/method/frappe_gems.seo.badge?app=narcisbodea%2Fsmstunnel-frappe)](https://frappegems.com/gems/apps/narcisbodea/smstunnel-frappe)

About Smstunnel Frappe

SMSTunnel for Frappe and ERPNext

Texts and sign-in codes from your own Android phone and number, for ERPNext and any Frappe site.

SMSTunnel hands each text to the SMSTunnel app on your phone, which sends it from your own SIM. With this app enabled, Frappe's SMS goes that way:

  • Notifications with the SMS channel
  • SMS Center, for a few people at a time
  • Send SMS on documents such as Sales Orders and Quotations
  • SMS sign-in codes (two-factor authentication)

Texts go out as ordinary texts under your mobile plan, so people can reply to your number.

What you need

  • Frappe or ERPNext v16. On v15 the app refuses to install (see Frappe v15).
  • An SMSTunnel account, with the app on an Android phone.

Install

bench get-app https://github.com/narcisbodea/smstunnel-frappe
bench --site your-site install-app smstunnel
bench restart

With frappe_docker, add this repository to your apps.json and rebuild the image, then run install-app on the site.

Set up

  1. In your SMSTunnel dashboard, open Apps → Add an app and copy the key.
  2. In your site, search for SMSTunnel Settings, paste the key, tick Enabled and save.
  3. Press Check connection. It reads your phones' status and sends nothing.
  4. Open SMS Center, put only your own number in Receiver List and send yourself a text.

You can leave SMS Settings empty. The hint on a new Notification that asks you to set it up doesn't apply here.

The Allowed Roles in SMS Settings still decide who may use Send SMS and SMS Center.

SMS sign-in codes

In System Settings, enable two-factor authentication and choose SMS. Every user then needs a mobile number with the country code on their profile. Try it in a second browser before you sign out, because a user without a valid number can't receive a code.

How it behaves

  • One text per number. A number listed twice gets one text.
  • At most 20 numbers in one send. Above that, nothing is sent and you are told why. This covers a Notification addressed to a role with more than 20 mobile numbers too. SMSTunnel is for texts people expect, about their own order or appointment.
  • Numbers need + and the country code, like +14155550123. Spaces, dashes and brackets are fine. Anything else is refused before any request and never completed with a guessed country code. If one number in a send is wrong, nothing is sent, so you can fix it and send again without texting anyone twice.
  • A text is never sent twice on its own. If SMSTunnel's answer is lost, you are told the text may still go out, and the rest of that send stops. If Frappe runs a background job again, texts already sent are not repeated.
  • "Handed to your phone" means SMSTunnel has the text. The phone then sends it, and your SMSTunnel dashboard shows its status. SMSTunnel can't confirm that a text arrived on the other phone.
  • One phone sends about 28 SMS parts every 65 seconds (Android's limit). More texts wait their turn. If the phone is offline, a text waits for it for up to 3 days.

Privacy

  • The key is stored encrypted in Frappe's password storage, and only System Managers can change it.
  • Each number and text goes to SMSTunnel and on to your phone. See the privacy policy.
  • This app writes no numbers, texts, codes or keys to logs. That is also why it doesn't fill the SMS Log: the history is in your SMSTunnel dashboard.
  • The app only ever connects to https://smstunnel.io.

Turning it off

Untick Enabled, or uninstall the app. Either way Frappe's own SMS Settings work exactly as they did before, and uninstalling also removes the stored key:

bench --site your-site uninstall-app smstunnel

While SMS sign-in codes are on and SMS Settings has no URL, SMSTunnel is the only thing that can send them, so the app refuses to be turned off or uninstalled until you choose another method in System Settings. If nobody can sign in (for example, the key was deleted), this turns two-factor off from the server:

bench --site your-site execute frappe.twofactor.disable

If another installed app also takes over SMS sending, Frappe uses the one installed last. Check connection tells you when that isn't this app.

Frappe v15

Frappe v15 has no way for an app to take over SMS sending, so this app needs v16. On v15, install-app stops with a clear message and changes nothing on the site. A site restored from a v16 backup with the app on it keeps working: the app stays inactive and Frappe's SMS Settings work as usual.

Development

bench --site your-site set-config allow_tests true
bench --site your-site run-tests --app smstunnel

Support

smstunnel.io/contact or support@smstunnel.io.

License

MIT. Copyright (c) 2026 NARBOWEB SRL.

Frappe and ERPNext are trademarks of Frappe Technologies. This app is not made or endorsed by Frappe Technologies.

Related Sales & CRM apps for Frappe & ERPNext

  • Crm — Fully featured, open source CRM
  • Flow — Frappe Flow — native AI agents, tools, and triggers for Frappe
  • Enhanced Kanban View — Frappe Kanban boards with Link field columns, validation dialogs, and automatic synchronization. Inspired by Bitrix24's workflow system.
  • Sales Kpi — Sales KPI app for ERPNext
  • Crm Override — An example Frappe app that demonstrates how to override Frappe UI based apps.
  • Eseller Suite — A comprehensive frappe app designed to help selling partners thrive on various online platforms like Amazon and Flipkart. With powerful tools for optimization, analytics, and automation, sellers can boost sales, optimize listings, and stay ahead of the competition effortlessly.
  • Meeting Management — Meeting Management app for Frappe and ERPNext with agendas, attendees, minutes of meetings, and action item tracking.
  • Dms Sales — DMS Sales - Automotive dealership sales, financing, and commission management for ERPNext