netgsm/sms

Netgsm Sms

v2.0.7 2023-08-07 11:53 UTC

Requires

• php: >=7.2.5

MIT

• Netgsm

README

Netgsm Sms paket aboneliği bulunan kullanıcılarımız için composer paketidir.

İletişim & Destek

Netgsm API Servisi ile alakalı tüm sorularınızı ve önerilerinizi [e-mail] adresine iletebilirsiniz.

Supported Laravel Versions

Laravel 6.x, Laravel 7.x, Laravel 8.x, Laravel 9.x, Laravel 10.x

Supported Lumen Versions

Lumen 6.x, Lumen 7.x, Lumen 8.x, Lumen 9.x,

Supported Symfony Versions

Symfony 4.x, Symfony 5.x, Symfony 6.x

Supported Php Versions

PHP 7.2.5 ve üzeri

Doküman

https://www.netgsm.com.tr/dokuman/ API Servisi için hazırlanmış kapsamlı dokümana ve farklı yazılım dillerinde örnek amaçlı hazırlanmış örnek kodlamalara https://www.netgsm.com.tr/dokuman adresinden ulaşabilirsiniz.

Kurulum

composer require netgsm/sms

.env dosyası içerisinde NETGSM ABONELİK bilgileriniz tanımlanması zorunludur.

NETGSM_USERCODE=""
NETGSM_PASSWORD=""
NETGSM_HEADER=""

PARAMETRELER

Parametre	Anlamı
encoding	Türkçe karakter desteği isteniyorsa bu alana TR girilmeli, istenmiyorsa null olarak gönderilmelidir. SMS boyu hesabı ve ücretlendirme bu parametreye bağlı olarak değişecektir.
startdate	Gönderime başlayacağınız tarih. (ddMMyyyyHHmm) * Boş bırakılırsa mesajınız hemen gider.
stopdate	İki tarih arası gönderimlerinizde bitiş tarihi.(ddMMyyyyHHmm)* Boş bırakılırsa sistem başlangıç tarihine 21 saat ekleyerek otomatik gönderir.
bayikodu	Bayi üyesi iseniz bayinize ait kod
filter	Ticari içerikli SMS gönderimlerinde bu parametreyi kullanabilirsiniz. Ticari içerikli bireysele gönderilecek numaralar için İYS kontrollü gönderimlerde ise "11" değerini, tacire gönderilecek İYS kontrollü gönderimlerde ise "12" değerini almalıdır. null gönderildiği taktirde filtre uygulanmadan gönderilecektir.İstek yapılırken gönderilmesi zorunludur. Ticari içerikli ileti gönderimi yapmıyorsanız 0 gönderilmelidir.
appkey	Geliştirici hesabınızdan yayınlanan uygulamanıza ait id bilgisi.
bulkid	başarılı mesaj gönderimlerinizde dönen görevid (bulkid) nizdir.

1:n SMS GÖNDERİMİ

SMS'lerinizi 1:n yöntemiyle birden fazla numaraya aynı anda tek gönderimde iletebilirsiniz.

        use Netgsm\Sms\SmsSend;
        $data=array(
            'message'=>'test mesajı',
            'no'=>['553xxxxxxx','553xxxxxxx'],
            'header'=>'MESAJ_BASLİK',
            'filter'=>0,
            'encoding'=>'tr',
            'startdate'=>'170220231000',
            'stopdate'=>'170220231200',
            'bayikodu'=>'1312...',
            'appkey'=>'A123-F3DASD-XXXXX....'
        );
        $sms= new SmsSend;
        $cevap=$sms->smsGonder($data);
        dd($cevap);
        

Başarılı istek örnek

Array
(
    [code] => 00
    [bulkid] => 1311033503
    [durum] => Gönderdiğiniz SMS'inizin başarıyla sistemimize ulaştığını gösterir. 00 : Mesajınızın tarih formatına ilişkin bir hata olmadığı anlamına gelir. 123xxxxxx : Gönderilen SMSe ait ID bilgisi, Bu görevid (bulkid) niz ile mesajınızın iletim raporunu sorguyabilirsiniz.
)

Başarısız istek örnek

Array
(
    [code] => 30
    [durum] => Geçersiz kullanıcı adı , şifre veya kullanıcınızın API erişim izninin olmadığını gösterir.Ayrıca eğer API erişiminizde IP sınırlaması yaptıysanız ve sınırladığınız ip dışında gönderim sağlıyorsanız 30 hata kodunu alırsınız. API erişim izninizi veya IP sınırlamanızı , web arayüzden; sağ üst köşede bulunan ayarlar> API işlemleri menüsunden kontrol edebilirsiniz.
)

n:n SMS GÖNDERİMİ

Birden fazla farklı SMS içeriğini farklı numaralara aynı anda tek pakette gönderebilirsiniz.

        use Netgsm\Sms\SmsSend;
        $msGsm=array(
                    array('gsm'=>'553XXXXXX','message'=>'MESAJ METNİ 1'),
                    array('gsm'=>'553XXXXXX','message'=>'MESAJ METNİ 2')
                );
        $data=array('startdate'=>'170220231210','stopdate'=>'170220231300','header'=>'BASLIGINIZ','filter'=>0);
        $sms=new SmsSend;
        $cevap=$sms->smsGonderNN($msGsm,$data);
        dd($cevap);
        

Başarılı istek örnek

Array
(
    [code] => 00
    [bulkid] => 1311033503
    [durum] => Gönderdiğiniz SMS'inizin başarıyla sistemimize ulaştığını gösterir. 00 : Mesajınızın tarih formatına ilişkin bir hata olmadığı anlamına gelir. 123xxxxxx : Gönderilen SMSe ait ID bilgisi, Bu görevid (bulkid) niz ile mesajınızın iletim raporunu sorguyabilirsiniz.
)

Başarısız istek örnek

Array
(
    [code] => 30
    [durum] => Geçersiz kullanıcı adı , şifre veya kullanıcınızın API erişim izninin olmadığını gösterir.Ayrıca eğer API erişiminizde IP sınırlaması yaptıysanız ve sınırladığınız ip dışında gönderim sağlıyorsanız 30 hata kodunu alırsınız. API erişim izninizi veya IP sınırlamanızı , web arayüzden; sağ üst köşede bulunan ayarlar> API işlemleri menüsunden kontrol edebilirsiniz.
)

TEKLİ SMS GÖNDERİMİ

        use Netgsm\Sms\SmsSend;
        $sms=new SmsSend;
        $data=array(
            'msgheader'=>"",
            'gsm'=>'553XXXXXXX',
            'message'=>'Merhaba',
            'filter'=>'0',
            'startdate'=>'270120230950',
            'stopdate'=>'270120231030',
        );

        $sonuc=$sms->smsgonder1_1($data);
        dd($sonuc);
       

Başarılı istek örnek

Array
(
    [code] => 00
    [aciklama] => Görevinizin tarih formatinda bir hata olmadığını gösterir.
    [bulkid] => 1311044635
)

Başarısız istek örnek

Array
(
    [code] => 40
    [aciklama] => Mesaj başlığınızın (gönderici adınızın) sistemde tanımlı olmadığını ifade eder. Gönderici adlarınızı API ile sorgulayarak kontrol edebilirsiniz.
)

SMS SORGULAMA

Gönderilen mesajların son 3 aya kadar raporlarını sorguyarak; iletim durumlarını öğrenebilirsiniz.

Parametre	Anlamı
bulkid	başarılı mesaj gönderimlerinizde dönen görevid (bulkid) nizdir.
type=0	Tek BulkID sorgular.
type=2	İki tarih arasında sorgulama yapar.
bastar	İki tarih arası sorgulamalarınızda başlangıç tarihidir(ddmmyyyy)
bittar	İki tarih arası sorgulamalarınızda bitiş tarihidir(ddmmyyyy) Bütün numaralar birbirlerinden <BR> kodu ile ayrılmiştir.

status

Kod	Anlamı
0	İletilmeyi bekleyenler
1	İletilmiş olanlar
2	Zaman aşımına uğramış olanlar
3	Hatalı veya kısıtlı numara
4	Operatöre gönderilemedi
11	Operatör tarafından kabul edilmemiş olanlar
12	Gönderim hatası olanlar
13	Mükerrer olanlar
100	Tüm mesaj durumları
103	Başarısız Görev (Bu görevin tamamı başarısız olmuştur.)

        use Netgsm\Sms\SmsSend;
        $sms=new SmsSend;
        $data=array('bulkid'=>'1311042194','bastar'=>'010220231500','bittar'=>'070220231500','status'=>'100','type'=>2);
        //bulkid girildiğinde type 0 gönderilmelidir.type=0 girildiğinde bastar ve bittar girilmesine gerek bulunmamaktadır.
        //bastar ve bittar girildiğinde type 2 gönderilmelidir.
        $sonuc=$sms->smsSorgulama($data);
        dd($sonuc);
       

Başarılı istek sonuç

Array
(
    [durum] => İletilmiş olanlar
    [durumcode] => 1
    [operator] => Türk Telekom
    [operatorcode] => 20
    [hataaciklama] => Hata Yok.
    [hatakod] => 0
    [cepno] => 905531105200
    [mesajboy] => 1
    [tarih] => 23.01.2023 09:35:00
)

Başarısız istek sonuç

Array
(
    [code] => 60
    [aciklama] => Arama kriterlerinize göre listelenecek kayıt olmadığını ifade eder.
)

SMS İPTALİ

İleri tarihe zamanlanmış SMS'lerinizi iptal edebilirsiniz ya da görev zamanını değiştirebilirsiniz.

Parametre	Anlamı
type=0	gönderilirse görev iptal edilir.
type=1	gönderilip startdate stopdate girilirse güncelleme işlemi yapılır

        $sms=new SmsSend;
        $data=array('bulkid'=>'1311176624','startdate'=>'180220230100','stopdate'=>'180220231000','type'=>1);
        //type=0 gönderilirse  startdate ve stopdate gönderilmesine gerek yoktur.
        //type=1 gönderilirse stardate ve stopdate değerleri güncellenebilir.
        $sonuc=$sms->smsiptal($data);
        dd($sonuc);
      

Başarılı istek sonuç

Array
(
    [aciklama] => İleri zamanlı görevinizin başarılı bir şekilde iptal edilğini ifade eder.
    [code] => 00
)

Başarısız istek sonuç

Array
(
    [aciklama] => Baslangiç ve bitis tarihleri arasindaki fark en az 1 , en fazla 21 saat olmalidir.
    [code] => 60
)

GELEN SMS SORGULAMA

Aboneliğinizde bulunan Paket - Kampanya bilgilerine bu servisten ulaşabilirsiniz.

        use Netgsm\Sms\SmsSend;	
        $islem=new SmsSend;
        $data=array('startdate'=>'120120230940','stopdate'=>'230120231400');
        $sonuc=$islem->gelensms($data);
        dd($sonuc);
      

Başarılı istek örnek sonuç

Array
(
    [0] => Array
        (
            [telno] => 553xxxxxxx 
            [mesaj] =>  mesaj_içerigi
            [tarih] =>  12.01.2023 09:43:51
        )

    [1] => Array
        (
            [telno] => 553xxxxxxx 
            [mesaj] =>  mesaj_içerigi
            [tarih] =>  12.01.2023 09:43:04
        )

)

Başarısız istek örnek sonuç

Array
(
    [code] => 60
    [aciklama] => Arama kiterlerindeki startdate ve stopdate zaman farkının 30 günden fazla olduğunu ifade eder.
)

BAŞLIK(GÖNDERİCİ ADI) SORGULAMA

Hesabınızda tanımlı gönderici adlarını(mesaj başlığı) sorgulama modülüdür.

        use Netgsm\Sms\SmsSend;
        $baslik=new SmsSend;
        $sonuc=$baslik->basliksorgu();
        dd($sonuc);
        

Başarılı istek örnek sonuç

Array
(
    [msgheader] => Array
        (
            [0] => 850xxxxxxx
            [1] => HEADER_BILGISI
        )

)

Başarısız istek örnek sonuç

Array
(
    [code] => 30
    [error] => Kullanici bilgisi bulunamadi
)

Kara Liste

Blacklist olarak da bilinen SMS gönderimi istenmeyen yasaklı numaralar listeniz için, belirlediğiniz numaraları Kara Listeye Ekleme / Kara Listeden Çıkarma modülünü kullanabilirsiniz. Kara Listede bulunan numaralara hesabınızdan SMS gönderilmez.Bu kontrol Netgsm tarafında sağlanır.

Parametre	Anlamı
type	1 değeri ile Kara listeye ekleme, 2 değeri ile Kara listeden çıkarma işlemi gerçekleşir. İstek yapılırken gönderilmesi zorunludur.

        use Netgsm\Sms\SmsSend;
       	$karaliste=new SmsSend;
        $data=array('number'=>['553xxxxxxx','553xxxxxxx'],'tip'=>2);
        $sonuc=$karaliste->karaliste($data);
        dd($sonuc);
       

Başarılı istek örnek sonuç

Array
(
    [code] => OK
    [aciklama] => Kara Listeye Ekleme / Çıkarma işleminde bir hata olmadığını gösterir.
)

Başarısız istek örnek sonuç

Array
(
    [code] => 60
    [aciklama] => Geçersiz tip gönderimi
)

FLASH SMS

Gönderdiğiniz SMS'lerin kullanıcılarınızın cep telefonu ekranında bildirim olarak gösterilmesidir.
Abone numaranızın kurumsal olması gereklidir.

Parametre	Anlamı
header	Sistemde tanımlı olan mesaj başlığınızdır (gönderici adınız). En az 3, en fazla 11 karakterden oluşur.
message	SMS metninin yer alacağı alandır.Nn sms gönderimlerinde array olarak gönderilmelidir.
gsm[ ]	SMS in gideceği numaraları temsil eder array gönderilmeli
filter/code>	Ticari içerikli SMS gönderimlerinde bu parametreyi kullanabilirsiniz. Ticari içerikli bireysele gönderilecek numaralar için İYS kontrollü gönderimlerde ise "11" değerini, tacire gönderilecek İYS kontrollü gönderimlerde ise "12" değerini almalıdır. null gönderildiği taktirde filtre uygulanmadan gönderilecektir.İstek yapılırken gönderilmesi zorunludur. Ticari içerikli ileti gönderimi yapmıyorsanız 0 gönderilmelidir.
appkey/code>	Geliştirici hesabınızdan yayınlanan uygulamanıza ait id bilgisi.
encoding	Türkçe karakter desteği isteniyorsa bu alana TR girilmeli, istenmiyorsa null olarak gönderilmelidir. SMS boyu hesabı ve ücretlendirme bu parametreye bağlı olarak değişecektir.
startdate	Gönderime başlayacağınız tarih. (ddMMyyyyHHmm) * Boş bırakılırsa mesajınız hemen gider.
stopdate	İki tarih arası gönderimlerinizde bitiş tarihi.(ddMMyyyyHHmm)* Boş bırakılırsa sistem başlangıç tarihine 21 saat ekleyerek otomatik gönderir.

        use Netgsm\Sms\SmsSend;
       	$data=array('message'=>'Test','gsm'=>['553xxxxxxx','553xxxxxxx'],
                    'header'=>'312xxxxxxx',
                    'encoding'=>'tr',
                    'startdate'=>'170220231418',
                    'stopdate'=>'170220231425',
                    'filter'=>0,
                    'bayikodu'=>132,
                    'appkey'=>'hsfxa-xhytf21-....',
        );
        $islem=new SmsSend;
        $sonuc=$islem->flashSms($data);
        dd($sonuc);
      

Başarılı istek örnek sonuç

Array
(
    [aciklama] => Gönderdiğiniz SMS'inizin başarıyla sistemimize ulaştığını gösterir. 00 : Mesajınızın tarih formatına ilişkin bir hata olmadığı anlamına gelir. 123xxxxxx : Gönderilen SMSe ait ID bilgisi, Bu görevid (bulkid) niz ile mesajınızın iletim raporunu sorguyabilirsiniz.
    [code] => 00
    [bulkid] => 1311191776
)

Başarısız istek örnek sonuç

Array
(
    [code] => 30
    [aciklama] => Geçersiz kullanıcı adı , şifre veya kullanıcınızın API erişim izninin olmadığını gösterir.Ayrıca eğer API erişiminizde IP sınırlaması yaptıysanız ve sınırladığınız ip dışında gönderim sağlıyorsanız 30 hata kodunu alırsınız. API erişim izninizi veya IP sınırlamanızı , web arayüzden; sağ üst köşede bulunan ayarlar> API işlemleri menüsunden kontrol edebilirsiniz.
)

=======

Laravel & Symfony Netgsm Sms Entegrasyonu

Netgsm Sms paket aboneliği bulunan kullanıcılarımız için composer paketidir.

İçindekiler

• Kurulum
• İletişim & Destek
• Supported
• Doküman
  • Kurulum
  • 1:n Sms Gönderimi
  • n:n Sms Gönderimi
  • Tekli Sms Gönderimi
  • Sms Sorgulama
  • Sms İptali
  • Gelen Sms Sorgulama
  • Gelen Sms Webhook
  • Başlık(Gönderi̇ci̇ Adi) Sorgulama
  • Kara Liste
  • Flash Sms

Destek

Netgsm API Servisi ile alakalı tüm sorularınızı ve önerilerinizi [e-mail] adresine iletebilirsiniz.

Supported Laravel Versions

Laravel 6.x, Laravel 7.x, Laravel 8.x, Laravel 9.x, Laravel 10.x

Supported Lumen Versions

Lumen 6.x, Lumen 7.x, Lumen 8.x, Lumen 9.x,

Supported Symfony Versions

Symfony 4.x, Symfony 5.x, Symfony 6.x

Supported Php Versions

PHP 7.2.5 ve üzeri

Doküman

https://www.netgsm.com.tr/dokuman/ API Servisi için hazırlanmış kapsamlı dokümana ve farklı yazılım dillerinde örnek amaçlı hazırlanmış örnek kodlamalara https://www.netgsm.com.tr/dokuman adresinden ulaşabilirsiniz.

Kurulum

composer require netgsm/sms

.env dosyası içerisinde NETGSM ABONELİK bilgileriniz tanımlanması zorunludur.

NETGSM_USERCODE=""
NETGSM_PASSWORD=""
NETGSM_HEADER=""

PARAMETRELER

Parametre	Anlamı
encoding	Türkçe karakter desteği isteniyorsa bu alana TR girilmeli, istenmiyorsa null olarak gönderilmelidir. SMS boyu hesabı ve ücretlendirme bu parametreye bağlı olarak değişecektir.
startdate	Gönderime başlayacağınız tarih. (ddMMyyyyHHmm) * Boş bırakılırsa mesajınız hemen gider.
stopdate	İki tarih arası gönderimlerinizde bitiş tarihi.(ddMMyyyyHHmm)* Boş bırakılırsa sistem başlangıç tarihine 21 saat ekleyerek otomatik gönderir.
bayikodu	Bayi üyesi iseniz bayinize ait kod
filter	Ticari içerikli SMS gönderimlerinde bu parametreyi kullanabilirsiniz. Ticari içerikli bireysele gönderilecek numaralar için İYS kontrollü gönderimlerde ise "11" değerini, tacire gönderilecek İYS kontrollü gönderimlerde ise "12" değerini almalıdır. null gönderildiği taktirde filtre uygulanmadan gönderilecektir.İstek yapılırken gönderilmesi zorunludur. Ticari içerikli ileti gönderimi yapmıyorsanız 0 gönderilmelidir.
appkey	Geliştirici hesabınızdan yayınlanan uygulamanıza ait id bilgisi.
bulkid	başarılı mesaj gönderimlerinizde dönen görevid (bulkid) nizdir.

1:n Sms Gönderimi

SMS'lerinizi 1:n yöntemiyle birden fazla numaraya aynı anda tek gönderimde iletebilirsiniz.

        use Netgsm\Sms\SmsSend;
        $data=array(
            'message'=>'test mesajı',
            'no'=>['553xxxxxxx','553xxxxxxx'],
            'header'=>'MESAJ_BASLİK',
            'filter'=>0,
            'encoding'=>'tr',
            'startdate'=>'170220231000',
            'stopdate'=>'170220231200',
            'bayikodu'=>'1312...',
            'appkey'=>'A123-F3DASD-XXXXX....'
        );
        $sms= new SmsSend;
        $cevap=$sms->smsGonder($data);
        dd($cevap);
        

Başarılı istek örnek

Array
(
    [code] => 00
    [bulkid] => 1311033503
    [durum] => Gönderdiğiniz SMS'inizin başarıyla sistemimize ulaştığını gösterir. 00 : Mesajınızın tarih formatına ilişkin bir hata olmadığı anlamına gelir. 123xxxxxx : Gönderilen SMSe ait ID bilgisi, Bu görevid (bulkid) niz ile mesajınızın iletim raporunu sorguyabilirsiniz.
)

Başarısız istek örnek

Array
(
    [code] => 30
    [durum] => Geçersiz kullanıcı adı , şifre veya kullanıcınızın API erişim izninin olmadığını gösterir.Ayrıca eğer API erişiminizde IP sınırlaması yaptıysanız ve sınırladığınız ip dışında gönderim sağlıyorsanız 30 hata kodunu alırsınız. API erişim izninizi veya IP sınırlamanızı , web arayüzden; sağ üst köşede bulunan ayarlar> API işlemleri menüsunden kontrol edebilirsiniz.
)

n:n Sms Gönderimi

Birden fazla farklı SMS içeriğini farklı numaralara aynı anda tek pakette gönderebilirsiniz.

        use Netgsm\Sms\SmsSend;
        $msGsm=array(
                    array('gsm'=>'553XXXXXX','message'=>'MESAJ METNİ 1'),
                    array('gsm'=>'553XXXXXX','message'=>'MESAJ METNİ 2')
                );
        $data=array('startdate'=>'170220231210','stopdate'=>'170220231300','header'=>'BASLIGINIZ','filter'=>0);
        $sms=new SmsSend;
        $cevap=$sms->smsGonderNN($msGsm,$data);
        dd($cevap);
       

Başarılı istek örnek

Array
(
    [code] => 00
    [bulkid] => 1311033503
    [durum] => Gönderdiğiniz SMS'inizin başarıyla sistemimize ulaştığını gösterir. 00 : Mesajınızın tarih formatına ilişkin bir hata olmadığı anlamına gelir. 123xxxxxx : Gönderilen SMSe ait ID bilgisi, Bu görevid (bulkid) niz ile mesajınızın iletim raporunu sorguyabilirsiniz.
)

Başarısız istek örnek

Array
(
    [code] => 30
    [durum] => Geçersiz kullanıcı adı , şifre veya kullanıcınızın API erişim izninin olmadığını gösterir.Ayrıca eğer API erişiminizde IP sınırlaması yaptıysanız ve sınırladığınız ip dışında gönderim sağlıyorsanız 30 hata kodunu alırsınız. API erişim izninizi veya IP sınırlamanızı , web arayüzden; sağ üst köşede bulunan ayarlar> API işlemleri menüsunden kontrol edebilirsiniz.
)

TEKLİ SMS GÖNDERİMİ

        use Netgsm\Sms\SmsSend;
        $sms=new SmsSend;
        $data=array(
            'msgheader'=>"",
            'gsm'=>'553XXXXXXX',
            'message'=>'Merhaba',
            'filter'=>'0',
            'startdate'=>'270120230950',
            'stopdate'=>'270120231030',
        );

        $sonuc=$sms->smsgonder1_1($data);
        dd($sonuc);
       

Başarılı istek örnek

Array
(
    [code] => 00
    [aciklama] => Görevinizin tarih formatinda bir hata olmadığını gösterir.
    [bulkid] => 1311044635
)

Başarısız istek örnek

Array
(
    [code] => 40
    [aciklama] => Mesaj başlığınızın (gönderici adınızın) sistemde tanımlı olmadığını ifade eder. Gönderici adlarınızı API ile sorgulayarak kontrol edebilirsiniz.
)

SMS SORGULAMA

Gönderilen mesajların son 3 aya kadar raporlarını sorguyarak; iletim durumlarını öğrenebilirsiniz.

Parametre	Anlamı
bulkid	başarılı mesaj gönderimlerinizde dönen görevid (bulkid) nizdir.
type=0	Tek BulkID sorgular.
type=2	İki tarih arasında sorgulama yapar.
bastar	İki tarih arası sorgulamalarınızda başlangıç tarihidir(ddmmyyyy)
bittar	İki tarih arası sorgulamalarınızda bitiş tarihidir(ddmmyyyy) Bütün numaralar birbirlerinden <BR> kodu ile ayrılmiştir.

status

Kod	Anlamı
0	İletilmeyi bekleyenler
1	İletilmiş olanlar
2	Zaman aşımına uğramış olanlar
3	Hatalı veya kısıtlı numara
4	Operatöre gönderilemedi
11	Operatör tarafından kabul edilmemiş olanlar
12	Gönderim hatası olanlar
13	Mükerrer olanlar
100	Tüm mesaj durumları
103	Başarısız Görev (Bu görevin tamamı başarısız olmuştur.)

        use Netgsm\Sms\SmsSend;
        $sms=new SmsSend;
        $data=array('bulkid'=>'1311042194','bastar'=>'010220231500','bittar'=>'070220231500','status'=>'100','type'=>2);
        //bulkid girildiğinde type 0 gönderilmelidir.type=0 girildiğinde bastar ve bittar girilmesine gerek bulunmamaktadır.
        //bastar ve bittar girildiğinde type 2 gönderilmelidir.
        $sonuc=$sms->smsSorgulama($data);
        dd($sonuc);
        

Başarılı istek sonuç

Array
(
    [durum] => İletilmiş olanlar
    [durumcode] => 1
    [operator] => Türk Telekom
    [operatorcode] => 20
    [hataaciklama] => Hata Yok.
    [hatakod] => 0
    [cepno] => 9055xxxxxxx
    [mesajboy] => 1
    [tarih] => 23.01.2023 09:35:00
)

Başarısız istek sonuç

Array
(
    [code] => 60
    [aciklama] => Arama kriterlerinize göre listelenecek kayıt olmadığını ifade eder.
)

SMS İPTALİ

İleri tarihe zamanlanmış SMS'lerinizi iptal edebilirsiniz ya da görev zamanını değiştirebilirsiniz.

Parametre	Anlamı
type=0	gönderilirse görev iptal edilir.
type=1	gönderilip startdate stopdate girilirse güncelleme işlemi yapılır

        $sms=new SmsSend;
        $data=array('bulkid'=>'1311176624','startdate'=>'180220230100','stopdate'=>'180220231000','type'=>1);
        //type=0 gönderilirse  startdate ve stopdate gönderilmesine gerek yoktur.
        //type=1 gönderilirse stardate ve stopdate değerleri güncellenebilir.
        $sonuc=$sms->smsiptal($data);
        dd($sonuc);
        

Başarılı istek sonuç

Array
(
    [aciklama] => İleri zamanlı görevinizin başarılı bir şekilde iptal edilğini ifade eder.
    [code] => 00
)

Başarısız istek sonuç

Array
(
    [aciklama] => Baslangiç ve bitis tarihleri arasindaki fark en az 1 , en fazla 21 saat olmalidir.
    [code] => 60
)

GELEN SMS SORGULAMA

Abone numaranıza gelen SMS'leri sorgulayabilirsiniz.

        use Netgsm\Sms\SmsSend;	
        $islem=new SmsSend;
        $data=array('startdate'=>'120120230940','stopdate'=>'230120231400');
        $sonuc=$islem->gelensms($data);
        dd($sonuc);
        

Başarılı istek örnek sonuç

Array
(
    [0] => Array
        (
            [telno] => 553xxxxxxx 
            [mesaj] =>  mesaj_içerigi
            [tarih] =>  12.01.2023 09:43:51
        )

    [1] => Array
        (
            [telno] => 553xxxxxxx 
            [mesaj] =>  mesaj_içerigi
            [tarih] =>  12.01.2023 09:43:04
        )

)

Başarısız istek örnek sonuç

Array
(
    [code] => 60
    [aciklama] => Arama kiterlerindeki startdate ve stopdate zaman farkının 30 günden fazla olduğunu ifade eder.
)

GELEN SMS WEBHOOK

• Abone numaranıza gelen SMS'leri tarafınızda belirleyeceğiniz bir URL adresine anlık olarak post ediyoruz.
• Bu işlemi webportaldan SMS Hizmeti / İnteraktif SMS menüsündeki URL Adresine Yönlendir Modülüe tıklayarak gerçekleştirebilirsiniz.
• Belirttiğiniz URL adresine yönlendirilecek veri post ile gönderilir.
• Gönderilen post değerleri ceptel ve mesaj dır.

Belirtmiş olduğunuz URL adresine aşağıdaki gibi veri gelir.

{
    "mesaj": "test",
    "ceptel": "553xxxxxxx",
    "aboneno": "312xxxxxxx",
    "gorevid": "112xxx720",
    "tarih": "2023-02-21 16:28:41.053"
}

Laravel kullanıyorsanız veriyi aşağıdaki gibi çekebilirsiniz

    public function index(Request $request)
    {
        //
        $request->ceptel;
        $request->mesaj;
        $request->aboneno;
        $request->gorevid;
        $request->tarih;
    }

Symfony kullanıyorsanız veriyi aşağıdaki gibi çekebilirsiniz

    use Symfony\Component\HttpFoundation\Request;
    public function index(Request $request)
    {
    
        
        $request->get('ceptel');
        $request->get('mesaj');
        $request->get('aboneno');
        $request->get('gorevid');
        $request->get('tarih');
        
     }

BAŞLIK(GÖNDERİCİ ADI) SORGULAMA

Hesabınızda tanımlı gönderici adlarını(mesaj başlığı) sorgulama modülüdür.

        use Netgsm\Sms\SmsSend;
        $baslik=new SmsSend;
        $sonuc=$baslik->basliksorgu();
        dd($sonuc);
       

Başarılı istek örnek sonuç

Array
(
    [msgheader] => Array
        (
            [0] => 850xxxxxxx
            [1] => HEADER_BILGISI
        )

)

Başarısız istek örnek sonuç

Array
(
    [code] => 30
    [error] => Kullanici bilgisi bulunamadi
)

Kara Liste

Blacklist olarak da bilinen SMS gönderimi istenmeyen yasaklı numaralar listeniz için, belirlediğiniz numaraları Kara Listeye Ekleme / Kara Listeden Çıkarma modülünü kullanabilirsiniz. Kara Listede bulunan numaralara hesabınızdan SMS gönderilmez.Bu kontrol Netgsm tarafında sağlanır.

Parametre	Anlamı
tip	1 değeri ile Kara listeye ekleme, 2 değeri ile Kara listeden çıkarma işlemi gerçekleşir. İstek yapılırken gönderilmesi zorunludur.

        use Netgsm\Sms\SmsSend;
       	$karaliste=new SmsSend;
        $data=array('number'=>['553xxxxxxx','553xxxxxxx'],'tip'=>2);
        $sonuc=$karaliste->karaliste($data);
        dd($sonuc);

Başarılı istek örnek sonuç

Array
(
    [code] => OK
    [aciklama] => Kara Listeye Ekleme / Çıkarma işleminde bir hata olmadığını gösterir.
)

Başarısız istek örnek sonuç

Array
(
    [code] => 60
    [aciklama] => Geçersiz tip gönderimi
)

FLASH SMS

Gönderdiğiniz SMS'lerin kullanıcılarınızın cep telefonu ekranında bildirim olarak gösterilmesidir.
Abone numaranızın kurumsal olması gereklidir.

Parametre	Anlamı
header	Sistemde tanımlı olan mesaj başlığınızdır (gönderici adınız). En az 3, en fazla 11 karakterden oluşur.
message	SMS metninin yer alacağı alandır.Nn sms gönderimlerinde array olarak gönderilmelidir.
gsm[ ]	SMS in gideceği numaraları temsil eder array gönderilmeli
filter/code>	Ticari içerikli SMS gönderimlerinde bu parametreyi kullanabilirsiniz. Ticari içerikli bireysele gönderilecek numaralar için İYS kontrollü gönderimlerde ise "11" değerini, tacire gönderilecek İYS kontrollü gönderimlerde ise "12" değerini almalıdır. null gönderildiği taktirde filtre uygulanmadan gönderilecektir.İstek yapılırken gönderilmesi zorunludur. Ticari içerikli ileti gönderimi yapmıyorsanız 0 gönderilmelidir.
appkey/code>	Geliştirici hesabınızdan yayınlanan uygulamanıza ait id bilgisi.
encoding	Türkçe karakter desteği isteniyorsa bu alana TR girilmeli, istenmiyorsa null olarak gönderilmelidir. SMS boyu hesabı ve ücretlendirme bu parametreye bağlı olarak değişecektir.
startdate	Gönderime başlayacağınız tarih. (ddMMyyyyHHmm) * Boş bırakılırsa mesajınız hemen gider.
stopdate	İki tarih arası gönderimlerinizde bitiş tarihi.(ddMMyyyyHHmm)* Boş bırakılırsa sistem başlangıç tarihine 21 saat ekleyerek otomatik gönderir.

        use Netgsm\Sms\SmsSend;
       	$data=array('message'=>'Test','gsm'=>['553xxxxxxx','553xxxxxxx'],
                    'header'=>'312xxxxxxx',
                    'encoding'=>'tr',
                    'startdate'=>'170220231418',
                    'stopdate'=>'170220231425',
                    'filter'=>0,
                    'bayikodu'=>132,
                    'appkey'=>'hsfxa-xhytf21-....',
        );
        $islem=new SmsSend;
        $sonuc=$islem->flashSms($data);
        dd($sonuc);
        

Başarılı istek örnek sonuç

Array
(
    [aciklama] => Gönderdiğiniz SMS'inizin başarıyla sistemimize ulaştığını gösterir. 00 : Mesajınızın tarih formatına ilişkin bir hata olmadığı anlamına gelir. 123xxxxxx : Gönderilen SMSe ait ID bilgisi, Bu görevid (bulkid) niz ile mesajınızın iletim raporunu sorguyabilirsiniz.
    [code] => 00
    [bulkid] => 1311191776
)

Başarısız istek örnek sonuç

Array
(
    [code] => 30
    [aciklama] => Geçersiz kullanıcı adı , şifre veya kullanıcınızın API erişim izninin olmadığını gösterir.Ayrıca eğer API erişiminizde IP sınırlaması yaptıysanız ve sınırladığınız ip dışında gönderim sağlıyorsanız 30 hata kodunu alırsınız. API erişim izninizi veya IP sınırlamanızı , web arayüzden; sağ üst köşede bulunan ayarlar> API işlemleri menüsunden kontrol edebilirsiniz.
)

606d569e1950e7b988a2073eaae9e031c79d926a