SMSTunnel Notifications for Gravity Forms
Gravity Forms SMS Add-on
Description
SMSTunnel Notifications for Gravity Forms adds an SMS tab to each form's settings. When someone submits the form, your own phone texts you the details from your own number, and it can text the person a confirmation too.
It works with any Gravity Forms form, and all Gravity Forms merge tags work in the texts.
Features
- SMS Tab per Form - Edit a form → Settings → SMS; each form has its own SMS settings
- Merge Tags Support - Full support for all Gravity Forms merge tags
- Several Numbers - Separate numbers with commas; each number gets its own text
- Autoresponder - SMS (2) texts a confirmation to the person who filled in the form
- Entry Data - Field values plus the entry ID, form title, date and IP address
Merge Tags Reference
Use standard Gravity Forms merge tags in your SMS:
{Name (First):1.3} - First name from Name field
{Email:2} - Email field
{Phone:5} - Phone field
{all_fields} - All submitted field values
{entry_id} - Entry ID
{entry_url} - Link to entry in admin
{form_title} - Form title
{date_mdy} - Current date (mm/dd/yyyy)
{ip} - Submitter IP address
The SMS tab lists the merge tags for your form's fields.
SMS Settings
Each form's SMS tab includes:
- Enable - Send SMS notification when form is submitted
- Recipient Phone Number(s) - One or more numbers in international format, separated by commas, or a merge tag like {Phone:5}
- Message Body - The text, with merge tags (by default "New form submission:" and {all_fields})
- SMS (2) - Autoresponder - Its own Enable box, one Recipient Phone Number (like {Phone:5}) and a Confirmation Message for the person who filled in the form
Example Setup
SMS Notification (to you):
Recipient Phone Number(s): +14155550123
"New form from {Name (First):1.3}: {Message:3}"
SMS (2) - Autoresponder (to the person):
Recipient Phone Number: {Phone:5}
"Thanks {Name (First):1.3}! Your request #{entry_id} was received."
Installation
- Install the SMSTunnel core plugin and link your phone: SMSTunnel → Quick Setup, then scan the QR code with the SMSTunnel app (Connections → Link with QR code)
- Make sure Gravity Forms is installed and active
- In WordPress, go to Plugins → Add Plugin and search for SMSTunnel Notifications for Gravity Forms
- Click Install Now, then Activate
- Edit a form → Settings → SMS
- Tick Enable, add the numbers and the message, then click Save SMS Settings
Requirements
- WordPress 5.0 or higher
- PHP 7.4 or higher
- Gravity Forms (installed and active)
- SMSTunnel core plugin (installed and connected)
Screenshots
Changelog
The current version and its full changelog are on the plugin's WordPress.org page.
Build it with an AI assistant
Copy this prompt into Claude, ChatGPT, Cursor or Copilot and replace the part in [brackets]. Don't paste your API key into the chat: the prompt doesn't need it.
Help me set up SMSTunnel texts for my Gravity Forms forms in WordPress.
About SMSTunnel (https://smstunnel.io): my own apps and tools hand text messages (SMS) to my SMSTunnel account, and my own Android phone sends them from my own number, on my own SIM and plan. The phone runs the SMSTunnel app from Google Play (https://play.google.com/store/apps/details?id=io.smstunnel.app), signed in to my account.
What I want: [describe what should send a text, to whom, and when]
How it works:
- Plugins: SMSTunnel (core), "SMSTunnel Notifications for Gravity Forms" (https://wordpress.org/plugins/smstunnel-notifications-for-gravity-forms/) and Gravity Forms.
- The SMSTunnel core plugin (https://wordpress.org/plugins/smstunnel/) links the site to my phone: SMSTunnel → Quick Setup, then I scan the QR code with the SMSTunnel app (Connections → Link with QR code) and approve on the phone. An API key works too: SMSTunnel → Settings → "Connect with API Key".
- Settings: edit the form → Settings → "SMS" (panel "SMS Notifications"), one page per form: "Enable" (Send SMS notification when form is submitted), "Recipient Phone Number(s)" (several, separated by commas; merge tags like {Phone:5}), "Message Body" (default "New form submission:", then {all_fields}). "SMS (2) - Autoresponder" has its own "Enable" (Enable SMS (2) Autoresponder), a "Recipient Phone Number" (one number, e.g. {Phone:5}) and a "Confirmation Message". Then "Save SMS Settings".
- All Gravity Forms merge tags work in the message, like {Name:1} or {all_fields}. The texts go out after each submission; there is no conditional logic.
- Numbers must start with + and the country code (spaces are fine). A local number with a leading 0 is skipped, one without + is read as if it began with a country code, and premium-rate numbers are always skipped. Each number gets its own text; texts are cut at 1600 characters. If my phone is offline, the texts wait and go out when it is back.
- For custom code, the core plugin has smstunnel_send_sms($phone, $message, $args = array()), with $args 'is_2fa' (sends through the sign-in code endpoint), 'order_id' and 'source'; it returns an array with 'success' and 'messageId', or 'error'. smstunnel_sanitize_recipient($phone) returns the number in international format, or '' when it is invalid or premium-rate.
Rules for your answer:
- Do not ask for my SMSTunnel password or API key and do not put a real key in your answer; I will not paste it in this chat.
- Phone numbers must be in international format (+ and the country code).
- Help me test it with my own number first.
- Only send texts people expect from me. No unsolicited texts.