Īsziņu izsūtīšana no e-pasta
Uzsākot sadarbību, klientam tiek izveidots konts SIA “Sales.lv” izstrādātajā sistēmā “Traffic”, kas nodrošina SMS sūtīšanu. Šis konts var tikt izmantots gan manuālai izsūtīšanai, gan automatizētai izsūtīšanai izmantojot HTTP API. Šeit aprakstītais process ļaus padot ziņojumus no jūsu sistēmas kā attiecīgi veidotu e-pasta ziņojumu, kas gala lietotājam tiks piegādāts kā īsziņa.
Lai labāk izprastu gaidāmos rezultātus un novērstu nepatīkamu pārsteigumu un pārpratumu rašanos, aicinām iepazīties ar ierobežojumiem, kuri attiecas uz SMS saturu un garumu.
Kad esam uzsākuši sadarbību, klientam tiek piešķirta tam unikāla API atslēga, kuru izmantot automatizētai īsziņu izsūtīšanai. Šī atslēga ir izmantojama veicot visus API pieprasījumus. Šajā gadījumā API atslēga tiek norādīta kā daļa no saņēmēja e-pasta adreses. Gadījumā, ja atslēga ir pazaudēta vai drošības apsvērumu dēļ nepieciešama jauna, pēc klienta pieprasījuma varam to atjaunot.
SMS izsūtīšanai paredzētais e-pasts jāveido šādi:
To (saņēmēja) lauks: Saņēmēja tālruņa numurs + "@" simbols + jūsu API atslēga + ".traffic-api.lv".
Ja saņēmēja tāruņa numurā nav iekļauts valsts kods, tiek pieņemts, ka tas ir tāds pats, kā kontā iestatītais noklusējuma valsts kods. Savukārts, ja numurā valsts kods ir iekļauts, nav nepieciešams papildus norādīt "+" vai "00" numura sākumā, kā tas būtu veicot starptautiskos telefona zvanus.
From (sūtītāja) lauks: brīvi izvēlēta, jūsu kontrolē esoša e-pasta adrese, kura spēj saņemt e-pastus. Nepiedalās SMS izsūtīšanas procesā, taču var palīdzēt novērst problēmas, ja tādas rastos.
Subject (tēma): Šeit varat norādīt vēlamo sūtītāja identifikatoru (vārdisko numuru). Tam jābūt vienam no kontam iepriekš piešķirtajiem sūtītāja identifikatoriem. Ja norādītais sūtītāja identifikators nesakritīs ar piešķirto, vai nebūs noradīts vispār, tiks izmantots kontam piešķirtais noklusējuma identifikators.
Text (ziņojuma saturs): Šeit jānorāda sūtāmās īsziņas saturs.
Piemēram, ja jums ir konts ar līdzīgiem parametriem:
noklusējuma valsts kods 371 (Latvija);
API atslēga XXXXXXXXXX;
Sūtītāja indentifikators "NO",
lai nosūtītu īsziņu tālruņa numuram 29999999 (Latvijas numurs) ar saturu "Sveicināti!", jāizveido e-pasta ziņojums, kas satur:
From: piemēram@piemēram.lv (šeit norādītais nav būtisks)
To: 299999999@XXXXXXXXXX.traffic-api.lv or 37129999999@XXXXXXXXXX.traffic-api.lv
Subject: NO
Text: Sveiki!
Lai nosūtītu ziņojumu numuram 69999999 (Lietuvas numurs), e-pasta ziņojumam jābūt veidotam tieši tāpat, taču To (saņēmēja) adresi, šajā gadījumā nepieciešams norādīt 37069999999@XXXXXXXXXX.traffic-api.lv.
Lai labāk izprastu gaidāmos rezultātus un novērstu nepatīkamu pārsteigumu un pārpratumu rašanos, aicinām iepazīties ar ierobežojumiem, kuri attiecas uz SMS saturu un garumu.
Datu apmaiņa e-pastā
Kad esam uzsākuši sadarbību, klientam tiek piešķirta tam unikāla API atslēga, kuru izmantot automatizētai īsziņu izsūtīšanai. Šī atslēga ir izmantojama veicot visus API pieprasījumus. Šajā gadījumā API atslēga tiek norādīta kā daļa no saņēmēja e-pasta adreses. Gadījumā, ja atslēga ir pazaudēta vai drošības apsvērumu dēļ nepieciešama jauna, pēc klienta pieprasījuma varam to atjaunot.
SMS izsūtīšanai paredzētais e-pasts jāveido šādi:
To (saņēmēja) lauks: Saņēmēja tālruņa numurs + "@" simbols + jūsu API atslēga + ".traffic-api.lv".
Ja saņēmēja tāruņa numurā nav iekļauts valsts kods, tiek pieņemts, ka tas ir tāds pats, kā kontā iestatītais noklusējuma valsts kods. Savukārts, ja numurā valsts kods ir iekļauts, nav nepieciešams papildus norādīt "+" vai "00" numura sākumā, kā tas būtu veicot starptautiskos telefona zvanus.
From (sūtītāja) lauks: brīvi izvēlēta, jūsu kontrolē esoša e-pasta adrese, kura spēj saņemt e-pastus. Nepiedalās SMS izsūtīšanas procesā, taču var palīdzēt novērst problēmas, ja tādas rastos.
Subject (tēma): Šeit varat norādīt vēlamo sūtītāja identifikatoru (vārdisko numuru). Tam jābūt vienam no kontam iepriekš piešķirtajiem sūtītāja identifikatoriem. Ja norādītais sūtītāja identifikators nesakritīs ar piešķirto, vai nebūs noradīts vispār, tiks izmantots kontam piešķirtais noklusējuma identifikators.
Text (ziņojuma saturs): Šeit jānorāda sūtāmās īsziņas saturs.
Piemērs
Piemēram, ja jums ir konts ar līdzīgiem parametriem:
noklusējuma valsts kods 371 (Latvija);
API atslēga XXXXXXXXXX;
Sūtītāja indentifikators "NO",
lai nosūtītu īsziņu tālruņa numuram 29999999 (Latvijas numurs) ar saturu "Sveicināti!", jāizveido e-pasta ziņojums, kas satur:
From: piemēram@piemēram.lv (šeit norādītais nav būtisks)
To: 299999999@XXXXXXXXXX.traffic-api.lv or 37129999999@XXXXXXXXXX.traffic-api.lv
Subject: NO
Text: Sveiki!
Lai nosūtītu ziņojumu numuram 69999999 (Lietuvas numurs), e-pasta ziņojumam jābūt veidotam tieši tāpat, taču To (saņēmēja) adresi, šajā gadījumā nepieciešams norādīt 37069999999@XXXXXXXXXX.traffic-api.lv.
Atjaunināts: 09/06/2021
Paldies!