ID zprávy (dříve SMS ID)

Každá zpráva odeslaná přes BulkGate dostane vlastní ID zprávy. Je to jediný údaj, podle kterého dohledáme jednu konkrétní zprávu — v portálu, v odpovědi API i u doručovatele. Dřív se mu říkalo SMS ID; jde o tutéž hodnotu, jen se mezitím přejmenovala, protože už dávno neposíláme jen SMS.

Co je ID zprávy

ID zprávy je textový identifikátor jedné zprávy jednomu příjemci.

• Přiděluje ho BulkGate automaticky ve chvíli, kdy zprávu přijme. Nedá se zvolit ani zpětně změnit.
• Platí pro jednu zprávu jednomu číslu. Odeslání kampaně na tisíc čísel vytvoří tisíc různých ID zprávy, ne jedno společné.
• Jeho podoba se liší podle toho, kterým rozhraním zprávu pošlete. Berte ho jako neprůhledný řetězec — neodvozujte z něj datum, kanál ani nic jiného a nepokoušejte se ho skládat sami.

Proč se dřív jmenovalo SMS ID

Název SMS ID je z doby, kdy BulkGate posílal jen SMS. Dnes stejnou cestou jdou i Viber, WhatsApp a RCS, takže se identifikátor jmenuje ID zprávy — v portálu i v novějších rozhraních.

Starší API ale svoje pole nepřejmenovala, aby nerozbila existující integrace:

Ve všech případech jde o stejnou hodnotu. Když tedy vezmete sms_id z odpovědi Simple API a vyhledáte ho v historii pod ID zprávy, najdete tutéž zprávu.

Kde ID najdu v portálu

1. V menu klikněte na Reporty
2. Klikněte na Historie
3. Klikněte na řádek zprávy — rozbalí se detail
4. Vpravo v detailu je ID zprávy; kliknutím se označí celé a dá se zkopírovat

Opačně to jde taky: když ID zprávy už máte a chcete k němu dohledat zprávu, otevřete Filtr nad tabulkou a vložte hodnotu do pole ID zprávy. Stejnou hodnotu obsahuje i export historie do CSV.

Co všechno historie ukazuje a jak se v ní filtruje, popisuje Historie.

Kde ID najdu v odpovědi API

Rozhraní vrací ID zprávy hned v odpovědi na odeslání — je to jediná chvíle, kdy ho dostanete programově, takže si ho uložte už v tomto kroku.

Vedle něj vrací každé z nich ještě pole part_id — popisuje ho Co je part_id.

U hromadného odeslání obsahuje odpověď pole response se záznamem pro každého příjemce zvlášť. ID zprávy je v takovém případě zakončené pořadovým číslem zprávy v dávce:

Co je part_id

Dlouhá SMS se do sítě operátora nepředává vcelku — rozdělí se na několik samostatných zpráv, které telefon příjemce zase složí dohromady. Každá taková část má vlastní ID a part_id je jejich seznam. Kdy a proč se zpráva dělí, popisuje Zřetězení zpráv.

Pole se řídí třemi pravidly:

• Poslední prvek je vždy shodný s ID zprávy — je bez přípony.
• Předchozí části mají příponu _1, _2 a tak dál, podle pořadí, ve kterém se zpráva skládá.
• Zpráva, která se nerozdělila, má v part_id jediný prvek totožný s ID zprávy. Týká se to každé jednodílné SMS a také všech zpráv na Viberu, WhatsAppu a RCS — ty se na části nedělí nikdy.

Odpověď u SMS rozdělené na tři části tedy vypadá takto:

Kde ID najdu ve webhooku

Potvrzení o doručení dorazí na adresu, kterou si nastavíte, a ID zprávy je v něm v parametru smsID. Podle něj potvrzení spárujete se zprávou, kterou jste odeslali.

• Jednotlivě dorazí požadavek metodou GET, hodnoty jsou v query stringu — viz Potvrzení o doručení.
• Hromadně dorazí jeden požadavek metodou POST s polem záznamů ve formátu JSON — viz Hromadné potvrzení o doručení.

Kde se adresa pro doručenky nastavuje, popisují Webhooky.

K čemu ID zprávy slouží

• Nahlášení problému s doručením. Bez ID zprávy konkrétní zprávu u doručovatele nedohledáme. Celý postup popisuje Zpráva nebyla doručena — do jednoho hlášení můžete vložit až tři různá ID zprávy.
• Párování ve vlastním systému. Uložte si ID zprávy z odpovědi API k objednávce nebo zákazníkovi a přicházející potvrzení o doručení k nim přiřadíte podle parametru smsID.
• Dohledání zprávy v historii. ID zprávy je jediný filtr, který vede přesně na jednu zprávu; podle čísla nebo kampaně jich najdete víc.

Čím se liší od ostatních identifikátorů

V detailu zprávy v historii vidíte vedle ID zprávy ještě další identifikátory. Pletou se snadno, přitom každý odpovídá na jinou otázku: