ardakilic/mutlucell

Mutlucell SMS API wrapper for sending sms text messages for Laravel

8.0.0 2024-03-12 19:01 UTC

Requires

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

MIT

• Arda Kilicdagi

• api
• sms
• laravel
• mutlucell

README

Bu paket sayesinde Laravel kullanan projelerinizde Mutlucell altyapısını kullanarak tekli veya çoklu sms gönderebilir, bakiye ve originator ID sorgulayabilirsiniz.

Paket Laravel 4 ve üzerindeki tüm sürümleri destekler.

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

• Öncelikle composer.json paketinize composer require ardakilic/mutlucell komutu ile de paketi ekleyin.

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

• (Sadece Laravel 5.5'ten daha eski sürümler için) Şimdi de config/app.php dosyasını açın, providers dizisi içine en alta şunu girin:

  Ardakilic\Mutlucell\MutlucellServiceProvider::class,

• (Sadece Laravel 5.5'ten daha eski sürümler için) Yine aynı dosyadaki aliases dizisi altına şu değeri girin:

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

• Ş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.

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