This is a guide to help you setup the SMS channel.

Configuring Originators

An SMS originator is required to receive inbound SMS or to give your application a recognisable identity to your customers. You can send using our Localiser & Stitching without the need for an originator, but your pool numbers will change, so making recognising your communications more difficult for the customer.

You can send SMS from the following types of originator:

TypeExampleDescription
Mobile number447123123123A mobile number in international format. These can be rented for your desired country from us
Short Code60006A short numeric identifier that requires companies to register for. These can be rented for your desired country from us
AlphaAcmeString value between 2-11 characters of 0-9, a-z, A-Z, hyphen, underscore, full-stop and space

To see and configure your available originators in the Portal in the Channels -> SMS section shown below (highlighted in green):

1920

SMS channel setup

Click on the Number/Shortcodes button to view what SMS originators (senders) are assigned to your API Space which are used to send or receive SMS.

πŸ“˜

Receiving data

If you want to send inbound messages to your own systems for processing see our Webhooks documentation for more information on how to receive data from us.

Configuring URL Tracking

The tracking service, shortens URL to make them more character friendly. We then track every click based on a unique ID contained within this URL. Use the service to cut the length of your SMS and get real time proof of engagement. You can even post a live event to your system based on a clickthrough, see our URL Click Forwarding documentation for more details.

To enable and configure URL tracking on your API Space go to the Portal and in the Channels -> SMS section shown below select the Tracking button:

901

Configuring URL Tracking options

πŸ“˜

How long are tracking URLs?

Tracked URLs will be no longer than 21 characters

Key Points

  • When you enable URL Tracking, your URL will be converted into the form http://dyn.co followed by a unique ID for every message that URL is featured in.
  • No two URLs will be the same, so you cannot use a unique URL for any other purpose than in its SMS without skewing your click through results.
  • If you use a secure URL in your message, we will honour that security and replace it with a secure dyn.co version e.g. http://dyn.co/{unique ref}
  • Were you to include the same URL more than once in the same message, URL Lead Tracking will not distinguish between them.
  • Tracked URLs will be no longer than 21 characters

Shorten and track all URLs

Enable this option if you want all of your SMS messages scanned for fully qualified URLs e.g. http://www.acme.com and not www.acme.com and replaced with tracking links

Shorten and track marked URL's

Enable this option if you all of your SMS messages scanned for fully qualified URLs marked with a @ symbol e.g. @http://www.acme.com and replaced with tracking links. Any non marked URL's would be left unchanged.

e.g.

Hi Dave, go to your personalised offer at @https://www.acme.com/offers/cust/ab9992534 , or find out more at http://www.acme.com/offers
Hi Dave, go to your personalised offer at https://dyn.co/as4532 , or find out more at http://www.acme.com/offers

URL Prefix

This option will allow you to prefix a single word in front of the original default shortened URL.

Example of a shortened URL with prefix: http://myprefix.dyn.co/{unique ref} where myprefix can be any single word.

❗️

Prefixes will increase message lengths!

Please be aware that by adding a prefix, messages lengths will increase which may increase messaging costs.

Custom Domain

This option will allow you to use your own domain for the tracking links. Before you can use your own custom domain you must ensure that you have your custom domain configured to resolve to dyn.co.

Any traffic destined for your custom domain name will be redirected to our servers so this domain must be exclusively used for URL tracking.

Add an a CNAME record for your custom tracking domain pointing to dynco-cpaas-lb.cloudflare-dm-cpaas.com with your DNS Name server provider. e.g.

track.example.com CNAME dynco-cpaas-lb.cloudflare-dm-cpaas.com

🚧

You must request your custom domain is registered

Once you have your DNS record in place please contact your Customer Success Manager to request that we register your custom domain, otherwise it will not work.

❗️

Ensure your custom domain works before using

Adding the wrong information will cause the tracking process not to work correctly, and break your links. A DNS lookup for your custom domain should return 104.18.196.240 and 104.18.197.240

In addition to the DNS record working correctly you must have requested that your custom domain is registered for use with your CSM, and received confirmation the registration is complete.