Asiakkaiden tehokas tavoittaminen ja sitouttaminen voi parantaa asiakaskokemusta merkittävästi. Tekstiviestit ovat tutkitusti tehokkain kanava viestiä asiakkaiden kanssa. Quriirin avulla voit lähettää tekstiviestejä joko selaimessa toimivan käyttöliittymän kautta tai integroimalla tekstiviestit omiin järjestelmiisi. Integrointi tapahtuu Quriirin rajapintojen avulla ja tässä artikkelissa Quriirin CTO Thomas Wahlberg opastaa, kuinka voit integroida Quriirin tekstiviestit Pythonin tai Node.js avulla.
Mikä on SMS gateway?
SMS gateway on palvelu, joka mahdollistaa tekstiviestien lähettämisen ja vastaanottamisen ohjelmallisesti. Quriirin SMS gateway tarjoaa luotettavat rajapinnat (API), joiden kautta voit lähettää viestejä haluamillesi vastaanottajille.
Kun valitset SMS gatewayta, mieti käyttötarkoitustasi ja huomioi palvelun ominaisuudet, kuten luotettavuus, GDPR-yhteensopivuus, hinnoittelu, viestien toimitusnopeus ja tuki eri maille. Quriirin SMS Gateway on kotimainen ja voit luottaa siihen, että viestit menevät varmasti perille kaikkialle maailmassa. Meiltä löytyy myös SMS Sender ID tuki ja monia muita monipuolisia ominaisuuksia.
”Tekstiviestien nopea ja luotettava toimitus voi olla kriittinen osa yrityksen asiakasviestintää. Quriirin SMS gateway varmistaa, että tärkeät viestit, kuten vahvistuskoodit tai asiakkaan muistutukset menevät varmasti perille. Pythonin ja Node.js:n avulla integrointi on nopeaa ja yksinkertaista sekä pienille että suurille viestimäärille”, kertoo Quriirin CTO Thomas Wahlberg.
Näin lähetät tekstiviestin Pythonin avulla
Aloita integraatio kirjautumalla Quriiriin ja luomalla uusi reititys HTTP → SMS. Ota talteen API-avain ja käy tarkistamassa http-url Quriirin käyttöliittymästä kohdasta Message Router > Resurssit. Tämän jälkeen voit lähettää SMS-viestin seuraavalla Python-koodilla:
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': 'Yritys Oy',
'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"}}}Selitys koodille
- SMS_API_URL: löydät http-osoitteen valitsemalla Message Router > Resurssit
- API_KEY: Autentikointiin vaadittu reitityskohtainen API-avain, jonka löydät luomastasi HTTP->SMS reitityksestä
- Vaaditut tiedot viestin lähettämiseen: viestin lähettäjä eli ’sender’, vastaanottaja ’destination’ sekä viestin sisältö ’text’
Integraatio Node.js:n avulla
Aloita integraatio kirjautumalla Quriiriin ja luomalla uusi reititys HTTP → SMS. Ota talteen API-avain ja käy tarkistamassa http-url Quriirin käyttöliittymästä kohdasta Message Router > Resurssit. Tämän jälkeen voit lähettää SMS-viestin seuraavalla Node.js-koodilla:
const axios = require('axios')
const SMS_API_URL = "https://smsapi.quriiri.fi/v1/"
const API_KEY = "00000000-0000-0000-0000-000000000000"
const payload = {
"sender": "Yritys Oy",
"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"}}}Selitys koodille
- SMS_API_URL: löydät http-osoitteen valitsemalla Message Router > Resurssit
- API_KEY: Autentikointiin vaadittu reitityskohtainen API-avain, jonka löydät luomluomastasi HTTP->SMS reitityksestä
- Vaaditut tiedot viestin lähettämiseen: viestin lähettäjä eli ’sender’, vastaanottaja ’destination’ sekä viestin sisältö ’text’
Vianmääritys ja virheenkäsittely
Jos viestin lähettämisessä on ongelmia, varmista, että:
- Olet luonut tapahtumalle reitityksen HTTP → SMS
- API-avaimet ja numerot ovat oikein
- Vastaanottajan numero on kirjoitettu oikein
- Sender ID ei ole rekisteröity kenellekään toiselle
Käyttötapaukset ja esimerkkejä
SMS-integraatiota voi hyödyntää monin eri tavoin, tässä muutamia ideoita:
- 2FA eli kaksivaiheinen tunnistautuminen: lähetä kertakäyttöinen salasana tai vahvistuskoodi käyttäjälle sisäänkirjautumisen yhteydessä. Quriirilta löytyy myös SMS-varmennus -palvelu, joka luo ja tarkistaa salasanat. Sinun tarvitsee vain liittää SMS-varmennus osaksi sovellustasi.
- Automaattiset muistutukset ja ilmoitukset: lähetä ilmoituksia esimerkiksi ajanvarauksista, toimitustilanteista tai tilauksen tilamuutoksista.
- Markkinointikampanjat: lähetä käyttäjille kampanjatarjouksia tai muistutuksia.
Turvallisuus ja tietosuoja
Muista huomioida tietoturva SMS gatewayn kanssa, jotta vältyt väärinkäytöksiltä:
- Suojaa API-avaimet: säilytä API-avaimia ja tunnuksia turvallisesti, äläkä koskaan tallenna niitä julkisesti saatavilla oleviin lähteisiin.
- GDPR: EU-alueella toimiville yrityksille on tärkeää, että asiakastiedot tallennetaan Euroopassa. Quriirin asiakastiedot säilyvät aina Euroopassa.
- Ota käyttöön 2fa Quriirin kirjautumisessa: suojaa tilisi ja ota käyttöön kaksivaiheinen tunnistautuminen. Löydät asetuksen Quriirin käyttöliittymästä omasta profiilista.
Yhteenveto
Quriirin SMS gatewayn integroiminen Pythonin tai Node.js:n avulla on nopeaa ja helppoa. Molempien ohjelmointikielien avulla pääset liikkeelle muutamassa minuutissa. Riippumatta siitä, haluatko lähettää viestejä markkinointitarkoituksessa vai käyttää tekstiviestejä osana palveluitasi ja asiakasviestintää, toivomme, että ohjeemme auttavat sinua integroimaan tekstiviestit sujuvasti osaksi järjestelmiäsi.
Kokeile koodiesimerkkejä ja ota tekstiviestit osaksi liiketoimintaasi. Voit kokeilla Quriiria ilmaiseksi, mikäli haluat tehdä testilähetyksen ennen varsinaista käyttöönottoa.
