SMSTunnel for Formidable Forms

Description

SMSTunnel Notifications for Formidable Forms sends a text when someone fills in one of your Formidable forms: to you, to the person who filled it in, or both. The texts go out from your own Android phone and your own number.

It adds two form actions to Formidable Forms and works with the free version.

Features

• SMSTunnel SMS - A text to you or any numbers you choose, when an entry is created (and, if you pick it, when it's updated)
• SMSTunnel SMS (2) Autoresponder - A text to the person who filled in the form, when an entry is created
• Field Values by ID - [25] puts in the answer to field 25
• Every Answer at Once - [default-message] lists all the answers (SMSTunnel SMS only)
• Several Numbers - In SMSTunnel SMS, separate them with commas; each number gets its own text

Field Shortcodes

Put form answers and site details in your texts:

The SMSTunnel SMS action lists your form's fields with their shortcodes, and the Autoresponder lists its phone fields. Answers go in as saved in the entry. Other Formidable shortcodes and options, like [25 show="value"], [25 format="Y-m-d"], [if ...] or [entry_id], are sent as written.

Setting Up SMS Action

1. Edit your form in Formidable
2. Go to Settings → Actions & Notifications
3. Click SMSTunnel SMS (a text to you) or SMSTunnel SMS (2) Autoresponder (a text to the person who filled in the form)
4. Fill in Recipient Phone Number(s): numbers with + and the country code, separated by commas, or a field shortcode like [25]. In the Autoresponder, Recipient Phone Number is the phone field, like [25]
5. Write the Message Body (Autoresponder: Confirmation Message); texts are cut at 1600 characters
6. To also text when an entry is edited, choose Entry is updated under Trigger this action when (SMSTunnel SMS only)
7. Save the form

Example Messages

Installation

1. 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)
2. Install Formidable Forms (the free version works)
3. Install this add-on. It's coming to WordPress.org; once it's there, go to Plugins → Add Plugin, search for SMSTunnel Notifications for Formidable Forms, then install and activate it
4. Edit any form → Settings → Actions & Notifications

Requirements

• WordPress 5.0 or higher
• PHP 7.4 or higher
• Formidable Forms (the free version works)
• SMSTunnel core plugin (installed and linked to your phone)

Screenshots

Changelog

1.0.2

• The SMS actions can be added with the free Formidable Forms (version 6.31 and later showed an upgrade prompt instead)
• [default-message] is replaced with the submitted answers (before, it was sent as written)
• Deleting the plugin also deletes its SMS actions from your forms

1.0.1

• Phone numbers are checked before sending, and premium-rate numbers are skipped

1.0.0

• Initial release

Help me set up SMSTunnel texts for my Formidable 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), the add-on "SMSTunnel Notifications for Formidable Forms" (coming to WordPress.org; once it is there: Plugins → Add Plugin, search its exact name) and Formidable Forms (the free version works).
- 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 → "Actions & Notifications" → "SMSTunnel SMS" (runs when an entry is created; under "Trigger this action when" you can add "Entry is updated") or "SMSTunnel SMS (2) Autoresponder" (only when an entry is created). "Recipient Phone Number(s)" (several, separated by commas; a field shortcode like [25], the field ID), "Message Body" (default "New form submission:", then [default-message]). SMS (2): "Recipient Phone Number" and "Confirmation Message".
- Tags: [ID] (a field ID number), [default-message] (every answer; SMSTunnel SMS only), [sitename], [siteurl], [admin_email]. Other Formidable shortcodes and options, like [25 show=...] or [if ...], are not supported.
- 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.