Before you can send SMS messages, you need to enable and configure the SMS Connected App in the Wisenet Marketplace. By default, the app is turned off.
Wisenet partners with MessageMedia to deliver SMS messages to learners.
You can choose from two SMS delivery options. Your choice determines how SMS messages are delivered, how SMS costs are billed, and whether your organisation’s name appears as the message sender.
Whichever option you choose, you create and send SMS messages from Wisenet. Every SMS interaction is automatically recorded in the Logbook, giving you a complete history of communication with your learners.
Required Portal Access: Admin
Required LRM Access: Owner
Option 1: Send SMS through Wisenet
Choose this option to start sending SMS messages from Wisenet without setting up a separate MessageMedia account.
With this method:
- No MessageMedia account is required.
- Messages are delivered using mobile numbers supplied by MessageMedia.
- Mobile numbers are allocated from a shared pool and are not dedicated to your organisation.
With this option, learners may receive messages from different sender numbers over time, and your organisation name will not appear as the sender of the message.
This option is best for organisations that want a simple, ready-to-use SMS solution and do not require a branded sender name.
SMS usage is billed through Wisenet.
1
Navigate to LRM > Settings > Wisenet Marketplace
2
Connect
Under the section All Apps, Click Connect on the SMS app
3
Activate
3.1 Select the Send Via Wisenet option
3.2 Set a Monthly Usage Limit
3.3 Tick the checkbox to accept the Terms and Conditions for Usage and Charges
3.4 Click Connect
- You will now see the SMS App under the Connected section.
Note: After activating the SMS Connected App in Wisenet Marketplace, sign out of Wisenet and sign back in to ensure the changes are applied successfully.
4
Manage (If required)
Once your SMS App is connected, you have the option to:
- Disconnect the App
- Navigate to LRM > Settings > Wisenet Marketplace
- Under the SMS card, click Manage
- Under Status, click Disconnect App
- Click Save
- Edit the Monthly Usage Limit
- Navigate to LRM > Settings > Wisenet Marketplace
- Under the SMS card, click Manage
- In the Monthly Usage Limit box, change the figure accordingly
- Click Save
Note: After disconnecting/updating the monthly limit on the SMS Connected App in Wisenet Marketplace, sign out of Wisenet and sign back in to ensure the changes are applied successfully.
Option 2: Send SMS via my MessageMedia account
This option allows Wisenet to use your organisation’s MessageMedia account to send SMS messages.
With this method:
- Register and use a Sender ID so your organisation name can appear as the sender of SMS messages.
- Select a MessageMedia pricing plan that aligns with your expected SMS usage.
- Manage your own MessageMedia account.
- SMS usage is billed through MessageMedia.
Required Pre-Steps:
- Select an appropriate MessageMedia plan.
- Create your MessageMedia account.
- Register your Alphanumeric Sender ID
Complete ‘M‘ steps in MessageMedia and ‘W‘ steps in Wisenet.
Tip: We recommend opening Wisenet and MessageMedia in separate browser tabs or windows before starting the setup process. You will need to reference information in both applications throughout the configuration process, and having them open side-by-side will make the setup quicker and easier.
Steps to setup MessageMedia API
M1
Log into your MessageMedia Account
From the MessageMedia account home page, click Settings in the left navigation
M2
Under Settings > Click API Settings
M3
Under Basic Authentication > Click Create new key
M4
Enter a key name (e.g. Wisenet App) and click Create Key
M5
The New API Credentials will be created and a pop up will appear with key details.
Copy and paste the api_key and api_secret details into a notepad as you will need it when you complete the app setup in Wisenet.
Steps to connect MessageMedia in Wisenet
W1
Navigate to LRM > Settings > Wisenet Marketplace
W2
Under the section All Apps, Click Connect on the SMS app
W3
3.1 Select the Send via my MessageMedia option
3.2 Leave the Monthly Usage Limit to the default value. It is only used for SMS messages sent via Wisenet option.
3.3 Enter the MessageMedia API Key and API Secret you copied in Step M5
W4
Webhook Configuration
The webhook allows Wisenet to receive message status updates from your MessageMedia account ensuring SMS activity is accurately recorded within Wisenet.
- Generate a Webhook Authorisation token by clicking on Generate token
- Copy the Callback URL and the generated Token into a notepad and the follow the next steps in MessageMedia
Steps to create MessageMedia Webhook
M6
In MessageMedia:
- On the Settings > API Settings page, click Webhooks
- Click New webhook
M7
Under the Webhook configuration section:
- Click the Events dropdown and tick the following 4 events:
- Message has expired
- Message is rejected
- Message has failed
- Message is delivered
- Leave the HTTP method as POST
- Enter the copied Callback URL from Wisenet Step W4 in the URL field
M8
Under the Headers section:
- In the Header Key, enter Authorization (Note: Please enter Authorization and not Authorisation)
- In the Header Value, paste the generated token from Wisenet in Step W4
M9
Under the Content section, enter the following 4 parameter keys and values accurately:
| Parameter Key | Parameter Value |
| MessageId | $mtId |
| Status | $status |
| Timestamp | $submittedTimestamp |
| Metadata | $metadata |
Then, click Save
Steps to complete setup in Wisenet
W5
In Wisenet, click Save to complete the setup.
- You should see the Connection Status saying Connected.
- If the status says Failed or Not Connected, please verify that you have not missed any step mentioned above.
Note: After activating the SMS Connected App in Wisenet Marketplace, sign out of Wisenet and sign back in to ensure the changes are applied successfully.