bulkgate / php-sdk

💌 Simple PHP SDK for sending SMS/Viber via BulkGate portal.

BulkGate SMS/Viber - PHP SDK

• BulkGate
• Helpdesk
• Portal

Installation

The easiest way to install bulkgate/php-sdk into a project is by using Composer via the command line.

composer require bulkgate/php-sdk

Quick start

Nette DI Extension

extensions:
	sdk: BulkGate\Sdk\DI\Extension

sdk:
	application_id: 0000
	application_token: XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX
	sender:
		tag: 'sdk' # Optional
		default_country: cz # Optional
	configurator:
		sms: # Optional
			sender_id: gText
			sender_id_value: 'Example'
			unicode: true
		viber: # Optional
			sender: Sender
			button:
				caption: 'Button Caption'
				url: 'https://www.bulkgate.com/'
			image: 
				url: 'https://www.example.com/example.png'
				zoom: true
			expiration: 3600 # seconds

use BulkGate\Sdk\Sender;
use BulkGate\Sdk\Message\Sms;

class Sdk
{
    private Sender $sender;

    public funnction __construct(Sender $sender)
    {
        $this->sender = $sender;
    }
    

    public function sendMessage(string $phone_number, string $text): void
    {    
        $this->sender->send(new Sms($phone_number, $text));
    }
}

Manual creation

use BulkGate\Sdk\Connection\ConnectionStream;
use BulkGate\Sdk\MessageSender;
use BulkGate\Sdk\Message\Sms;

$connection = new ConnectionStream(
    /*application_id: */ 0000, 
    /*application_token:*/ 'XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX'
);

$sender = new MessageSender($connection);

$sender->send(new Sms($phone_number, $text));

/* Optional */

$sender->setTag('sdk');

$sender->setDefaultCountry('cz');

$viber_configurator = new ViberConfigurator('Sender');
$viber_configurator->button('Button Caption', 'https://www.bulkgate.com/');
$viber_configurator->image('https://www.example.com/example.png', true);
$viber_configurator->expiration(3_600);

$sender->addSenderConfigurator($viber_configurator);

$sms_configurator = new SmsConfigurator('gText', 'Example', true);

$sender->addSenderConfigurator($sms_configurator);

$sender->send(new Sms($phone_number, $text));

Simple Manual

• Message sender
• SMS
• Viber
• Multi channel message
• Bulk message/Campaign
• Schedulers
• Configurators
• Number checker

API administration & tokens

API administration

API token

php-sdk's Issues

How to set Delivery confirmations or webhook URL for delivery reports.

Where and how do I set the URL to receive Delivery confirmations?

It is not clear reading: https://help.bulkgate.com/docs/en/http-low-level-api-delivery-confirmations-and-incoming-sms.html#delivery-confirmation-parameters

Option to check credits

Hello,
are there any plans to add option to check credits or will this be only available in HTTP api?

Sms is always sent via System number

I was upgrade deprecated Nette SDK to this library, but I have simple problem. All messages are sent as system number, even if all is set for Text Sender or Short Code. I tried to set it via Sms->configure(), Sms->settings->configure or MessageSender configurator, send message return type show me correctly that sender_id is gText, (sender_id_value has 11 characters), but in Portal and incoming SMS is only system number.
Also try to set a new API in Portal (PHP SDK) instead old Nette SDK, but nothing was changed.

So, until this will be fixed, I must turn back to old SDK, where everything was correct.