Dokumentácia
Prihlásiť sa Vyskúšať zadarmo
 Stav služby
Angličtina (English) Čeština (Čeština) Francúzština (Français) Nemčina (Deutsch) Nórčina (Norsk) Portugalčina (Português) Slovenčina (Slovenčina) Španielčina (Español)

Nič sa nenašlo

Prihlásiť sa Vyskúšať zadarmo

SMS kanál

Objekt SMS kanála. Vkladá sa do objektu channel pod kľúč sms - pozrite Kaskáda. SMS je zároveň kanál, ktorý sa použije, keď objekt channel v requeste vôbec neuvediete.

Objekt je rovnaký pre Advanced transactional aj Advanced promotional.

{ "sms": { "sender_id": "gText", "sender_id_value": "BulkGate" } }

SMS objekt

NÁZOV PARAMETRA HODNOTA POVINNÝ PREDVOLENÁ HODNOTA
text Text SMS správy (max. 612 znakov alebo 268 znakov, ak je aktivovaný Unicode), kódovanie UTF-8. Má prednosť pred textom na najvyššej úrovni, pozrite Ktorý text sa použije Nie null
sender_id Typ odosielateľa, pozrite Typ odosielateľa Nie gSystem
sender_id_value Hodnota patriaca k sender_id - gOwn (napr. "420 777 777 777"), gText (napr. "BulkGate"), gProfile (napr. "423"), gMobile alebo gPush (KEY) Nie null
unicode yes/true/1/on pre Unicode SMS, no/false/0/off pre 7bit SMS Nie false

Do text môžete vkladať premenné z poľa variables rovnako ako do textu na najvyššej úrovni: Dobrý deň <first_name> <last_name>.

Typ odosielateľa sender_id

HODNOTA VÝZNAM
gSystem Systémové číslo
gShort Short Code
gText Textový odosielateľ
gMobile Mobile Connect
gPush Mobile Connect push - odošle notifikáciu do aplikácie Mobile Connect
gOwn Vlastné číslo (vyžaduje overenie čísla)
gProfile BulkGate Profile ID
<int> BulkGate Profile ID

Zadanie celého čísla ako sender_id je skratka pre profil: "sender_id": 423 sa číta ako "sender_id": "gProfile" so "sender_id_value": "423".

Poznámka

Parameter flash sa kvôli spätnej kompatibilite stále prijíma, ale na správu nemá žiadny vplyv.

Súvisiace články v Nápovede

  • Typ odosielateľa — systémové číslo, short code, textový odosielateľ, vlastné číslo
  • Unicode — diakritika a špeciálne znaky, a prečo skracujú správu na 268 znakov
  • Zreťazenie správ — ako sa dlhá SMS delí na časti a koľko znakov sa zmestí do jednej

Príklad kompletného requestu

Správa na dve čísla, odoslaná z textového odosielateľa a zakódovaná ako Unicode. <first_name> sa nahradí z poľa variables.

POST /api/2.0/advanced/transactional HTTP/1.1 Host: portal.bulkgate.com Content-Type: application/json { "application_id": 451, "application_token": "NKN02TWE6NfBkfl-your-secret-token-Wf05GaqLIWLW4aBj", "number": ["420777777777", "420777777778"], "text": "Hello <first_name>, your order has been shipped.", "variables": {"first_name": "John"}, "country": "cz", "channel": { "sms": { "sender_id": "gText", "sender_id_value": "BulkGate", "unicode": true } } }

Správa do dvoch skupín z adresára, odoslaná z Profile ID. same_number zabráni druhej správe na číslo, ktoré už v kampani je.

POST /api/2.0/advanced/promotional HTTP/1.1 Host: portal.bulkgate.com Content-Type: application/json { "application_id": 451, "application_token": "NKN02TWE6NfBkfl-your-secret-token-Wf05GaqLIWLW4aBj", "groups": [974, 975], "text": "Hello <first_name>, our spring sale starts today.", "duplicates_check": "same_number", "channel": { "sms": { "sender_id": "gProfile", "sender_id_value": "423" } } }

Odpoveď je pre všetky kanály rovnaká - pozrite Advanced transactional alebo Advanced promotional.

Bola táto stránka užitočná?
Opýtať sa AI Skopírované