Reaching and engaging customers effectively can significantly improve the customer experience. Text messaging is proven to be the most effective channel to communicate with customers. Quriiri allows you to send SMS messages either through a browser-based interface or by integrating SMS into your own systems. Integration is done using Quriirin interfaces and in this article, Quriirin CTO Thomas Wahlberg shows you how to integrate Quriirin SMS using Python or Node.js.
What is an SMS gateway?
SMS gateway is a service that allows you to send and receive SMS messages programmatically. Quriirin SMS gateway provides trusted interfaces (APIs) through which you can send messages to the recipients of your choice.
When choosing an SMS gateway, consider your use case and take into account the service features such as reliability, GDPR compliance, pricing, message delivery speed and support for different countries. Quriirin SMS Gateway is domestic and you can be confident that your messages will be delivered anywhere in the world. We also offer SMS Sender ID support and many other versatile features.
”The fast and reliable delivery of text messages can be a critical part of a company's customer communication. Quriirin SMS gateway ensures that important messages such as confirmation codes or customer reminders are delivered with confidence. Python and Node.js make integration fast and simple for both small and large message volumes”, says Quriirin CTO Thomas Wahlberg.
How to send a text message using Python
Start the integration by logging into Quriiri and creating a new routing HTTP → SMS. Grab the API key and check the http-url in the Quriiri interface under Message router > Resources. You can then send an SMS message using the following Python code:
import requests
import json
SMS_API_URL = "https://smsapi.quriiri.fi/v1/"
API_KEY = "00000000-0000-0000-0000-000000000000"
headers = {
'Authorization': f'Bearer {API_KEY}',
'Content-Type': 'application/json'
}
body = {
'sender': 'Company Ltd',
'destination': '+35840123456789',
'text': 'Hello from Quriiri'
}
r = requests.post(SMS_API_URL, headers=headers, data=json.dumps(body))
print(r.text)
# Response:
{"errors":[],"warnings":[],"messages":{"+35840123456789":{"converted":"+35840123456789","status":"CREATED"}}}Explanation of the code
- SMS_API_URL: you can find the http address by selecting Message router > Resources
- API_KEY: The API key required for authentication, which you can find in the HTTP->SMS router you created
- Required information to send a message: the sender of the message ’sender’, the recipient ’destination’ and the content of the message ’text’
Integration with Node.js
Start the integration by logging into Quriiri and creating a new routing HTTP → SMS. Grab the API key and check the http-url in the Quriiri interface under Message router > Resources. You can then send an SMS message with the following Node.js code:
const axios = require('axios')
const SMS_API_URL = "https://smsapi.quriiri.fi/v1/"
const API_KEY = "00000000-0000-0000-0000-000000000000"
const payload = {
"sender": "Company Ltd",
"destination": "+35840123456789",
"text": "Hello from Quriiri",
}
async function sendSms() {
try {
const response = await axios.post(SMS_API_URL, payload, {
headers: {
'Authorization': `Bearer ${API_KEY}`,
'Content-Type': 'application/json',
}
});
console.log(`${JSON.stringify(response.data)}`);
} catch (error) {
console.log(`Error message: ${error}`);
}
}
sendSms()
// Response:
{"errors":[],"warnings":[],"messages":{"+35840123456789":{"converted":"+35840123456789","status":"CREATED"}}}Explanation of the code
- SMS_API_URL: you can find the http address by selecting Message router > Resources
- API_KEY: The API key required for authentication, which you can find in the HTTP->SMS router you created
- Required information to send a message: the sender of the message ’sender’, the recipient ’destination’ and the content of the message ’text’
Troubleshooting and error handling
If you have problems sending a message, make sure that:
- You have created HTTP → SMS routing for the event
- API keys and numbers are correct
- The recipient's number has been entered correctly
- Sender ID is not registered to anyone else
Use cases and examples
SMS integration can be used in many different ways, here are some ideas:
- 2FA or two-factor authentication: send a one-time password or confirmation code to the user when logging in. Quriiri also offers SMS verification -service, which creates and checks passwords. All you need to do is include SMS verification as part of your application.
- Automatic reminders and notifications: send notifications about, for example, appointments, delivery situations or changes to the status of your order.
- Marketing campaigns: send users promotional offers or reminders.
Security and data protection
Be sure to pay attention to security with the SMS gateway to avoid abuse:
- Protect API keys: store API keys and IDs securely, and never store them in publicly available sources.
- GDPR: For companies operating in the EU, it is important that customer data is stored in Europe. Quriiri's customer data is always stored in Europe.
- Enable 2fa Quriirin for login: protect your account and enable two-factor authentication. You can find the Quriirin setting in the user interface in your profile.
Summary
Integrating the Quriirin SMS gateway with Python or Node.js is quick and easy. With both programming languages, you can be up and running in minutes. Whether you want to send messages for marketing purposes or use SMS as part of your services and customer communications, we hope our instructions will help you integrate SMS smoothly into your systems.
Try out some code examples and make SMS part of your business. You can try Quriiria for free, if you want to make a test transmission before the actual deployment.
