Using the Magic Wand tool

This is a tool found within the Send SMS tool, replying to and forwarding SMS and Missed Calls, and most Activities.  It enables you to substitute dynamic content to your messages.  

For example Magic Wand allows you to address SMS messages sent to multiple recipients to each recipient's own name "Hello Jane ..." and "Hello Anne ..." generated from one single SMS "Hello ${recipient.nameOrMobile} ...".  The 'dynamic variable' starting with ${ is inserted using the Magic Wand tool.

Using the Magic Wand in Send SMS tool, and when replying and forwarding SMS and Missed Calls 

Each of these areas of the app have a message text area input.  Within these you can insert a recipient's name and or mobile number. For example if you are sending a message to multiple contacts and want each contact to receive a message that addresses them dynamically by their name, you can specify that in a message as shown below.

You can also include the recipient's mobile number in an instance where you want to include that, for example if you wanted the contact to confirm their number with you. The same can be applied when replying to or forwarding a message. 


In the above example, (1) is the Magic Wand tool that lists the dynamic variables available, (2) are the dynamic variables themselves, (3) is the text area holding the message content where you can see the inserted variables and their position within the message text.  In this instance the SMS received by the recipient 'Anne' will read; 'Hi Anne, Kindly confirm that this is your number, +25472344444'. 

Using the Magic Wand in Activities

The Magic Wand is used in all the Activities except Poll. There's a broader set of content that can be substituted or added within Activities due to the fact that Activities are part of an automation process.  This means that rather than a flat single SMS being sent, there is usually something that has triggered the message text that you are setting to be dispatched to a recipient.  

In the case of an Autoreply to SMS Activity the SMS message text is sent in response to a received SMS. In this way, you can reference the content of the received triggering SMS such as the Sender details and the original SMS text, as well as the recipient data that is also available as above in the simple Send SMS tool.



In the example above the alert system forwards SMS that come in from contacts about emergency situations to a response team. For any SMS to trigger the Autoforward SMS Activity, it must begin with either of the keywords specified(urgent or help). The Variables are inserted as follows, (1) inserts the 'Message Text' including the keyword used , (2) inserts the 'Sender Name', (3) inserts the 'Sender Mobile'.  The received SMS will read as follows; Emergency alert received: help, there's a fire in our office building from Anne number +254723444444. 

There are many variables on offer within Activities as explained below:

  1. Recipient Name: ${recipient.nameOrMobile} Inserts the Contact Name of the recipient of the message, and if this is not known inserts the Mobile number.
  2. Recipient Mobile: ${} Inserts the Mobile number of the recipient of the message.
  3. Sender Name: ${} Inserts the Contact Name of the Sender of the triggering SMS falling back to their Mobile number if unknown. For example in an Autoreply to SMS you may want to personalize the responses to participants in your Poll survey. 
  4. Sender Mobile: ${trigger.sourceNumber} Inserts the Mobile number of the Sender of the triggering SMS, for example in an Autoforward SMS Activity where the person receiving the message requires a number to take action and call the number. 
  5. Keyword: ${trigger.getWord(1)} Inserts the 'Keyword' (defined as the first and only the first word of the triggering SMS message) of the message. For example if you need people to susbscribe to an alert or info system, you can set up an autoreply that sends a message with the keyword they need to get started.
  6. Message Text Without Keyword: ${trigger.textWithoutFirstWord()} Inserts all of the triggering SMS message content with the first word 'Keyword' removed. For example if you have an alert system using Autoforward SMS where people report accidents through the system using a Keyword then the messages would be forwarded to responders with the Keyword removed. 
  7. Message Text: ${trigger.text} Inserts the triggering SMS message text in its entirety including Keywords used. 

To learn how to do something similar with Custom Fields follow the link below:


Have more questions? Submit a request


Please sign in to leave a comment.