Service Sender

use BulkGate\Sms\Sender;

Pour envoyer un message de type BulkGate\Sms\IMessage

vous devez créer un service d'envoi (sender), ce qui peut se faire de deux manières :

Nette framework - si vous utilisez le framework Nette
PHP - dans les autres cas

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

Envoi des messages

Pour envoyer le message, utilisez la méthode send(), qui reçoit des messages de type BulkGate\Sms\IMessage.

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

Réponse pour `BulkGate\Sms\Message`

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

Réponse pour `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

Pour configurer l'Unicode, appelez la méthode unicode().

/** @var BulkGate\Sms\Sender $sender */ $sender->unicode(); // Activer $sender->unicode(true); // Activer $sender->unicode(false); // Désactiver

Paramètres de l'expéditeur

Le paramétrage du type d'expéditeur est décrit dans ce chapitre.

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

Pays par défaut

Si vous indiquez les numéros de téléphone au format national, le système ne sait pas où envoyer les messages. C'est pourquoi, à moins que le préfixe international ne soit explicitement renseigné, vous pouvez définir pour le type d'expéditeur le pays par défaut vers lequel les messages seront acheminés.

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

Validation des numéros

Si vous avez besoin de vérifier qu'un numéro de téléphone correspond au format du pays, utilisez la méthode checkPhoneNumbers().

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

Où $numbers peut être :

un numéro de téléphone sous forme de chaîne "420777777777"
un numéro de téléphone de type BulkGate\Sms\Message\PhoneNumber
un tableau de numéros de téléphone ['420777777777','420777777778','420777777779']
un tableau de numéros de téléphone de type BulkGate\Sms\Message\PhoneNumber

$iso a la même signification que le pays par défaut

Le résultat est alors 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 ) ) )

La valeur area_found indique si le numéro respecte le format propre au pays.

Cette page vous a-t-elle été utile ?

Demander à l'IA Copié