HTTPS to SMS -rajapinta – Usein kysytyt kysymykset

HTTPS to SMS -rajapinnan avulla voit lähettää tekstiviestejä suoraan omasta järjestelmästäsi Quriirin kautta. Rajapinta on luotettava, turvallinen ja skaalautuva ratkaisu suurtenkin viestimäärien automatisoituun lähetykseen.

1. Miten autentikointi tapahtuu viestin lähetyksessä?

Autentikointi tapahtuu ns. API-avaimen avulla. API-avain luodaan Quriirin käyttöliittymässä ja liitetään mukaan rajapintakutsuun.

2. Voiko yhdellä rajapintakutsulla lähettää viestin usealle vastaanottajalle?

Kyllä voi. Voit määrittää useita vastaanottajia samaan kutsuun.

3. Kuinka monta vastaanottajaa voin laittaa yhteen rajapintakutsuun?

Suositeltu maksimimäärä batch-lähetyksessä on 100 vastaanottajaa.

4. Voiko viestisisältöön lisätä metadataa?

Kyllä voi. Voit lisätä SMS-viestin viestisisältöön metatietoa määrittämällä halutun tiedon haluttuun kohtaan viestiä reitityksessä.

5. Miten/missä määritän viestin vastaanottajat?

Vastaanottajat voidaan määrittää joko suoraan rajapintakutsussa tai valita Quriirin käyttöliittymässä (esim. tietty Quriirin luotu vastaanottajaryhmä).

6. Miten/missä määritän viestin lähettäjätiedon?

Jokaiselle Quriirin kautta lähetettävälle viestille voidaan määrittää:

• Traficomille rekisteröity SMS Sender ID
• Longcode- tai lyhytnumero
• Tallennettu nimi tai numero

Maksimipituudet Suomessa:

• Alfanumeerinen: 11 merkkiä
• Numeerinen: 15 numeroa

Alfanumeerinen lähettäjätieto voi sisältää kirjaimia A–Z, numeroita 0–9, välilyönnin ja väliviivan (-). Merkit å, ä ja ö voivat toimia, mutta niiden toimivuutta ei voida taata kaikilla päätelaitteilla tai verkoissa.

HTTP-rajapinnassa lähettäjätiedon voi asettaa kolmella tavalla:

1. Rajapintakutsussa (prioriteetti 1)
2. Message Router -reitityksessä (prioriteetti 2)
3. Asiakkuuden oletuslähettäjänä (prioriteetti 3)

7. Miten/missä määritän viestin viestisisällön?

Viestisisältö määritetään rajapintakutsussa tai Quriirin käyttöliittymässä. Viestiin voi lisätä myös personointia ja metatietoa.

8. Miten määritän viesteille laskutusviitteen?

Laskutusviitteen voi määrittää:

• suoraan rajapintakutsussa
• tai API-avaimen asetuksissa Quriirin käyttöliittymässä.

9. Miten maksimoin tietoturvan rajapintakutsussa?

Rajapintakutsussa suositellaan aina käytettäväksi salattua TLS-yhteyttä (HTTPS).
Lisäksi voit määrittää:

• IP-osoitekohtaiset rajoitukset
• Domain-kohtaiset rajoitukset

Näin varmistetaan, että rajapintaa voi käyttää vain määritellyistä lähteistä.

Haluatko apua käyttöönotossa?

Asiantuntijamme auttavat sinua mielellään API-avainten luomisessa, reitityksen määrittelyssä sekä teknisessä integroinnissa.

📧 Ota yhteyttä: tuki@quriiri.fi

Dokumentaatio: docs.quriiri.fi