Hromadné transakčné správy – špecifikácia

API URL

Adresa URL používaná na odosielanie HTTP požiadaviek:

https://portal.bulkgate.com/api/1.0/integration/transactional-bulk

Poznámka

Ak sa požiadavka nedostane k cieľu, zopakujte ju na záložnom serveri backup1.bulkgate.com.

POST /api/1.0/integration/transactional-bulk HTTP/1.1 Host: portal.bulkgate.com Content-Type: application/json

Pozor

Je prísne zakázané využívať transakčné SMS na propagačné/marketingové účely. Musia sa používať iba na oznamovacie účely - ako SMS oznámenia.

Poznámka

Ak chcete transakčnú routu použiť na zasielanie hromadných transakčných správ, obráťte sa na našu podporu. Túto možnosť môžeme z dobrých dôvodov povoliť.

Upozornenie

Správu dostanú aj príjemcovia, ktorí sa z odberu odhlásili (odhlásenie z odberu platí iba pre propagačné správy).

Tabuľka s parametrami

NÁZOV PARAMETRA	HODNOTA	POVINNÝ	PREDVOLENÁ HODNOTA
application_id	ID aplikácie	Áno	-
application_token	Overovací token aplikácie	Áno	-
tag	Osobná identifikačná značka	Nie	-
messages	Pole správ	Áno	Objekt správy

Objekt správy

NÁZOV PARAMETRA	HODNOTA	POVINNÝ	PREDVOLENÁ HODNOTA
primary_channel	Primárny kanál, ktorý sa použije ako prvý v kaskáde	Nie	`sms`
phone_number	Telefónne číslo príjemcu	Áno	-
country	Uveďte čísla príjemcov v medzinárodnom formáte (s predvoľbou, napr. `420`) alebo pridajte kód krajiny (`775123456` + `CZ` = `420775123456`). Pozrite si príklad požiadavky s krajinou. Ak je hodnota `null`, na doplnenie informácie sa použije vaše nastavené časové pásmo	Nie	`null`
schedule	Naplánujte čas a dátum odoslania v unixovom čase. Pozrite si príklady uvedené nižšie.	Nie	`null`
channels	Asociatívne pole objektov kanálov	Áno	Objekt kanála

Tabuľka parametrov Viber objektu

NÁZOV PARAMETRA	HODNOTA	POVINNÝ	PREDVOLENÁ HODNOTA
sender	Meno odosielateľa	Nie	-
expiration	Čas, po ktorom správe vyprší platnosť	Nie	`3600`
text	Text správy. Do šablóny je možné doplniť premenné z poľa `variables` (ďalší parameter) `Hello <first_name> <last_name> ....`	Áno	-
variables	Asociatívne pole na doplnenie premenných do textu, napr.: `{"first_name": "John", "last_name": "Doe"}`	Nie	`[]`

Tabuľka parametrov SMS objektu

NÁZOV PARAMETRA	HODNOTA	POVINNÝ	PREDVOLENÁ HODNOTA
sender_id	ID odosielateľa, pozri typ ID odosielateľa	Nie	`gSystem`
sender_id_value	Hodnota odosielateľa - `gOwn` (napr. "420 777 777 777"), `gText` (napr. "BulkGate"), `gProfile` (napr. "423"), `gMobile` alebo `gPush` (KEY)	Nie	`''`
unicode	`Yes`/`true`/`1` pre Unicode SMS, `no`/`false`/`0` pre 7bit SMS	Nie	`false`
text	Text SMS správy (max. 612 znakov alebo 268 znakov, ak je aktivovaný Unicode), kódovanie UTF-8. Do šablóny je možné doplniť premenné z poľa `variables` (ďalší parameter) `Hello <first_name> <last_name> ....`	Áno	-
variables	Asociatívne pole na doplnenie premenných do textu, napr.: `{"first_name": "John", "last_name": "Doe"}`	Nie	`[]`

Typ ID odosielateľa `sender_id`

HODNOTA	POPIS
`gSystem`	Systémové číslo
`gShort`	Short Code
`gText`	Textový odosielateľ
`gMobile`	Mobile Connect
`gPush`	Mobile Connect push - Odošle notifikáciu do vašej aplikácie Mobile Connect
`gOwn`	Vlastné číslo (vyžaduje overenie čísla)
`gProfile`	ID profilu odosielateľa
`<int>`	ID profilu odosielateľa

Príklad úplnej požiadavky:

POST /api/1.0/integration/transactional-bulk HTTP/1.1 Host: portal.bulkgate.com Content-Type: application/json { "application_id": 451, "application_token": "NKN02TWE6NfBkfl-your-secret-token-Wf05GaqLIWLW4aBj", "tag": "", "messages": [ { "primary_channel": "sms", "phone_number": "420777777777", "country": "cz", "schedule": 1683101313, "channels": { "viber": { "sender": "BulkGate", "expiration": 3600, "text": "test <variable_1>", "variables": { "variable_1": "name" } }, "sms": { "sender_id": "gSystem", "sender_id_value": "BulkGate", "unicode": false, "text": "test <variable_1>", "variables": { "variable_1": "name" } } } }, { "primary_channel": "sms", "phone_number": "420777777778", "country": "cz", "schedule": 1683101313, "channels": { "viber": { "sender": "BulkGate", "expiration": 3600, "text": "test <variable_1>", "variables": { "variable_1": "name" } }, "sms": { "sender_id": "gSystem", "sender_id_value": "BulkGate", "unicode": false, "text": "test <variable_1>", "variables": { "variable_1": "name" } } } } ] }

Odpoveď na tento príkaz môže byť:

V prípade úspechu

{ "data": { "total": { "status": { "sent": 0, "accepted": 0, "scheduled": 2, "error": 0, "blacklisted": 0, "invalid_number": 0, "invalid_sender": 0 } }, "response": [ { "status": "scheduled", "message_id": "#############-0", "part_id": [ "#############-0" ], "number": "420777777777", "channel": "sms" }, { "status": "scheduled", "message_id": "#############-1", "part_id": [ "#############-1" ], "number": "420777777778", "channel": "sms" } ] } }

V prípade chyby:

{ "data": { "total": { "status": { "sent": 0, "accepted": 0, "scheduled": 0, "error": 0, "blacklisted": 0, "invalid_number": 0, "invalid_sender": 0 } }, "response": [] } }

{ "type": "unknown_identity", "code": 401, "error": "Unknown identity / unauthorized / empty application_id", "detail": null }

Kde:

type a error (popis chyby) nájdete v tabuľke typov chýb
code predstavuje HTTP chybu
detail je doplňujúca informácia o chybe

Všetky typy chýb pre Simple API a Advanced API nájdete tu.

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

Opýtať sa AI Skopírované