Notification Gateway
Notification service that can be relied upon to deliver your messages.
When using Notification Gateway, you can have confidence that a message will be delivered to people. This can be achieved via one or many channels such as voice, rich messaging, SMS, email, social media and chat. The message can be a time-critical notification, an important, or merely a non-urgent update.
With Notification Gateway, the delivery method, such as SMS or email, is not as significant a concern as the act of the message being successfully delivered in a timely fashion to an individual or group of individuals. We allow you to be less concerned about how the message is delivered and instead concern yourself with the content of the message, leaving us to take care of rapid delivery.
- Messaging:
- Voice - SIP, RTP, VoIP
Using the Service
The Melrose Labs Notification Gateway service is available using the REST API.
REST API
The Melrose Labs Notification Gateway service is available using our REST Notification Gateway API.
Create a message using Notification Gateway service with the REST API
Example using cURL, Node.js, Python, PHP
Create a message for delivery and get transaction ID for submission.
JSON request:
{
"account": {
"accountid": "abcd-abcd0123-abcd"
},
"message": {
"variants": [
{
"channel": "twitter",
"content": [
{
"ctype": "text",
"cdata": "Nicola Sturgeon says she will not hesitate to use the law to enforce group sizes and travel distances after traffic around beauty spots and a five-fold rise in police dispersal orders is seen."
},
{
"ctype": "image",
"cdata": "https://blogs.gov.scot/fairer-scotland/wp-content/uploads/sites/32/2017/04/22847857088_b1c3f67f4a_z.jpg"
}
]
},
{
"channel": "sms",
"content": [
{
"ctype": "text",
"cdata": "Nicola Sturgeon says she will not hesitate to use the law to enforce group sizes and travel distances after traffic around beauty spots and a five-fold rise in police dispersal orders is seen."
}
]
},
{
"channel": "mms",
"content": [
{
"ctype": "text",
"cdata": "Nicola Sturgeon says she will not hesitate to use the law to enforce group sizes and travel distances after traffic around beauty spots and a five-fold rise in police dispersal orders is seen."
},
{
"ctype": "image",
"cdata": "https://blogs.gov.scot/fairer-scotland/wp-content/uploads/sites/32/2017/04/22847857088_b1c3f67f4a_z.jpg"
}
]
}
]
},
"recipients": [
"twitter:melroselabs",
"sms:+447968847040",
"mms:+447720334455"
]
}Request:
curl https://api.melroselabs.com/notification/ \
--header 'x-api-key: [API_KEY]' --header 'Content-Type: application/json' \
--data-raw '{"account":{"accountid":"abcd-abcd0123-abcd"},"message":{"variants":[{"channel":"twitter","content":[{"ctype":"text","cdata":"Nicola Sturgeon says she will not hesitate to use the law to enforce group sizes and travel distances after traffic around beauty spots and a five-fold rise in police dispersal orders is seen."},{"ctype":"image","cdata":"https://blogs.gov.scot/fairer-scotland/wp-content/uploads/sites/32/2017/04/22847857088_b1c3f67f4a_z.jpg"}]},{"channel":"sms","content":[{"ctype":"text","cdata":"Nicola Sturgeon says she will not hesitate to use the law to enforce group sizes and travel distances after traffic around beauty spots and a five-fold rise in police dispersal orders is seen."}]},{"channel":"mms","content":[{"ctype":"text","cdata":"Nicola Sturgeon says she will not hesitate to use the law to enforce group sizes and travel distances after traffic around beauty spots and a five-fold rise in police dispersal orders is seen."},{"ctype":"image","cdata":"https://blogs.gov.scot/fairer-scotland/wp-content/uploads/sites/32/2017/04/22847857088_b1c3f67f4a_z.jpg"}]}]},"recipients":["twitter:melroselabs","sms:+447968847040","mms:+447720334455"]}'Response:
{ "transactionID": "41123b82-9f43-4ff8-8c01-0b4ce2bced6f" }Request:
var request = require('request');
var options = {
'method': 'POST',
'url': 'https://api.melroselabs.com/notification/',
'headers': {
'x-api-key': '[API_KEY]',
'Content-Type': 'application/json'
},
body: JSON.stringify({"account":{"accountid":"abcd-abcd0123-abcd"},"message":{"variants":[{"channel":"twitter","content":[{"ctype":"text","cdata":"Nicola Sturgeon says she will not hesitate to use the law to enforce group sizes and travel distances after traffic around beauty spots and a five-fold rise in police dispersal orders is seen."},{"ctype":"image","cdata":"https://blogs.gov.scot/fairer-scotland/wp-content/uploads/sites/32/2017/04/22847857088_b1c3f67f4a_z.jpg"}]},{"channel":"sms","content":[{"ctype":"text","cdata":"Nicola Sturgeon says she will not hesitate to use the law to enforce group sizes and travel distances after traffic around beauty spots and a five-fold rise in police dispersal orders is seen."}]},{"channel":"mms","content":[{"ctype":"text","cdata":"Nicola Sturgeon says she will not hesitate to use the law to enforce group sizes and travel distances after traffic around beauty spots and a five-fold rise in police dispersal orders is seen."},{"ctype":"image","cdata":"https://blogs.gov.scot/fairer-scotland/wp-content/uploads/sites/32/2017/04/22847857088_b1c3f67f4a_z.jpg"}]}]},"recipients":["twitter:melroselabs","sms:+447968847040","mms:+447720334455"]})
};
request(options, function (error, response) {
if (error) throw new Error(error);
console.log(response.body); // response is of type application/json
});Response:
{ "transactionID": "41123b82-9f43-4ff8-8c01-0b4ce2bced6f" }Request:
import requests
import json
url = "https://api.melroselabs.com/notification/"
payload = {
{"account":{"accountid":"abcd-abcd0123-abcd"},"message":{"variants":[{"channel":"twitter","content":[{"ctype":"text","cdata":"Nicola Sturgeon says she will not hesitate to use the law to enforce group sizes and travel distances after traffic around beauty spots and a five-fold rise in police dispersal orders is seen."},{"ctype":"image","cdata":"https://blogs.gov.scot/fairer-scotland/wp-content/uploads/sites/32/2017/04/22847857088_b1c3f67f4a_z.jpg"}]},{"channel":"sms","content":[{"ctype":"text","cdata":"Nicola Sturgeon says she will not hesitate to use the law to enforce group sizes and travel distances after traffic around beauty spots and a five-fold rise in police dispersal orders is seen."}]},{"channel":"mms","content":[{"ctype":"text","cdata":"Nicola Sturgeon says she will not hesitate to use the law to enforce group sizes and travel distances after traffic around beauty spots and a five-fold rise in police dispersal orders is seen."},{"ctype":"image","cdata":"https://blogs.gov.scot/fairer-scotland/wp-content/uploads/sites/32/2017/04/22847857088_b1c3f67f4a_z.jpg"}]}]},"recipients":["twitter:melroselabs","sms:+447968847040","mms:+447720334455"]}
}
headers = {
'x-api-key': '[API_KEY]',
'Content-Type': 'application/json'
}
response = requests.request("POST", url, headers=headers, data = json.dumps(payload))
# response is of type application/json
print(response.text.encode('utf8'))
Response:
{ "transactionID": "41123b82-9f43-4ff8-8c01-0b4ce2bced6f" }Request:
<?php
$data = {"account":{"accountid":"abcd-abcd0123-abcd"},"message":{"variants":[{"channel":"twitter","content":[{"ctype":"text","cdata":"Nicola Sturgeon says she will not hesitate to use the law to enforce group sizes and travel distances after traffic around beauty spots and a five-fold rise in police dispersal orders is seen."},{"ctype":"image","cdata":"https://blogs.gov.scot/fairer-scotland/wp-content/uploads/sites/32/2017/04/22847857088_b1c3f67f4a_z.jpg"}]},{"channel":"sms","content":[{"ctype":"text","cdata":"Nicola Sturgeon says she will not hesitate to use the law to enforce group sizes and travel distances after traffic around beauty spots and a five-fold rise in police dispersal orders is seen."}]},{"channel":"mms","content":[{"ctype":"text","cdata":"Nicola Sturgeon says she will not hesitate to use the law to enforce group sizes and travel distances after traffic around beauty spots and a five-fold rise in police dispersal orders is seen."},{"ctype":"image","cdata":"https://blogs.gov.scot/fairer-scotland/wp-content/uploads/sites/32/2017/04/22847857088_b1c3f67f4a_z.jpg"}]}]},"recipients":["twitter:melroselabs","sms:+447968847040","mms:+447720334455"]}
$curl = curl_init();
curl_setopt_array($curl, array(
CURLOPT_URL => "https://api.melroselabs.com/notification/",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_CUSTOMREQUEST => "POST",
CURLOPT_POSTFIELDS => $data,
CURLOPT_HTTPHEADER => array(
"x-api-key: [API_KEY]",
"Content-Type: application/json"
)
));
$response = curl_exec($curl);
curl_close($curl);
echo $response; // response is of type application/json
?>
Response:
{ "transactionID": "41123b82-9f43-4ff8-8c01-0b4ce2bced6f" }Get your API Key now and start using the Notification Gateway service REST API
SIGN-UP | LOGIN TO GET API KEYData Retention and Data Privacy
We operate on the following principles:
- Customer data is encrypted when at rest and when in motion. Exception is when customer elects to use non-encrypted SMPP.
- Customer data (e.g. account details, message content, telephone numbers) is only used to provide the Notification Gateway service to the customer.
- Data is only kept for as long as necessary to provide service to the customer, ensure that we can support the customer, and be able to fulfil our legal and regulatory obligations.
- Data relating to individuals (e.g. destination mobile numbers) is converted to anonymised form once no longer required.
Service snapshot
- Urgent and time critical notifications
- Emergency text alerts
- Mass alerting - customer/staff/citizens
- Send notifications to individuals, teams, groups, distribution lists
- Confirmed delivery
- Multi-channel - voice, rich messaging, SMS text, email, social media and chat
- Rich content - images, text, speech
- Ultra reliable