Kako zakazati SMS u Kotlinu

Najjednostavniji način za slanje SMS-a iz Kotlina je korištenje ugrađenog HTTP/Rest SMS API-ja Ozeki SMS Gatewaya. Kada koristite ovaj API, slati ćete SMS poruke slanjem HTTP Post zahtjeva SMS gatewayu. HTTP Post zahtjev će sadržavati poruku formatiranu u json formatu. SMS gateway će poslati ovaj SMS na telefonski broj primatelja i vratit će HTTP 200 OK odgovor na vaš zahtjev. (Slika 1)

kako zakazati sms u kotlinu
Slika 1 - Kako zakazati SMS u Kotlinu

Kotlin kod za slanje zakazanog SMS-a na mobilni uređaj

Kotlin SMS primjer koda u nastavku pokazuje kako možete poslati zakazani SMS koristeći http rest SMS API Ozeki SMS Gatewaya uz pomoć Kotlin Ozeki.Libs.Rest biblioteke. Ova biblioteka vam je dostupna besplatno, a možete je koristiti i mijenjati u bilo kojem od svojih projekata.

Video 1 - Kako preuzeti SendScheduledSms.kt.zip primjer (Video tutorial)

MainActivity.kt 
package send.scheduledsms

import androidx.appcompat.app.AppCompatActivity
import android.os.Bundle
import Ozeki.Libs.Rest.Configuration
import Ozeki.Libs.Rest.MessageApi
import Ozeki.Libs.Rest.Message
import android.text.method.ScrollingMovementMethod
import kotlinx.coroutines.Dispatchers
import kotlinx.coroutines.GlobalScope
import kotlinx.coroutines.launch

class MainActivity : AppCompatActivity() {
    override fun onCreate(savedInstanceState: Bundle?) {
        super.onCreate(savedInstanceState)
        setContentView(R.layout.activity_main)

        val inputToAddress:android.widget.EditText = findViewById(R.id.inputToAddress)
        val inputMessage:android.widget.EditText = findViewById(R.id.inputMessage)
        val date:android.widget.EditText = findViewById(R.id.inputTimeToSendDate)
        val time:android.widget.EditText = findViewById(R.id.inputTimeToSendTime)
        val btnSendRequest:android.widget.Button = findViewById(R.id.btnSendRequest)
        val logBox:android.widget.TextView = findViewById(R.id.logBox)
        logBox.movementMethod = ScrollingMovementMethod()


        val configuration = Configuration(
            username = "http_user",
            password = "qwe123",
            apiurl = "http://10.0.2.2:9509/api"
        )

        val api = MessageApi(configuration)

        btnSendRequest.setOnClickListener {
            if (inputToAddress.text.toString() != "" && inputMessage.text.toString() != ""
                && date.text.toString() != "" && time.text.toString() != "") {
                val datetime = String.format("%s %s", date.text.toString(), time.text.toString())
                val msg = Message()
                msg.ToAddress = inputToAddress.text.toString()
                msg.Text = inputMessage.text.toString()
                msg.TimeToSend = datetime
                GlobalScope.launch(Dispatchers.IO) {
                    val response = api.Send(msg)
                    logBox.text = String.format("%s\n%s", logBox.text, response.toString())
                }
                inputToAddress.text.clear()
                inputMessage.text.clear()
                date.text.clear()
                time.text.clear()
            }
        }

    }
}
main_activity.xml 
<?xml version="1.0" encoding="utf-8"?>
<androidx.constraintlayout.widget.ConstraintLayout xmlns:android="http://schemas.android.com/apk/res/android"
    xmlns:app="http://schemas.android.com/apk/res-auto"
    xmlns:tools="http://schemas.android.com/tools"
    android:layout_width="match_parent"
    android:layout_height="match_parent"
    tools:context=".MainActivity">

    <Button
        android:id="@+id/btnSendRequest"
        android:layout_width="320dp"
        android:layout_height="50dp"
        android:layout_marginTop="36dp"
        android:text="Pošalji"
        android:backgroundTint="#FF3F3F"
        app:layout_constraintEnd_toEndOf="parent"
        app:layout_constraintHorizontal_bias="0.494"
        app:layout_constraintStart_toStartOf="parent"
        app:layout_constraintTop_toBottomOf="@+id/logBox" />

    <TextView
        android:id="@+id/textToAddress"
        android:layout_width="320dp"
        android:layout_height="wrap_content"
        android:layout_marginTop="36dp"
        android:text="Na adresu:"
        android:textSize="20sp"
        app:layout_constraintEnd_toEndOf="parent"
        app:layout_constraintHorizontal_bias="0.498"
        app:layout_constraintStart_toStartOf="parent"
        app:layout_constraintTop_toTopOf="parent" />

    <TextView
        android:id="@+id/textMessage"
        android:layout_width="320dp"
        android:layout_height="wrap_content"
        android:layout_marginTop="20dp"
        android:text="Poruka:"
        android:textSize="20sp"
        app:layout_constraintEnd_toEndOf="parent"
        app:layout_constraintHorizontal_bias="0.505"
        app:layout_constraintStart_toStartOf="parent"
        app:layout_constraintTop_toBottomOf="@+id/inputToAddress" />

    <TextView
        android:id="@+id/textWhen"
        android:layout_width="320dp"
        android:layout_height="wrap_content"
        android:layout_marginTop="20dp"
        android:text="Vrijeme slanja:"
        android:textSize="20sp"
        app:layout_constraintEnd_toEndOf="parent"
        app:layout_constraintHorizontal_bias="0.494"
        app:layout_constraintStart_toStartOf="parent"
        app:layout_constraintTop_toBottomOf="@+id/inputMessage" />

    <EditText
        android:id="@+id/inputToAddress"
        android:layout_width="320dp"
        android:layout_height="wrap_content"
        android:layout_marginTop="20dp"
        android:ems="10"
        android:hint="+36201111111"
        android:inputType="textPersonName"
        app:layout_constraintEnd_toEndOf="parent"
        app:layout_constraintHorizontal_bias="0.505"
        app:layout_constraintStart_toStartOf="parent"
        app:layout_constraintTop_toBottomOf="@+id/textToAddress" />

    <EditText
        android:id="@+id/inputMessage"
        android:layout_width="320dp"
        android:layout_height="100dp"
        android:layout_marginTop="20dp"
        android:ems="10"
        android:gravity="start|top"
        android:hint="Pozdrav svijete!"
        android:inputType="textMultiLine"
        app:layout_constraintEnd_toEndOf="parent"
        app:layout_constraintHorizontal_bias="0.505"
        app:layout_constraintStart_toStartOf="parent"
        app:layout_constraintTop_toBottomOf="@+id/textMessage" />

    <EditText
        android:id="@+id/inputTimeToSendTime"
        android:layout_width="120dp"
        android:layout_height="wrap_content"
        android:layout_marginTop="20dp"
        android:layout_marginEnd="44dp"
        android:ems="10"
        android:hint="15:30:00"
        android:inputType="time"
        app:layout_constraintEnd_toEndOf="parent"
        app:layout_constraintTop_toBottomOf="@+id/textWhen" />

    <TextView
        android:id="@+id/logBox"
        android:layout_width="320dp"
        android:layout_height="80dp"
        android:layout_marginTop="20dp"
        android:scrollbars="vertical"
        android:text="Dnevnici:"
        app:layout_constraintEnd_toEndOf="parent"
        app:layout_constraintHorizontal_bias="0.505"
        app:layout_constraintStart_toStartOf="parent"
        app:layout_constraintTop_toBottomOf="@+id/inputTimeToSendTime" />

    <EditText
        android:id="@+id/inputTimeToSendDate"
        android:layout_width="180dp"
        android:layout_height="wrap_content"
        android:layout_marginTop="20dp"
        android:layout_marginEnd="24dp"
        android:ems="10"
        android:hint="2021-06-16"
        android:inputType="date"
        app:layout_constraintEnd_toStartOf="@+id/inputTimeToSendTime"
        app:layout_constraintHorizontal_bias="1.0"
        app:layout_constraintStart_toStartOf="parent"
        app:layout_constraintTop_toBottomOf="@+id/textWhen" />
</androidx.constraintlayout.widget.ConstraintLayout>

Kako koristiti Kotlin SMS primjer:

Možete koristiti klasu Message za kreiranje SMS-a, a klasu MessageApi možete koristiti za slanje zakazanog SMS-a na SMS gateway. SMS gateway će proslijediti vašu poruku na mobilnu mrežu bilo putem bežične veze ili putem interneta.

Preuzmite SendScheduledSms.kt

Izvorni kod objašnjen u ovom članku može se besplatno preuzeti, koristiti i mijenjati.
Preuzimanje: SendScheduledSms.kt.zip (149Kb)

Što se nalazi u datoteci SendScheduledSms.kt.zip?

Datoteka SendScheduledSms.kt.zip sadrži primjer projekta, koji uključuje Ozeki.Libs.Rest biblioteku. S ovom bibliotekom možete slati, brisati, označavati i primati SMS poruke stvaranjem MessageApi i korištenjem metoda Send(), Delete(), Mark() i Receive(). (Slika 2)

primjer projekta za slanje zakazanih SMS poruka koristeći Kotlin
Slika 2 - Direktorij SendScheduledSms.kt

Kako poslati zakazani SMS iz Kotlina (Brzi koraci)

Za slanje zakazanog SMS-a iz Kotlina:

  1. Instalirajte Ozeki SMS Gateway
  2. Povežite Ozeki SMS Gateway s mobilnom mrežom
  3. Pošaljete testni SMS iz Ozeki GUI
  4. Kreirajte HTTP SMS API korisnika
  5. Android Studio
  6. Preuzmite gore navedeni primjer projekta
  7. Kreirajte SMS stvaranjem novog Message objekta
  8. Kreirajte API za slanje vaše zakazane poruke
  9. Koristite metodu Send za slanje vaše zakazane poruke
  10. Pročitajte odgovornu poruku na konzoli
  11. Provjerite zapisnike u SMS gatewayu

Instalirajte Ozeki SMS Gateway i kreirajte HTTP API korisnika

Da biste mogli slati SMS iz Kotlina, prvo morate instalirati Ozeki SMS Gateway. SMS gateway se može instalirati na istom računalu gdje razvijate svoj Kotlin kod u Android Studiju. Nakon instalacije, sljedeći korak je povezivanje Ozeki SMS Gatewaya s mobilnom mrežom. Možete poslati testni SMS iz Ozeki GUI kako biste potvrdili da vaša mobilna mrežna veza radi. Konačni korak za pripremu vašeg okruženja je kreiranje HTTP SMS API korisnika. Kreirajte korisnika s korisničkim imenom "http_user" i lozinkom "qwe123" kako bi primjer radio bez izmjena.

Nakon što je okruženje postavljeno, možete pokrenuti svoj Kotlin kod.

HTTP API URL za slanje SMS-a iz Kotlina

Da biste poslali zakazani SMS iz Kotlina, vaš Kotlin će morati poslati HTTP zahtjev SMS gatewayu. API URL je prikazan u nastavku. Imajte na umu da IP adresa (127.0.0.1) treba biti zamijenjena IP adresom vašeg SMS gatewaya. Ako je Ozeki SMS Gateway instaliran na istom računalu gdje se pokreće JavaScript SMS aplikacija, ovo može biti 127.0.0.1. Ako je instaliran na drugom računalu, treba biti IP adresa tog računala. 

http://127.0.0.1:9509/api?action=rest

HTTP autentifikacija za slanje zakazanog SMS-a iz Kotlina

Za autentifikaciju Kotlin SMS klijenta, morate poslati korisničko ime i lozinku u base64 kodiranom stringu na poslužitelj u HTTP zahtjevu. Korišteni format je: base64(korisničko_ime+":"+lozinka). U Kotlinu možete koristiti sljedeći kod za ovu kodiranje: 

var usernamePassword = "%s:%s".format(username, password)
return "Basic %s".format(Base64.getEncoder().encodeToString(usernamePassword.toByteArray()))

Na primjer, ako kodirate korisničko ime 'http_user' i lozinku 'qwe123', dobit ćete sljedeći base64 kodirani string: aHR0cF91c2VyOnF3ZTEyMw==. Za slanje

HTTP zaglavlje zahtjeva za slanje SMS-a iz Kotlina

Za slanje SMS poruka, morate uključiti sljedeće retke kao zaglavlja u HTTP zahtjevu. Imajte na umu da uključujemo content type i Authorization zaglavlje. 

Content-Type: application/json
Authorization: Basic QWxhZGRpbjpvcGVuIHNlc2FtZQ==

HTTP zahtjev za slanje SMS-a iz Kotlina

Za slanje SMS-a, vaša Kotlin aplikacija će poslati HTTP zahtjev sličan onome u nastavku. Imajte na umu da ovaj zahtjev sadrži dio HTTP zaglavlja i dio HTTP tijela. HTTP tijelo je JSON kodirani podatkovni string. Sadrži broj primatelja i tekst poruke. 

POST /api?action=sendmsg HTTP/1.1
Connection: Keep-Alive
Content-Length: 320
Content-Type: application/json; charset=utf-8
Accept-Encoding: gzip
Authorization: Basic aHR0cF91c2VyOnF3ZTEyMw==
Host: 10.0.2.2:9509
User-Agent: okhttp/4.2.2

{
	"messages":	[
		{
			"message_id":	"e68f8e11-dce2-48e2-a2c5-1d2efa98272a",
			"to_address":	"+36201111111",
			"text":	"Pozdrav svijete!",
			"create_date":	"2021-06-17T15:04:03",
			"valid_until":	"2021-06-24T15:04:03",
			"time_to_send":	"2021-06-17 15:10:00",
			"submit_report_requested":	true,
			"delivery_report_requested":	true,
			"view_report_requested":	true
		}
	]
}
HTTP odgovor primljen u Kotlin SMS primjeru

Nakon što SMS gateway primi ovaj zahtjev, generirat će HTTP odgovor. HTTP odgovor sadržavat će statusni kod kako bi naznačio je li zahtjev za slanje SMS-a bio uspješan ili ne. Također će vratiti JSON kodiranu strukturu kako bi vam pružio korisne pojedinosti o slanju poruke. 

HTTP/1.1 200 OK
User-Agent: OZEKI 10.3.120 (www.myozeki.com)
Content-Type: application/json; charset=utf8
Last-Modified: Thu, 17 Jun 2021 14:56:26 GMT
Server: 10/10.3.120
Transfer-Encoding: chunked

{
	"http_code": 200,
	"response_code": "SUCCESS",
	"response_msg": "Poruke su u redu za isporuku.",
	"data": {
	  "total_count": 1,
	  "success_count": 1,
	  "failed_count": 0,
	  "messages": [
	    {
	      "message_id": "e68f8e11-dce2-48e2-a2c5-1d2efa98272a",
	      "from_station": "%",
	      "to_address": "+36201111111",
	      "to_station": "%",
	      "text": "Pozdrav svijete!",
	      "create_date": "2021-06-17 15:04:03",
	      "valid_until": "2021-06-24 15:04:03",
	      "time_to_send": "2021-06-17 15:10:00",
	      "submit_report_requested": true,
	      "delivery_report_requested": true,
	      "view_report_requested": false,
	      "tags": [
	        {
	          "name": "Type",
	          "value": "SMS:TEXT"
	        }
	      ],
	      "status": "SUCCESS"
	    }
	  ]
	}
}

Kako poslati zakazani SMS iz Kotlina koristeći SMS API i gornji primjer projekta (Video tutorial)

Ovaj video pokazuje kako preuzeti i koristiti projekt SendScheduledSms.kt. Nakon što otvorite primjer projekta, možda ćete primijetiti da postoji paket pod nazivom Ozeki.Libs.Rest. Ovo je paket koji sadrži MessageApi i sve što vam je potrebno za slanje zakazanog SMS-a koristeći Kotlin.

Video 2 - Kako poslati zakazani SMS s Kotlin kodom iznad (Video tutorial)

Kako provjeriti je li SMS prihvaćen od strane HTTP korisnika

Nakon što je SMS poslan, dobro je provjeriti vaš SMS gateway kako biste vidjeli što je primio. Dnevnik možete provjeriti otvaranjem detalja HTTP korisnika iz Ozeki SMS Gateway upravljačke konzole. Na kraju gornjeg videa možete vidjeti kako provjeriti je li zahtjev primljen od strane http_user-a.

kotlin projekt za slanje zakazanih sms poruka
Slika 3 - SendScheduledSms.kt projekt u Android Studiju

Kako izgleda korištenje aplikacije na telefonu (Video tutorial)

Na slici 4 možete vidjeti korisničko sučelje aplikacije na telefonu. Kao što možete vidjeti na prije-poslije slikama, zakazano slanje SMS-a je vrlo jednostavno s ovom aplikacijom. Nakon što je poruka poslana, dnevnik procesa slanja bit će vidljiv ispod tekstualnog okvira 'Vrijeme za slanje'. Ovdje možete dobiti sve informacije o poslanoj poruci.

primjer kotlin aplikacije za slanje zakazanih sms poruka

Slika 4 - Primjer aplikacije SendScheduledSms prije i nakon što su poruke poslane

Kako dodati Ozeki.Libs.Rest u vlastiti projekt

Ozeki.Libs.Rest knjižnicu možete besplatno preuzeti, koristiti i mijenjati.
Preuzimanje: Ozeki.Libs.Rest.kt.zip (7.66Kb)

Ako odlučite izraditi svoju aplikaciju samostalno samo s Ozeki.Libs.Rest knjižnicom, postoji nekoliko stvari koje trebate promijeniti u osnovnoj aplikaciji. Kako biste koristili Ozeki.Libs.Rest knjižnicu, morate je staviti u java mapu glavnog direktorija
U sljedećem videu pokazat ću vam kako preuzeti i dodati Ozeki.Libs.Rest knjižnicu u vlastiti projekt.

Video 3 - Kako dodati Ozeki.Libs.Rest knjižnicu u vlastitu aplikaciju (Video tutorial)

Ovisnosti

Važno je napomenuti da Ozeki.Libs.Rest knjižnica ima neke ovisnosti. Kako biste je koristili, morate dodati te ovisnosti u Gradle skripte. 

implementation "com.squareup.okhttp3:okhttp:4.2.2"
implementation 'org.jetbrains.kotlinx:kotlinx-coroutines-core:1.5.0'
implementation 'org.jetbrains.kotlinx:kotlinx-coroutines-android:1.5.0'

Kod 1 - Popis ovisnosti koje trebate uključiti.

Dodavanje ovisnosti projektu (Video tutorial) U sljedećem videu naučit ćete kako dodati prethodno spomenute ovisnosti. Počet će s kopiranjem koda i vodit će vas do uspješno priključenih ovisnosti. Video traje samo 53 sekunde, ali sadrži sve potrebne radnje za završetak procesa. Možete pratiti ovaj tutorial bez ikakvog napora.

Video 4 - Kako dodati potrebne ovisnosti (Video tutorial)

Pristup internetu

Kako bi vaša aplikacija mogla poslati HTTP zahtjev, morate omogućiti vašoj aplikaciji da se poveže na internet.
U sljedećem videu pokazat ću vam kako omogućiti pristup internetu za vašu Kotlin aplikaciju. 

<uses-permission android:name="android.permission.INTERNET" />

Kod 2 - Omogućavanje pristupa internetu za vašu Kotlin aplikaciju.

android:usesCleartextTraffic="true"

Kod 3 - Omogućavanje slanja HTTP zahtjeva

Omogućavanje internetske veze za vaš projekt (Video tutorial)

Morate dodati obje ove linije u AndroidManifest.xml datoteku.
U sljedećem videu pokazat ću vam gdje trebate postaviti gornje kodove. Morate dodati obje ove linije u AndroidManifest.xml datoteku. U sljedećem videu pokazat ću vam gdje trebate postaviti gornje kodove. Video će započeti s kopiranjem i lijepljenjem koda, te će vas odvesti do uspješno dodane internetske veze. Ovaj video je detaljan i nudi jednostavno praćenje.

Video 5 - Kako omogućiti pristup internetu za vašu aplikaciju (Video tutorial)

Sažetak

Ovaj vodič pokazuje vam korake za zakazivanje SMS-a u Kotlinu uz korištenje HTTP korisnika Ozeki SMS Gatewaya. Zakazivanje SMS-a za isporuku poruka kada vaši klijenti imaju vremena pročitati ih stvarno vam pomaže u održavanju dobrog odnosa s njima. Briga o malim stvarima poput pronalaženja savršenog trenutka za dijeljenje misli i informacija ključna je ako želite pokazati koliko je vaš posao profesionalan.

Nastavite čitati tutorijale poput ovog na Ozeki web stranici. Postoji više informacija o korištenju Kotlina za rad s SMS porukama, sljedeće naučite Kako primiti SMS u Kotlinu.

Preuzmite Ozeki SMS Gateway sada i iskoristite ono što ste naučili!

More information