Technical info
Developers
Developers unite in the JMango Forum & Wiki
JMango has an extensive Forum and Wiki for developers to solve problems and ask questions that JMango or other developers may already have the answers to such as coding examples and integration guides.
Go to the JMango Wiki
Register here for a developer account
Getting Started
1. Setup your account
Go to the JMango registration page and type in your information. Please make sure you supply a valid email address, as an activation email will be sent to your account. Also make sure you note down your username and password.
Once you receive your activation email, click on the supplied url within the email to activate your account. Once you have done this, log into JMango.
2. Create an application or use one of existing applications
The next step is to create an application. Go back to the Home page and click on the Create new application link as shown below
An application essentially defines 2 things:
- What messaging gateway your outgoing compiled scripts are sent via.
- How responses from a mobile device are handled; i.e. what system are they sent to. Jmango supports sending of response messages in the following format:
- HTTP - JMango will make an HTTP call to the URL address you supply, with the user responses sent as query parameters
- Email - you specify the email address for user responses to be sent to
- SMS - you specify a phone number that the response will be messaged to
- Store - JMango will store a CSV file containing the users' responses on its website for you to download at your leisure
So for example, you could create a test, development and production applications depending on your development methodology, each with results being sent to a different location. Or if you were a solution developer, you would create applications for each client you developed a solution for.
The following screen shot shows an example application called "Testing"
3. The final step! Send a script or Text message
This is the fun part. You now get to send any script that you want to the application. Go back to the Home page and click on Send application request link as shown below.
A screen similar to the one below should appear. We've filled this one out for to show a sample script:
You need to:
- select the application/channel your script will be processed via. Choose the Email Me application you created in the first step.
- Phone number should be specified in international format. Make sure the phone numbers you type in have the JMango client installed on them (step 3)
- Enter the source for the application. For this example we will create a Hello World application. Type in the following script
MESSAGE "Hello" "Hello World - JMango is alive"
INPUT "name" "Whats your name" ANY
The above script asks displays a message and then asks the user to enter their name.
- Under option select Compile only and then click on the Compile button. This will ensure the script syntax is valid without sending it to the mobile device. It will also tell you how many messages your script will span.
- If your script is okay, you will receive a confirmation message. Once this happens, change Option to Compile and Send SMS Messages and click the Compile button again.
You should now receive a JMango alert on your phone.
*Please note, this could take a few minutes depending on how busy the gateway is.
Once your receive the script, run through the workflow on your phone. You will be prompted by the phone to confirm if it is okay to send the response. Select "Yes".
Now wait for the response to appear in your email.
Please contact JMango support at support@jmango.com.au if you have any query.