SMS From Me

Automatically Start One on One SMS Conversations

Send a Dynamic Message using a URL

!!!WARNING!!!

It is very likely that you cannot use this feature because it requires your Secret Key to be used in the URL. This means the request must come from a secure server which you own.

It is strongly advised that you use the URL which referencs a Non-Dynamic Message instead. This other feature makes use of a static (predefined) message that you create in advance in your account.

If you have any question about this feature, don't hesitate to contact us.

SMS From Me accepts new messages using a URL with a query string as described below. Our server will transform the query string in a new text message. This is similar to sending an email using our REST API or adding a test message in your account.

Any system you control (because your Secret Key will be included in that URL!!!) and that can read a text page from a website server can be used to generate this URL and access it. The result is a new text message that will be sent as an SMS over your smart phone.

The only trick here is the message itself is likely to include some characters that require encoding. For example, spaces should be written as + (plus), ampersand as %27, percent sign as %25, and hashes as %23. You may use the following form to convert your parameters to a valid string of characters for the URL feature:

WARNING: Remember that your SMS From MeSecret Key is to be kept private and this URL includes that Secret Key parameter. Therefore, this URL should only be used on your private server and not on a public client page (like in a JavaScript in a client's page.) Otherwise any hacker can use your Secret Key and URL Key to send text messages to anyone through YOUR phone...

To make sure that your Secret Key remains secure, you must make sure that you use our HTTPS URL. This one: https://smsfromme.com/new-message. If you use "http://..." instead, and even though we redirect you to the "https://..." version, the query string will travel in clear! In other words, someone who is able to intercept that first hit would get all the necessary information to send any text messages through your account. If you think you may have compromised your Secret Key or your URL Key, you can go to your Internet account profile and click the Regenerate Secret Key and Regenerate URL Key links. Note that your URL Key is considered public so it cannot really be compromised, although if you only use it from a private server, keeping it secret is not a bad idea at all.

The query string supports the following parameters. If you send the data with a POST, then these parameters must be defined in the POST payload and not the query string.

Secret (Required)

secret=John

The Secret Key as you have it in your account profile.

Remember to change all your URLs, emails, API settings when you regenerate your account Secret Key.

Key (Required)

key=A-1234567890-Z

As defined in your Profile account, the URL Key. Your Secret Key and URL Key will be safe as long as you use HTTPS to access our server.

Destination (Required)

destination=9165551212

The destination is the cell phone number of your contact or lead. This is a required field since without it we cannot send the message anywhere.

This is the one parameter that is dynamic. You need to replace this number by your lead phone number for the request to ever be useful.

Redirect

redirect=http:%2F%2Fexample.com%2F

Once the new message was created, you may redirect your user to another page. This is useful if your landing or squeeze page sends the user to an SMS From Me URL to send a text message and then you want to send your user to a thank you page on your website.

The redirect will include all the variables defined in the query string or the POST that was used to access the SMS From Me/new-message page except the few that we know are only necessary for our own system (i.e. the "secret" and "key" parameters will not be forwarded.)

Note that the method used to access the SMS From Me URL has no effect on whether to forward with a GET or a POST.

Post

post=http:%2F%2Fexample.com%2F

This feature has the same effect as the Redirect, only it uses the POST instead of the GET method.

Just like with the Redirect all the variable that were received will be forwarded to the next page. These will be added as a list of POST variables instead of a query string.

Note that the method used to access the SMS From Me URL has no effect on whether to forward with a GET or a POST.

Message (Required)

message=Your+SMS+Message+Goes+Here

The message must be what we call URL encoded. This means a certain number of characters need to be written with %XX instead of as is. This is true for spaces (which can be encoded with "+" too), ampersand (&), the percent character (%), and a few others. Our tool above will help you generate the proper URL then you can copy and paste it where you need it.

If you use another software to generate your URLs, including the message, make sure it is able to encrypt the message properly.

Send On

send_on=YYYY-MM-DD+HH:MM:SS

The time and date when the message should be sent. The format is very specific and must be followed exactly for this feature to work.

This parameter is optional. It defaults to the time when the message gets added to the database, which means as soon as possible.

 

Login

 

Register

If you already registered with your email address and needed to re-validate (i.e. the first validation somehow failed) then go to the Validate Page where you can request for a new validation code to be emailed to you.

Login         Register         Get App.
 

Get My Free Book About SMS Marketing

Hey! Before you leave, make sure to get my freeBook About SMS Marketing. All you have to do is enter your email address and I'll send you a link to this website where you can retrieve your own copy of my free book.

Connect With Us
Google Plus Button
LinkedIn Button
YouTube Button