Suplemen SMS Gateway
Dibuat oleh: Rosihan Ari YuanaKonsep Membuat SMS Broadcast
Pada bagian ini akan saya paparkan bagaimana ide membuat script PHP untuk keperluan SMS broadcast atau mengirim sebuah pesan SMS langsung ke banyak nomor sekaligus.
Untuk melakukan SMS broadcast, terlebih dahulu Anda harus memiliki data beberapa nomor HP yang digunakan untuk pengiriman SMS. Nomor HP ini nanti disimpan dalam tabel PBK (phonebook) yang ada di database Gammu.
Berikut ini cara menambahkan data nomor hp pada tabel PBK. 1. Masuk ke phpMyAdmin (http://localhost/phpmyadmin) 2. Masukkan username dan password MySQL (bila diminta)
3. Masuk ke database Gammu (dalam contoh ini saya menggunakan nama database ‘SMSD’), dan klik tabel PBK (phonebook)
4. Kemudian klik menu INSERT pada bagian atas phpMyAdmin
5. Kemudian isikan nama dan nomor hp pada kotak Name dan Number yang disediakan dalam form (pada kotak ID biarkan kosong)
Catatan:
Anda dapat menggunakan prefix +62 pada nomor hp nya, contoh no hp aslinya adalah 08882978041, maka 0 paling depan diganti dengan +62, sehingga menjadi +628882978041. 6. Kemudian klik tombol GO (terletak di paling bawah halaman).
7. Jika ingin memasukkan data phonebook kembali, lakukan langkah no. 3 kembali. Untuk melihat data phonebook yang sudah masuk, silakan klik menu BROWSE
Berikut ini contoh tampilan data phonebook yang telah tersimpan di tabel PBK
Setelah proses di atas, kita telah mempunyai data nomor hp yang digunakan untuk SMS broadcast. Pada tabel PBK, terdapat pula field bernama GROUPID. Field ini digunakan untuk pengelompokan data nomor telp. Misalkan Anda membuat group no hp untuk teman sekolah, dan teman kantor. Untuk teman sekolah diberi nomor GROUPID nya misalkan 1 dan teman kantor GROUPID nya adalah 2. Maka caranya cukup mengganti angka -1 ini pada form masukan data. Nilai -1 pada GroupID ini adalah default yang artinya bukan menjadi group apapun.
Contoh pemberian GroupID:
Setelah data nomor hp kita dapatkan, selanjutnya kita bisa membuat script PHP untuk mengirimkan SMS broadcast. Script SMS Broadcast bisa Anda lihat di folder SCRIPT SMS > BROADCAST.
Cara menjalankan script SMS broadcast tersebut adalah, pindahkan folder BROADCAST ke dalam direktori WWW pada C:\AppServ atau di HTDOCS jika Anda menggunakan XAMPP.
Kemudian, bukalah file koneksi.php menggunakan WordPad atau Notepad untuk mengubah konfigurasi koneksi MySQLnya. Isikan $dbUser, $dbPass dan $dbName.
Selanjutnya jalankan script index.php melalui browser dengan URL http://localhost/broadcast atau http://localhost/broadcast/index.php.
Berikut ini tampilan SMS Broadcast nya:
Masukkan isi SMS pada kotak yang disediakan, kemudian pilih Group yang ingin dikirimi SMS nya. Jika Anda ingin mengirim SMS pada semua nomor hp pada Phonebook, maka pilih option ‘Semua’. Jika hanya ingin mengirim pada Group tertentu, maka pilih nomor Group yang diinginkan.
Jangan lupa, sebelum script tersebut dijalankan, service Gammu harus sudah dijalankan terlebih dahulu. Script SMS Broadcast yang diberikan di sini hanya bisa untuk mengirim SMS dengan panjang karakter tidak lebih dari 160 buah. Anda dapat memodifikasi script tersebut supaya bisa mengirim lebih dari 160 karakter (long SMS), dengan terlebih dahulu mempelajari tekniknya di:
http://blog.rosihanari.net/teknik-mengirim-long-text-sms-gammu-dengan-query-sql Catatan:
Dalam tutorial ini, kita data phonebook kita manfaatkan tabel PBK yang sudah menjadi tabel bawaan GAMMU. Anda bisa membuat tabel lain dengan field-field yang bisa ditentukan sendiri. Tabel ini tetap dibuat di dalam database GAMMU (dalam contoh ini database SMSD).
PENTING !!!
Jangan sekali-kali mengubah struktur tabel-tabel bawaan GAMMU seperti inbox, sentitems, outbox, pbk dll karena bisa mengakibatkan GAMMU tidak bisa berjalan (Error).
Konsep Membuat SMS REG dan UNREG
Pada bagian ini akan saya paparkan konsep bagaimana membuat script SMS Gateway dengan PHP untuk layanan REG dan UNREG. Dalam contoh ini, bila seseorang mengirim SMS dengan format REG#NAMA, maka secara otomatis no hp dan nama mereka akan tersimpan di tabel ‘PBK’ atau phonebook di dalam database Gammu. Setelah no hp tersebut tersimpan dalam tabel ‘PBK’ maka Anda dapat mengirim SMS broadcast ke seluruh no hp yang tersimpan. Kemudian bila seseorang mengirim SMS dengan format UNREG, maka secara otomatis pula data no hp dan nama mereka di dalam tabel ‘PBK’ akan terhapus. Dalam script PHP ini, tersedia pula layanan auto reply atau auto response SMS. Sebagai contoh misalkan seseorang mengirim SMS REG#NAMA, maka secara otomatis mereka akan mendapat balasan SMS berbunyi ‘TERIMA KASIH ANDA SUDAH MELAKUKAN REG’, demikian pula sebaliknya jika mengirim SMS UNREG.
Konsep membuat sms REG dan UNREG atau secara secara umum sms berbentuk sms auto reply atau auto response adalah:
1. Baca SMS yang belum diproses di dalam tabel INBOX.
Untuk membedakan SMS yang belum diproses atau belum, bisa dilihat di field ‘PROCESSED’ yang terdapat di tabel INBOX dalam database ‘SMSD’. SMS yang belum diproses akan bernilai ‘FALSE’ pada field ‘PROCESSED’ tersebut.
Data SMS yang dibaca pada tabel INBOX ini hanyalah SENDERNUMBER, TEXTDECODED dan ID. SENDERNUMBER atau no hp si pengirim ini nanti digunakan untuk mengirim SMS balasan atau akan diproses sesuai keperluan, TEXTDECODED untuk membaca isi SMS, dan ID yang nantinya akan digunakan untuk menandai SMS yang sudah diproses atau belum.
2. Lakukan pemrosesan data SMS yang dibaca
3. Setelah data SMS dibaca, lakukan pengubahan status PROCESSED yang tadinya FALSE menjadi TRUE pada data SMS yang ada di INBOX berdasarkan ID sms nya. Langkah ini untuk menandai SMS yang sudah diproses sehingga untuk selanjutnya tidak akan diproses lagi.
Ketiga langkah di atas dilakukan secara terus menerus oleh script PHP yang kita buat. Sebaiknya proses tersebut dilakukan setiap waktu interval tertentu misalnya setiap 5 detik sekali atau yang lain, asal jangan terlalu lama dan jangan terlalu cepat misalkan 1 detik. Jika interval waktu proses terlalu lama akan mengakibatkan SMS response atau balasan yang diterima oleh si pengirim juga semakin lama. Sedangkan interval waktu proses yang terlalu cepat akan berefek tidak bagus jika jumlah data yang diproses sangat banyak.
Dalam script PHP untuk proses REG dan UNREG ini terdapat 3 buah script yaitu: index.php, ajax.js dan run.php. File index.php merupakan halaman depan script, file run.php digunakan untuk memproses setiap sms yang masuk di dalam INBOX, dan file ajax.js digunakan untuk menjalankan script run.php setiap interval waktu tertentu. Dalam contoh ini interval waktu yang dipilih adalah 3 detik (3000 mili sekon).
Untuk menjalankan script SMS Gateway REG dan UNREG ini cukup dengan memanggil script index.php melalui browser (http://localhost/reg atau http://localhost/reg/index.php).
Sebelum menjalankan script tersebut, jangan lupa untuk memindahkan folder ‘reg’ yang berisi script ke direktori web Anda di WWW atau HTDOCS. Jangan lupa pula untuk menjalankan service Gammu dan mengubah konfigurasi koneksi MySQL di file koneksi.php.
Konsep Membuat Auto On Scheduled SMS
Auto On scheduled SMS atau SMS terjadwal adalah SMS yang secara otomatis akan terkirim pada saat
tertentu (tanggal dan jam tertentu) yang telah diset terlebih dahulu.
Untuk keperluan pembuatan Auto On Scheduled SMS ini, kita memerlukan sebuah tabel dalam database guna menyimpan data SMS yang akan dikirim secara otomatis beserta schedule nya. Dalam contoh ini, kita beri nama tabelnya ‘sms_auto’
Sedangkan untuk nomor-nomor hp tujuan yang akan dikirimi SMS otomatis ini, kita memanfaatkan tabel ‘pbk’ yang sudah ada.
Berikut ini struktur kolom (field) tabel untuk menyimpan data SMS dan schedule nya.
ID SMS SCHEDULE STATUS
Keterangan:
Field ID digunakan untuk penanda setiap SMS terjadwal yang berupa bilangan bulat (INT) autoincrement. Field SMS digunakan untuk menyimpan pesan SMS yang dikirim melalui auto on scheduled. Tipe data field SMS ini adalah VARCHAR (160). Field SCHEDULE untuk menyimpan waktu kapan SMS akan terkirim. Tipe data yang digunakan field SCHEDULE adalah DATETIME. Sedangkan field STATUS digunakan sebagai penanda bahwa SMS tersebut sudah dikirim atau belum. Jika SMS belum terkirim, kita akan beri tanda 0, dan jika sudah terkirim kita beri tanda 1.
Berikut ini cara membuat tabel sms_auto nya.
1. Masuk ke phpMyAdmin (http://localhost/phpmyadmin) 2. Masuk ke database Gammu (SMSD)
3. Buat tabel sms_auto pada database SMS tersebut dengan mengisikan nama tabel ‘sms_auto’ pada kotak ‘CREATE NEW TABLE ON DATABASE …’ dan isi ‘4’ pada kotak NUMBER OF FIELDS
Lalu klik GO.
Kemudian klik SAVE
5. Sebagai tanda bahwa tabel ‘sms_auto’ ini sudah berhasil di buat, Anda bisa melihat tabel tersebut muncul di sisi sebelah kiri pada phpmyadmin.
Setelah sukses membuat tabel ‘sms_auto’ ini, selanjutnya kita bisa masukkan beberapa data pesan SMS beserta jadwal pengirimannya pada tabel. Adapun caranya seperti berikut:
2. Klik menu INSERT pada menu phpmyadmin
3. Isikan pesan SMS dan schedule nya pada kotak isian yang disediakan
Untuk mengisi schedule, klik tanda lalu pilih tanggal (YYYY-MM-DD) dan waktunya (hh:mm:ss)
Dalam contoh di atas, sms akan terkirim pada tanggal 14 Juni 2010 pada pukul 21:10 Catatan:
Untuk field ID, tidak usah diisi karena nantinya secara otomatis akan terisi sendiri begitu data tersimpan.
Kemudian klik GO.
Untuk melihat daftar SMS terjadwal yang sudah tersimpan dalam tabel ‘sms_outbox’, caranya klik tabel ‘sms_auto’
Lalu klik menu BROWSE
Setelah diklik BROWSE akan muncul daftar SMS dan schedule nya sbb:
Setelah kita simpan beberapa data SMS terjadwal, selanjutnya kita bisa jalankan script PHP untuk mengirim SMS nya secara otomatis. Sebelum menjalankan scriptnya, pastikan Anda sudah pindahkan folder ‘auto’ ke folder WWW pada direktori AppServ atau HTDOCS jika menggunakan XAMPP. Lakukan konfigurasi pula pada koneksi MySQL nya di dalam script koneksi.php
Untuk menjalankan script auto onscheduled SMS ini, cukup buka URL http://localhost/auto Ide dasar untuk membuat script auto on scheduled SMS ini adalah:
1. Cari data SMS di tabel ‘sms_auto’ yang waktu schedule nya kurang atau sama dengan saat ini, serta berstatus 0 (belum dikirim)
2. Dari hasil no. 1, baca ID dan isi dari setiap SMS nya
3. Untuk setiap SMS yang dibaca, kirimkan pada semua nomor HP.
Di dalam script run.php terdapat mekanisme mengubah status SMS yang sudah terkirim menjadi 1. Hal ini dilakukan supaya SMS yang sudah terkirim ini tidak akan terkirim lagi (mencegah pengiriman ganda). Waktu yang dipilih pada script Auto On Scheduled SMS ini berdasarkan WIB (Waktu Indonesia Barat). Jika Anda berlokasi di WITA, maka editlah script run.php pada bagian
$sekarang = date("Y-m-d H:i:s", mktime(date("H")+0, date("i"), date("s"), date("m"), date("d"), date("Y")));
Ubahlah menjadi
$sekarang = date("Y-m-d H:i:s", mktime(date("H")+1, date("i"), date("s"), date("m"), date("d"), date("Y")));
Karena WITA adalah satu jam lebih dahulu daripada WIB. Jika Anda berlokasi di WIT, ubahlah menjadi
$sekarang = date("Y-m-d H:i:s", mktime(date("H")+2, date("i"), date("s"), date("m"), date("d"), date("Y")));
