Prihlásiť sa

Vyskúšať zadarmo

ID správy (predtým SMS ID)

Každá správa odoslaná cez BulkGate dostane vlastné ID správy. Je to jediný údaj, podľa ktorého dohľadáme jednu konkrétnu správu — v portáli, v odpovedi API aj u doručovateľa. Predtým sa mu hovorilo SMS ID; ide o tú istú hodnotu, len sa medzičasom premenovala, pretože už dávno neposielame len SMS.

Čo je ID správy

ID správy je textový identifikátor jednej správy jednému príjemcovi.

Prideľuje ho BulkGate automaticky vo chvíli, keď správu prijme. Nedá sa zvoliť ani spätne zmeniť.
Platí pre jednu správu jednému číslu. Odoslanie kampane na tisíc čísel vytvorí tisíc rôznych ID správy, nie jedno spoločné.
Jeho podoba sa líši podľa toho, ktorým rozhraním správu pošlete. Berte ho ako nepriehľadný reťazec — neodvodzujte z neho dátum, kanál ani nič iné a nepokúšajte sa ho skladať sami.

Tip

Ak potrebujete správy označiť vlastnou hodnotou, ktorú si zvolíte sami — číslom objednávky, ID zákazníka — slúži na to Značka (TAG), nie ID správy. Rozdiel popisuje Čím sa líši od ostatných identifikátorov.

Prečo sa predtým volalo SMS ID

Názov SMS ID pochádza z čias, keď BulkGate posielal len SMS. Dnes rovnakou cestou idú aj Viber, WhatsApp a RCS, takže sa identifikátor volá ID správy — v portáli aj v novších rozhraniach.

Staršie API však svoje polia nepremenovali, aby nerozbili existujúce integrácie:

Kde	Ako sa pole volá
Portál	`ID správy`
Simple API, Advanced API verzia `1.0`	`sms_id`
Advanced API verzia `2.0`, Integration API, jednorazové heslá	`message_id`
Potvrdenie o doručení (webhook)	`smsID`

Vo všetkých prípadoch ide o rovnakú hodnotu. Keď teda vezmete sms_id z odpovede Simple API a vyhľadáte ho v histórii pod ID správy, nájdete tú istú správu.

Kde nájdem ID v portáli

V menu kliknite na Reporty
Kliknite na História
Kliknite na riadok správy — rozbalí sa detail
Vpravo v detaile je ID správy; kliknutím sa označí celé a dá sa skopírovať

Opačne to ide tiež: keď ID správy už máte a chcete k nemu dohľadať správu, otvorte Filter nad tabuľkou a vložte hodnotu do poľa ID správy. Rovnakú hodnotu obsahuje aj export histórie do CSV.

Čo všetko história ukazuje a ako sa v nej filtruje, popisuje História.

Dôležité

Text správy sa v histórii neuchováva natrvalo — pri starších záznamoch sa namiesto neho zobrazí Platnosť textu tejto správy vypršala. ID správy a ostatné údaje zostávajú.

Kde nájdem ID v odpovedi API

Rozhranie vracia ID správy hneď v odpovedi na odoslanie — je to jediná chvíľa, keď ho dostanete programovo, takže si ho uložte už v tomto kroku.

Rozhranie	Ako sa pole volá
Simple API	`sms_id`
Advanced API `1.0`	`sms_id`
Advanced API `2.0`	`message_id`
Integration API	`message_id`
Jednorazové heslá	`message_id`

Popri ňom vracia každé z nich ešte pole part_id — popisuje ho Čo je part_id.

Pri hromadnom odoslaní obsahuje odpoveď pole response so záznamom pre každého príjemcu zvlášť. ID správy je v takom prípade zakončené poradovým číslom správy v dávke:

{ "data": { "response": [ { "status": "accepted", "message_id": "transactional-64afe5f28ffc2-0", "part_id": ["transactional-64afe5f28ffc2-0"], "number": "420777777777", "channel": "sms" }, { "status": "accepted", "message_id": "transactional-64afe5f28ffc2-1", "part_id": ["transactional-64afe5f28ffc2-1"], "number": "420777777778", "channel": "sms" } ] } }

Čo je part_id

Dlhá SMS sa do siete operátora neodovzdáva vcelku — rozdelí sa na niekoľko samostatných správ, ktoré telefón príjemcu znova poskladá dohromady. Každá taká časť má vlastné ID a part_id je ich zoznam. Kedy a prečo sa správa delí, popisuje Zreťazenie správ.

Pole sa riadi tromi pravidlami:

Posledný prvok je vždy zhodný s ID správy — je bez prípony.
Predchádzajúce časti majú príponu _1, _2 a tak ďalej, podľa poradia, v ktorom sa správa skladá.
Správa, ktorá sa nerozdelila, má v part_id jediný prvok totožný s ID správy. Týka sa to každej jednodielnej SMS a tiež všetkých správ na Viberi, WhatsAppe a RCS — tie sa na časti nedelia nikdy.

Odpoveď pri SMS rozdelenej na tri časti teda vyzerá takto:

{ "data": { "status": "accepted", "sms_id": "tmpde1bcd4b1d1", "part_id": [ "tmpde1bcd4b1d1_1", "tmpde1bcd4b1d1_2", "tmpde1bcd4b1d1" ], "number": "420777777777" } }

Dôležité

Každá časť sa účtuje ako samostatná SMS. Počet prvkov v part_id je preto zároveň počet správ, ktoré zaplatíte — v príklade vyššie tri, hoci ste odoslali jednu.

Tip

Na párovanie odpovedí a potvrdení o doručení vám stačí ID správy. part_id sa hodí, keď chcete hneď pri odoslaní vedieť, na koľko častí sa správa rozpadla — bez čakania na to, kým sa objaví v histórii.

Kde nájdem ID vo webhooku

Potvrdenie o doručení príde na adresu, ktorú si nastavíte, a ID správy je v ňom v parametri smsID. Podľa neho potvrdenie spárujete so správou, ktorú ste odoslali.

Jednotlivo príde požiadavka metódou GET, hodnoty sú v query stringu — pozrite Potvrdenie o doručení.
Hromadne príde jedna požiadavka metódou POST s poľom záznamov vo formáte JSON — pozrite Hromadné potvrdenie o doručení.

Kde sa adresa pre potvrdenia o doručení nastavuje, popisujú Webhooky.

Poznámka

Na jednu správu môže prísť viac potvrdení s rovnakým smsID — stav 2 znamená, že správa čaká u operátora a výsledok príde neskôr. Počítajte s tým, že tú istú hodnotu uvidíte opakovane.

Upozornenie

Prichádzajúce správy a odpovede, ktoré spoznáte podľa status s hodnotou 10, parameter smsID neobsahujú. Nejde o potvrdenie o doručení vašej odoslanej správy, ale o novú správu od príjemcu.

Na čo slúži ID správy

Nahlásenie problému s doručením. Bez ID správy konkrétnu správu u doručovateľa nedohľadáme. Celý postup popisuje Správa nebola doručená — do jedného hlásenia môžete vložiť až tri rôzne ID správy.
Párovanie vo vlastnom systéme. Uložte si ID správy z odpovede API k objednávke alebo zákazníkovi a prichádzajúce potvrdenia o doručení k nim priradíte podľa parametra smsID.
Dohľadanie správy v histórii. ID správy je jediný filter, ktorý vedie presne na jednu správu; podľa čísla alebo kampane ich nájdete viac.

Čím sa líši od ostatných identifikátorov

V detaile správy v histórii vidíte popri ID správy ešte ďalšie identifikátory. Ľahko sa zamieňajú, pritom každý odpovedá na inú otázku:

Identifikátor	Čo identifikuje	Kto ho určuje
`ID správy`	Jednu správu jednému príjemcovi	BulkGate
`ID Kampane`	Celú kampaň, teda všetky správy odoslané spoločne	BulkGate
`Značka (TAG)`	Čokoľvek, čo si označíte sami — objednávku, zákazníka, beh skriptu	Vy
`Application ID`	Aplikáciu, z ktorej správa odišla	BulkGate

Tip

Značka (TAG) je jediný z nich, ktorý si nastavíte sami. Keď ho pri odosielaní vyplníte, môžete podľa neho neskôr filtrovať históriu aj bez znalosti ID správy — hodí sa, keď potrebujete nájsť všetky správy k jednej objednávke.

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

Opýtať sa AI Skopírované