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 teknikdestek@netgsm.com.tr 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.

Destek

Netgsm API Servisi ile alakalı tüm sorularınızı ve önerilerinizi teknikdestek@netgsm.com.tr 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

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

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

netgsm / sms

Maintainers

Details

README

İletişim & Destek

Supported Laravel Versions

Supported Lumen Versions

Supported Symfony Versions

Supported Php Versions

Doküman

Kurulum

PARAMETRELER

1:n SMS GÖNDERİMİ

Başarılı istek örnek

Başarısız istek örnek

n:n SMS GÖNDERİMİ

Başarılı istek örnek

Başarısız istek örnek

TEKLİ SMS GÖNDERİMİ

Başarılı istek örnek

Başarısız istek örnek

SMS SORGULAMA

Başarılı istek sonuç

Başarısız istek sonuç

SMS İPTALİ

Başarılı istek sonuç

Başarısız istek sonuç

GELEN SMS SORGULAMA

Başarılı istek örnek sonuç

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

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

Başarılı istek örnek sonuç

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

Kara Liste

Başarılı istek örnek sonuç

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

FLASH SMS

Başarılı istek örnek sonuç

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

Laravel & Symfony Netgsm Sms Entegrasyonu

İçindekiler

Destek

Supported Laravel Versions

Supported Lumen Versions

Supported Symfony Versions

Supported Php Versions

Doküman

Kurulum

PARAMETRELER

1:n Sms Gönderimi

Başarılı istek örnek

Başarısız istek örnek

n:n Sms Gönderimi

Başarılı istek örnek

Başarısız istek örnek

TEKLİ SMS GÖNDERİMİ

Başarılı istek örnek

Başarısız istek örnek

SMS SORGULAMA

Başarılı istek sonuç

Başarısız istek sonuç

SMS İPTALİ

Başarılı istek sonuç

Başarısız istek sonuç

GELEN SMS SORGULAMA

Başarılı istek örnek sonuç

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

GELEN SMS WEBHOOK

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

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

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

Başarılı istek örnek sonuç

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

Kara Liste

Başarılı istek örnek sonuç

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

FLASH SMS

Başarılı istek örnek sonuç

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