afatmustafa/mutlucell

Mutlucell SMS API wrapper for sending sms text messages for Laravel 10, 9, 8, 7, 6, 5 and 4.

1.0.0 2023-03-06 21:32 UTC

Requires

• php: ^7.3|^8.0
• ext-simplexml: *
• guzzlehttp/guzzle: ^6.5.6|^7.4.5
• illuminate/support: 10.*

MIT

• Arda Kilicdagi

• api
• sms
• laravel
• mutlucell

README

Bu paket sayesinde Laravel 9.x, 8.x, 7.x, 6.x, 5.x veya 4.x kullanan projelerinizde Mutlucell altyapısını kullanarak tekli veya çoklu sms gönderebilir, bakiye ve originator ID sorgulayabilirsiniz.

Bu branch Laravel 9 içindir. Eğer bu paketi Laravel 8.x üzerinde kullanmak istiyorsanız 5.x sürümünü "ardakilic/mutlucell": "~5", 7.x üzerinde kullanmak istiyorsanız 4.x sürümünü "ardakilic/mutlucell": "~4", 6.x üzerinde kullanmak istiyorsanız 3.x sürümünü "ardakilic/mutlucell": "~3" etiketi ile, Laravel 5.x üzerinde kullanmak istiyorsanız 2.x sürümünü "ardakilic/mutlucell": "~2" etiketi ile, Laravel 4 üzerinde kullanmak istiyorsanız 1.x sürümünü, "ardakilic/mutlucell": "~1" etiketi ile kullanmalısınız.

Uyarı, hata ve bilgilendirme için Türkçe ve de İngilizce dillerinde uyarı ve bilgi mesajlarını barındırır.

Ekstra Bağımlılıklar (Laravel 6.x sürümü ve üstü için)

• SimpleXML PHP Eklentisi

Kurulum (Laravel 9.x için)

• Öncelikle composer.json dosyanızdaki require kısmına aşağıdaki değeri ekleyin:

  "ardakilic/mutlucell": "~6"

  Alternatif olarak composer require ardakilic/mutlucell:~6 komutu ile de paketi ekleyebilirsiniz.

• Ardından eğer composer.json dosyasını elinizle güncellediyseniz kodları projenize dahil etmek için Composer paketlerinizi güncellemelisiniz. composer update komutu ile bunu yapabilirsiniz.

• Şimdi de config/app.php dosyasını açın, providers dizisi içine en alta şunu girin:

  Ardakilic\Mutlucell\MutlucellServiceProvider::class,

  (Laravel 5.5 ve sonrası için gerekli değildir)

• Şimdi yine aynı dosyada aliases dizisi altına şu değeri girin:

  'Mutlucell' => Ardakilic\Mutlucell\Facades\Mutlucell::class,

  (Laravel 5.5 ve sonrası için gerekli değildir)

• Şimdi de environment'ınıza konfigürasyon dosyasını paylaşmalısınız. Bunun için aşağıdaki komutu çalıştırın:

  php artisan vendor:publish

• config/mutlucell.php dosyası paylaşılacak. Burada Mutlucell için size atanan kullanıcı adı, parola ve sender_id (originator) değerlerini, ve de diğer ayarları doldurmalısınız.

Ayrıca environment dosyanıza MUTLUCELL_USERNAME, MUTLUCELL_PASSWORD ve MUTLUCELL_DEFAULT_SENDER değerlerini de doldurarak config dosyanızı besleyebilirsiniz.

Laravel 8.x sürümünde kullanım bilgisi için ilgili branch'ın README.md dosyasına bakmalısınız.

Laravel 7.x sürümünde kullanım bilgisi için ilgili branch'ın README.md dosyasına bakmalısınız.

Laravel 6.x sürümünde kullanım bilgisi için ilgili branch'ın README.md dosyasına bakmalısınız.

Laravel 5.x sürümünde kullanım bilgisi için ilgili branch'ın README.md dosyasına bakmalısınız.

Laravel 4.x sürümünde kullanım bilgisi için ilgili branch'ın README.md dosyasına bakmalısınız.

Kullanım

Birine o anda tekil SMS göndermek için:

$send = Mutlucell::send('05312345678', 'Merhaba');
var_dump(Mutlucell::parseOutput($send));

SMS gönderildi mi ?

$send = Mutlucell::send('05312345678', 'Merhaba');
if(Mutlucell::getStatus($send)) {
    echo 'SMS başarı ile gönderildi!';
} else {
    echo 'SMS gönderilemedi';
}

Mutlucell SMS ID

Gönderilen mesajın durumunu (karşı tarafa ulaşıp ulaşmadığı) takip edebilmeniz için SMS ID değerine ihtiyacınız var.

Aşağıdaki şekilde, SMS ID edinip, daha sonra bununla sorgulama yapabilirsiniz.

$send = Mutlucell::send('05312345678', 'Merhaba');
if(Mutlucell::getStatus($send)) {
    $messageId = Mutlucell::getMessageId($send);
    echo 'SMS başarı ile gönderildi! SMS ID: '. $messageId;
} else {
    echo 'SMS gönderilemedi';
}

Birden fazla kişiye aynı anda aynı SMS'i göndermek için:

$kisiler = ['00905312345678', '[phone]', '05369998874', '5315558896'];
$send = Mutlucell::sendBulk($kisiler, 'Merhaba');
var_dump(Mutlucell::parseOutput($send));

Veya

$send = Mutlucell::sendBulk('00905312345678, [phone], 05369998874, 5315558896', 'Merhaba');
Mutlucell::parseOutput($send);

Birden fazla kişiye aynı anda farklı SMS'ler göndermek için:

$kisiMesajlar = [
    ['05315558964', 'Merhaba1'],
    ['[phone]', 'Merhaba2'],
    ['00905369998874', 'Merhaba3']
];
$send = Mutlucell::sendMulti($kisiMesajlar);
var_dump(Mutlucell::parseOutput($send));

Veya

$kisiMesajlar = [
    ['05315558964' => 'Merhaba1'],
    ['[phone]' => 'Merhaba2'],
    ['00905369998874' => 'Merhaba3']
];
$send = Mutlucell::sendMulti2($kisiMesajlar);
var_dump(Mutlucell::parseOutput($send));

Gönderilen mesajın durumunu sorgulamak için:

>>> \Mutlucell::getMessageReport('1234567890');
=> [
     [
       "number" => "905321234567",
       "result" => "3",
       "result_text" => "Başarılı",
     ],
   ]

Bir veya birden Fazla Kullanıcıyı Kara Listeye Eklemek İçin

$sil = Mutlucell::addBlacklist('00905312345678');
var_dump(Mutlucell::parseOutput($sil));

Veya

$sil = Mutlucell::addBlacklist('00905312345678, [phone], 05369998874, 5315558896');
var_dump(Mutlucell::parseOutput($sil));

Veya

$kisiler = ['00905312345678', '[phone]', '05369998874', '5315558896'];
$sil = Mutlucell::addBlacklist($kisiler);
var_dump(Mutlucell::parseOutput($sil));

Bir veya Birden Fazla Kullanıcıyı Kara Listeden Çıkartmak İçin

$sil = Mutlucell::deleteBlackList('00905312345678');
var_dump(Mutlucell::parseOutput($sil));

Veya

$sil = Mutlucell::deleteBlackList('00905312345678, [phone], 05369998874, 5315558896');
var_dump(Mutlucell::parseOutput($sil));

Veya

$kisiler = ['00905312345678', '[phone]', '05369998874', '5315558896'];
$sil = Mutlucell::deleteBlackList($kisiler);
var_dump(Mutlucell::parseOutput($sil));

Eğer tüm kullanıcıları kara listeden çıkartmak istiyorsanız parametre boş olmalı:

$sil = Mutlucell::deleteBlackList();
var_dump(Mutlucell::parseOutput($sil));

Farklı bir ayar dosyası ile SMS göndermek için

$gonder = Mutlucell::setConfig(config('app.baskaConfig'))->send('05312345678', 'Merhaba');

Hatta

$sms = Mutlucell::setConfig([
    'auth' => [
        'username' => 'baskauser',
        'password' => 'baskaparola',
    ],
    'default_sender' => 'baskaoriginator',
]);

$sms->send('05312345678', 'Merhaba');

Kalan Kontör Sorgulaması için:

var_dump(Mutlucell::checkBalance());

Originatörleri listelemek için:

var_dump(Mutlucell::listOriginators());

Gelecek bir tarihe SMS yollamak için:

Mutlucell::send('05312223665', 'Geç gidecek mesaj', '2099-06-30 15:00'); //saniye yok, dikkat!

Farklı bir Originatör (Sender ID) kullanarak SMS yollamak için:

Mutlucell::send('05312223665', 'merhaba', '', 'diğerOriginator');

Yapılacaklar

• Kara Listeye giren kullanıcı listesini alma metodu
• ?

Lisans

Bu yazılım paketi MIT lisansı ile lisanslanmıştır.

Destek

Bu proje eğer işinize yaradıysa kripto paralarla bana bağışta bulunabilirsiniz. Aşağıda cüzdan adreslerimi bulabilirsiniz:

BTC: 1QFHeSrhWWVhmneDBkArKvpmPohRjpf7p6

ETH / ERC20 Token'ları: 0x3C2b0AC49257300DaB96dF8b49d254Bb696B3458

NEO / Nep5 Token'ları: AYbHEah5Y4J6BV8Y9wkWJY7cCyHQameaHc