=== On-demand Info ===

Keyword campaigns are the most common SMS marketing campaign type. A keyword campaign is designed to reply to an end user when the end user texts in a specific keyword or phrase to a shortcode or longcode.

=== Example Use Case ===

We want to set up a keyword campaign in the **13054957665** longcode that will receive the word **demo** or **DEMO** and will respond with the message **Thanks for your message!**. To do this we click on the **Main Menu Button**, click on **Campaign** and select the **On-demand Info** option. We will see the following screen:
\\ \\ 

{{ :ondemand1.png?800 }}
\\ \\ 

Click on **Create New** and fill in the required information. Here's the breakdown of the required fields:
\\ \\ 

{{ :ondemand2.png?800 }}
\\ \\ 

^ Field          ^ Description       ^
| Name           | The name of the campaign. Please use a concise name and avoid special characters |
| Description    | A short description of the campaign |
| Duration       | Select **Indefinite** if you will deactivate the campaign manually once it has finished. If you wish the campaign to be deactivated automatically at a given date and time change the selector to **Time**, click on the box below and choose the desired date and time |
| Closed to      | Use this field to select a closed **Distribution List** to limit the people who can interact with the campaign. If you don't select a distribution list the campaign will be open and anybody will be able to participate (this is the desired option most of the time). If you select at least one distribution list only users that exist in the list will receive the answers configured in the campaign, and only those users will show up in the reports (any text by a user not present on the distribution list will be responded by the default message). If you wish to create a closed distribution list on the fly (i.e. not use a preexisting one) select **I want to create a new SMS distribution list** and upload a CSV or Excel file containing the list of mobile numbers |
| Answers        | Select **Use wildcards?** if you wish to use [[{base_url}/admin/Pattern.html|advanced regular expressions]] |
\\ 

Use the **Keywords** section to map the expected input from the user with the appropriate response. Grouping several terms in the same keyword lets you andswer several inputs with the same response text, but also simplifies reporting. When reports are generated all the inputs that match a certain keyword are grouped using the **Campaign interprets** field. So in this example:
\\ \\ 

{{ :ondemand2a.png?800 }}
\\ \\ 

users that send **demo** or **DEMO** will receive the same message (**Thanks for your message!** in this example), but they also will be grouped as **demo** in the reports. Now, click on **Save** if you wish to save but not activate the campaign (if you wish to activate it later) or click **Activate** to save it and make it available to your users. Let's try sending a message to the longcode and see the system's response:
\\ \\ 

{{ :ondemand2b2.png?600 }}
\\ \\ 

If we want to add a new term to our **On-demand Info** campaign we would select the **View All Existing On-Demand Info** button in the toolbar:
\\ \\ 

{{ :ondemand3a.png?800 }}
\\ \\ 

Then select the campaign you wish to modify:
\\ \\ 

{{ :ondemand6.png?800 }}
\\ \\ 

And add a new keyword to the campaign. In this case we are going to create an **info** keyword that responds **Today's secret code is 887B**:
\\ \\ 

{{ :ondemand7a.png?800 }}
\\ \\ 

Click on **Save** and let's test it from the handset:
\\ \\ 

{{ :ondemand7b.png?300 }}
\\ \\ 

To view the live results of your campaign select the campaign from the **On-demand Info** main screen and click on the **View Campaign Results** button on the toolbar:
\\ \\ 

{{ :ondemand8a.png?800 }}
\\ \\ 

You will be presented with today's traffic for the campaign. If you wish to see the traffic for any other period of time use the **Starts on** and **Ends on** controls and click **Search**.
\\ \\ 

{{ :ondemand8b.png?800 }}
\\ \\ 

=== Tips ===
  * Clicking on a mobile number in the **Live Results** screen will let you see all interactions for that user
  * Use the **Excel** icon when available to export all the information to an Excel file
  * Click on the **Auto Winner** button on the **Live Results** screen to select random winners from all the participants in your campaign
  * Use the **Pause** and **Play** buttons in the main **On-demand Info** screen to activate and deactivate campaigns in real time
  * Use the **Clipboard** icon on the main **On-demand Info** screen to create a new campaign with the configuration of an existing one