Sender-Dienst

use BulkGate\Sms\Sender;

Um eine Nachricht vom Typ BulkGate\Sms\IMessage zu senden

müssen Sie einen Sender erstellen. Dafür gibt es zwei Möglichkeiten:

Nette Framework – wenn Sie das Nette Framework verwenden
PHP – in allen anderen Fällen

/** @var BulkGate\Message\Connection $connection */ $sender = new BulkGate\Sms\Sender($connection);

Nachrichten senden

Zum Senden der Nachricht verwenden Sie die Methode send(), die Nachrichten vom Typ BulkGate\Sms\IMessage entgegennimmt.

/** * @var BulkGate\Sms\Sender $sender * @var BulkGate\Sms\IMessage|BulkGate\Sms\Message|BulkGate\Sms\BulkMessage $message */ $response = $sender->send($message);

Antwort auf `BulkGate\Sms\Message`

BulkGate\Message\Response Object ( [data:BulkGate\Message\Response:private] => Array ( [sms_id] => tmpde8f0dca011 [price] => 0.033 [credit] => 215.8138 [number] => 420777777777 ) )

Antwort auf `BulkGate\Sms\BulkMessage`

BulkGate\Message\Response Object ( [data:BulkGate\Message\Response:private] => Array ( [total] => Array ( [price] => 0.033 [status] => Array ( [sent] => 0 [accepted] => 1 [scheduled] => 0 [error] => 0 ) ) [response] => Array ( [0] => Array ( [status] => accepted [sms_id] => tmpde8f0b47b12 [price] => 0.033 [credit] => 215.8138 [number] => 420777777777 ) ) ) )

Unicode

Um Unicode einzustellen, rufen Sie die Methode unicode() auf.

/** @var BulkGate\Sms\Sender $sender */ $sender->unicode(); // Einschalten $sender->unicode(true); // Einschalten $sender->unicode(false); // Ausschalten

Einstellung des Absenders

Die Einstellung des Absendertyps ist in einem eigenen Kapitel beschrieben.

/** * @var BulkGate\Sms\Sender $sender * @var SenderSettings\CountrySenderSettings|SenderSettings\StaticSenderSettings $settings */ $sender->setSenderSettings($settings);

Standardland

Wenn Sie Telefonnummern im nationalen Format angeben, weiß das System nicht, wohin die Nachrichten gesendet werden sollen. Ist die internationale Vorwahl also nicht ausdrücklich angegeben, können Sie für den Sender ein Standardland festlegen, in das die Nachrichten geleitet werden.

/** @var BulkGate\Sms\Sender $sender */ $sender->setDefaultCountry(BulkGate\Sms\Country::CZECH_REPUBLIC); // über BulkGate\Sms\Country $sender->setDefaultCountry('cz'); // ISO 3166-1 alpha-2

Überprüfung von Nummern

Wenn Sie prüfen müssen, ob eine Telefonnummer dem Format des Landes entspricht, verwenden Sie die Methode checkPhoneNumbers().

/** @var BulkGate\Sms\Sender $sender */ $sender->checkPhoneNumbers($numbers, $iso);

Dabei kann $numbers Folgendes sein:

eine Telefonnummer als Zeichenkette "420777777777"
eine Telefonnummer vom Typ BulkGate\Sms\Message\PhoneNumber
ein Array von Telefonnummern ['420777777777','420777777778','420777777779']
ein Array von Telefonnummern vom Typ BulkGate\Sms\Message\PhoneNumber

$iso hat dieselbe Bedeutung wie beim Standardland

Die Ausgabe ist dann BulkGate\Message\Response

BulkGate\Message\Response Object ( [data:BulkGate\Message\Response:private] => Array ( [420777777777] => Array ( [number] => 420777777777 [iso] => cz [prefix] => 420 [area] => 420 [length] => 12 [area_found] => true ) [77777777] => Array ( [number] => 42177777777 [iso] => sk [prefix] => 421 [area] => 421 [length] => 8 [area_found] => false ) ) )

Der Wert area_found gibt an, ob die Nummer dem landesspezifischen Format entspricht.

War diese Seite hilfreich?

KI fragen Kopiert