Inštalácia

Composer

Najjednoduchší spôsob, ako nainštalovať bulkgate/php-sdk do projektu, je pomocou nástroja Composer cez príkazový riadok.

composer require bulkgate/php-sdk

Ak máte balík nainštalovaný, stačí len pripojiť autoloader.

require_once __DIR__ . '/vendor/autoload.php';

use BulkGate\Sdk\Connection\ConnectionStream; use BulkGate\Sdk\MessageSender; use BulkGate\Sdk\Scheduler\Simple; use BulkGate\Sdk\Configurator\ViberConfigurator;

Aby ste mohli odosielať správy, potrebujete inštanciu triedy BulkGate\Sdk\MessageSender , ktorá vyžaduje závislosť na inštancii triedy BulkGate\Sdk\Connection\Connection. Pozrite sa, ako získať prístupové údaje k API.

$connection = new ConnectionStream(/*application_id: */ 451, /*application_token:*/ 'NKN02TWE6NfBkfl-your-secret-token-Wf05GaqLIWLW4aBj'); $sender = new MessageSender($connection);

V tejto chvíli už máte všetko pripravené na odoslanie správy.

$message = new Sms('420777777777', 'test message'); $sender->send($message);

Metóda send() odošle správu $message.

Výsledok odoslania

Metóda send() vracia tú istú správu s doplneným stavom. Výsledok prečítate z verejných vlastností:

$message = $sender->send(new Sms('420777777777', 'test message')); $message->status; // 'accepted', 'sent', 'scheduled' alebo 'error' $message->message_id; // ID správy $message->part_id; // ID jednotlivých častí správy $message->error; // popis chyby, inak null

Pri hromadnej správe sa stav naplní pri každej správe zvlášť — prejdite ju cyklom foreach.

Ošetrenie chýb

Odoslanie môže skončiť výnimkou. Všetky dedia zo BulkGate\Sdk\SdkException:

Výnimka	Kedy nastane
`ConnectionException`	Nepodarilo sa spojiť s API
`ApiException`	API vrátilo chybu (napríklad neplatné prihlasovacie údaje)
`SenderException`	Senderu bol odovzdaný neznámy typ správy
`InvalidStateException`	Neplatná hodnota — napríklad ISO kód krajiny alebo jednotka plánovača
`ChannelException`	Chyba v nastavení kanála viackanálovej správy

try { $sender->send($message); } catch (BulkGate\Sdk\SdkException $e) { // zalogovať $e->getMessage() }

Voliteľná konfigurácia

$sender->setTag('your identificator');

Ak chcete zadávať telefónne čísla v národnom formáte, musíte nastaviť predvolenú krajinu.

$sender->setDefaultCountry('sk');

Do sendera môžete pridávať aj konfigurátory.

$viber_configurator = new ViberConfigurator('Sender'); $sender->addSenderConfigurator($viber_configurator);

Na plánovanie môžete pridať inštanciu BulkGate\Sdk\Scheduler\Scheduler.

$scheduler = new Simple(new DateTime('2022-05-14 20:00:00')); $sender->setScheduler($scheduler);

Bola táto stránka užitočná?

Opýtať sa AI Skopírované