How To Send SMS Notifications To Members When They Receive a Lead
Link: https://support.brilliantdirectories.com/support/solutions/articles/12000040224
Overview
By default, members receive an email notification when they are matched with a lead. For directories that require faster response times, SMS notifications can also be sent to members using a third-party Email-to-SMS service.
To Get Started
Before configuring SMS notifications, make sure you have:
- The Automatic Lead Matching Add-On enabled on your website.
- An active account with an Email-to-SMS provider such as TextMagic.
We recommend TextMagic.com and will use this platform as an example in this tutorial. 
Email-To-SMS Settings
Allowed Email
Add the Website's Default Website Email of the Brilliant Directories website is listed as an "Allowed Email" in Text Magic. This authorizes your website to send messages through the Email-to-SMS
Register the email address on this page and start texting by sending emails to countrycodemobilenumber@textmagic.com (e.g. 18123123456@textmagic.com for +18123123456).
TextMagic Support: https://support.textmagic.com/
Email Address Format
Next, note the Email to SMS phone number format used for the Email-To-SMS platform. Email-to-SMS providers use a special email address format that determines which phone number will receive the text message.
The email address format for Text Magic is: countrycodemobilenumber@textmagic.com
For example, if I wanted to send the message "This is a test" to the phone number 1-333-555-7777, then I would send an email to 1333555777@textmagic.com with "This is a test" as the body of the email (the subject of the email generally doesn't matter).
Before continuing, send a test email to your own mobile number to verify that the Email-to-SMS service is correctly converting emails into SMS messages.
Brilliant Directories Lead Settings
Go to the Lead Settings: Leads » Lead Settings » Additional Notifications Settings
Each Lead Action that should send SMS notifications must be configured individually. Repeat the following steps for every Lead Action that requires SMS delivery.
Click on the Action that will receive SMS notifications:
Navigate to Additional Notifications » Third Party / SMS:
Scroll down to the "3rd Party Lead Matched Notifications (SMS)" section and choose the following settings:
- 3rd Party Lead Matched Notifications
Set to Yes to enable SMS notification emails. - 3rd Party Lead Matched Template
Select the email template that will be converted into an SMS message. The recommended template is: "member-lead-sms-notifications" - 3rd Party Email Addresses
Enter a comma-separated list of email addresses the email template should be sent to. For the purposes of this tutorial, we only want an email sent to the Email-To-SMS platform email address, including the member's phone number that the SMS should be sent to. Following our example, the correct format for this is:
%%%sms_member_phone%%%@textmagic.com
The %%%sms_member_phone%%% variable used here will insert the member's phone number, stripped of all non-numeric characters (parenthesis, dashes, etc). So if the phone number of the member who receives the lead is 1-333-777-9999, entering the above email address will result in an email being sent to:
13335557777@textmagic.com - Copy Admin On This Email
Generally, it is not very useful for the Admin to receive a copy of this email as it is just for SMS notification purposes, so we recommend leaving this set to "No".
Once all of the settings have been chosen, click on "Save" to save the changes. Repeat the steps above for any other Actions that should send SMS notifications as well.
Setting Up a Unique Mobile Number to Receive SMS Messages
In some cases, members may have a Phone Number they want displayed on their profile or treated as their main contact number, but have a separate mobile number they would like to receive SMS notifications to.
In this case, edit the "Listing - Contact Details - Member" or "Listing - Additional Details - Member" forms (the forms filled out by members when they login to their account) to include a separate field for this purpose.
» How To Customize a Form
Add a new field with the Variable Name sms_member_phone and this number will be used to send SMS messages rather than the number entered into the default phone_number field found in the Contact Details form.
Here's an example of the field being added below the phone_number field in the Listing - Contact Details - Member form:
Disable Lead Matched Notifications (SMS) Fallback
This setting controls whether the system should send an SMS to the main phone number if an SMS-specific phone number is not provided. So, if the SMS phone number is missing, the system will use the main phone number as a backup to ensure the notification is still delivered.
It can be found under Settings >> Advanced Settings >> Disable Lead Matched Notifications (SMS) Fallback:
When the setting is OFF (default), the system will use the main phone number as a fallback if the member does not have an SMS phone number saved.
When the setting is ON, notifications will only be sent to the SMS phone number and will not fall back to the main phone number.
How to Verify if it was Set Up Properly?
- First, make sure to follow the Text Magic Tutorial:
- Make sure the allowed email was correctly added inside TextMagic, it should match the Default Website Email:
- Double-check that "Yes" was selected for the 3rd Party Email Addresses setting.
- The email variable "%%%sms_member_phone%%%@textmagic.com" was added the field, 3rd Party Lead Matched Notifications:
** Select the email template: member-lead-sms-notification ** - Make sure that you are adding the proper input and settings here:
- On the member Contact Details form, check that Country Code + Area Code (if applicable) + Phone Number are being added:
- Send a message to test this functionality:
- Finally, access Text Magic History Tab:
https://my.textmagic.com/online/messages/sent - If the Lead Message appears under "Message" it is because the system sent the SMS notification properly:
