Dokumentace
Přihlásit se Vyzkoušet zdarma
 Stav služby
Angličtina (English) Čeština (Čeština)

Nic nenalezeno

Přihlásit se Vyzkoušet zdarma

SMS kanál

Objekt SMS kanálu. Vkládá se do objektu channel pod klíč sms - viz Kaskáda. SMS je zároveň kanál, který se použije, když objekt channel v requestu neuvedete vůbec.

Objekt je stejný pro Advanced transactional i Advanced promotional.

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

SMS objekt

NÁZEV PARAMETRU HODNOTA POVINNÝ VÝCHOZÍ HODNOTA
text Text SMS zprávy (max. 612 znaků nebo 268 znaků, jestliže je aktivován Unicode), UTF-8 kódování. Má přednost před textem na nejvyšší úrovni, viz Který text se použije Ne null
sender_id Typ odesílatele, viz Typ odesílatele Ne gSystem
sender_id_value Hodnota patřící k sender_id - gOwn (např. "420 777 777 777"), gText (např. "BulkGate"), gProfile (např. "423"), gMobile nebo gPush (KEY) Ne null
unicode yes/true/1/on pro Unicode SMS, no/false/0/off pro 7bit SMS Ne false

Do text můžete vkládat proměnné z pole variables stejně jako do textu na nejvyšší úrovni: Dobrý den <first_name> <last_name>.

Typ odesílatele sender_id

HODNOTA VÝZNAM
gSystem Systémové číslo
gShort Short Code
gText Textový odesílatel
gMobile Mobile Connect
gPush Mobile Connect push - odešle notifikaci do aplikace Mobile Connect
gOwn Vlastní číslo (vyžaduje ověření čísla)
gProfile BulkGate Profile ID
<int> BulkGate Profile ID

Zadání celého čísla jako sender_id je zkratka pro profil: "sender_id": 423 se čte jako "sender_id": "gProfile" s "sender_id_value": "423".

Poznámka

Parametr flash se kvůli zpětné kompatibilitě stále přijímá, ale na zprávu nemá žádný vliv.

Související články v Nápovědě

  • Typ odesílatele — systémové číslo, short code, textový odesílatel, vlastní číslo
  • Unicode — diakritika a speciální znaky, a proč zkracují zprávu na 268 znaků
  • Zřetězení zpráv — jak se dlouhá SMS dělí na části a kolik znaků se vejde do jedné

Příklad kompletního requestu

Zpráva na dvě čísla, odeslaná z textového odesílatele a zakódovaná jako Unicode. <first_name> se nahradí z pole 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 } } }

Zpráva do dvou skupin z adresáře, odeslaná z Profile ID. same_number zabrání druhé zprávě na číslo, které 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" } } }

Odpověď je pro všechny kanály stejná - viz Advanced transactional nebo Advanced promotional.

Byla tato stránka užitečná?
Zeptat se AI Zkopírováno