API v2#

Základná URL pre komunikáciu s API v2#

Komunikácia s API v2 prebieha posielaním POST požiadaviek na nižšie uvedenú url:

https://smsapi.telekom.sk/v2

Funkcia message#

Metóda: POST
Endpoint: /message

Pre autentifikáciu je používaná HTTP hlavička X-API-KEY, ktorej hodnotu je potrebné nastaviť na vygenerovaný API kľúč
Pre odoslanie správy je potrebné vytvoriť POST požiadavku v nasledujúcom tvare:

curl -X POST\
-H "X-API-KEY: {{VÁŠ_API_KĽÚČ}}"\
-H "Accept: application/json"\
-H "Content-Type: application/json"\
-d '{
    -- Telo požiadavky, podrobne popísané nižšie --
    }'
"https://smsapi.telekom.sk/v2/messages"

Textová správaOdoslanie súboruCardCarousel

{
    "recipients": [
        {
            "phone": "+421XXXXXXXXX"
        }
    ],
    "channels": [
        {
            "type": "rcs",
            "ttl": 30
        },
        {
            "type": "sms"
        }
    ],
    "callbackUrls": [
        {
            "url": "https.zakaznik.app/callback",
            "types": [
                "postback",
                "dsn"
            ]
        }
    ],
    "rcs": {
        "text": "Prajete si dostávať správy z tohto čísla?",
        "suggestions": [
            {
                "reply": {
                    "text": "Áno",
                    "postbackData": "yes"
                }
            },
            {
                "reply": {
                    "text": "Nie",
                    "postbackData": "no"
                }
            }
        ]
    },
    "sms": {
        "text": "Fallback SMS, pokiaľ príjemca nie je dostupný pre RCS"
    }
}

{
    "recipients": [
        {
            "phone": "+421XXXXXXXXX"
        }
    ],
    "channels": [
        {
            "type": "rcs",
            "ttl": 30
        },
        {
            "type": "sms"
        }
    ],
    "callbackUrls": [
        {
            "url": "https.zakaznik.app/callback",
            "types": [
                "postback",
                "dsn"
            ]
        }
    ],
    "rcs": {
        "file": {
            "url": "https://pdfobject.com/pdf/sample.pdf"
        },
        "suggestions": [
            {
                "action": {
                    "text": "Vyberte polohu",
                    "postbackData": "test_text",
                    "fallbackUrl": "https://google.com",
                    "shareLocation": {}
                }
            }
        ]
    },
    "sms": {
        "text": "Fallback SMS, pokiaľ príjemca nie je dostupný pre RCS"
    }
}

{
    "recipients": [
        {
            "phone": "+421XXXXXXXXX"
        }
    ],
    "channels": [
        {
            "type": "rcs",
            "ttl": 30
        },
        {
            "type": "sms"
        }
    ],
    "callbackUrls": [
        {
            "url": "https.zakaznik.app/callback",
            "types": [
                "postback",
                "dsn"
            ]
        }
    ],
    "rcs": {
        "standaloneCard": {
            "cardOrientation": "VERTICAL",
            "thumbnailImageAlignment": "LEFT",
            "cardContent": {
                "title": "StandaloneCard Titulka",
                "description": "StandaloneCard Popis",
                "media": {
                    "height": "TALL",
                    "contentInfo": {
                        "fileUrl": "https://www.google.com/logos/doodles/2015/googles-new-logo-5078286822539264.3-hp2x.gif"
                    }
                },
                "suggestions": [
                    {
                        "reply": {
                            "text": "Áno",
                            "postbackData": "yes"
                        }
                    },
                    {
                        "reply": {
                            "text": "Nie",
                            "postbackData": "no"
                        }
                    }
                ]
            }
        }
    },
    "sms": {
        "text": "Fallback SMS, pokiaľ príjemca nie je dostupný pre RCS"
    }
}

{
    "recipients": [
        {
            "phone": "+421XXXXXXXXX"
        }
    ],
    "channels": [
        {
            "type": "rcs",
            "ttl": 30
        },
        {
            "type": "sms"
        }
    ],
    "callbackUrls": [
        {
            "url": "https.zakaznik.app/callback",
            "types": [
                "postback",
                "dsn"
            ]
        }
    ],
    "rcs": {
        "carouselCard": {
            "cardWidth": "MEDIUM",
            "cardContents": [
                {
                    "title": "Google Karta",
                    "description": "Karta s výškou obrázka SHORT",
                    "media": {
                        "height": "SHORT",
                        "contentInfo": {
                            "fileUrl": "https://services.google.com/fh/files/misc/google_g_icon_download.png"
                        }
                    },
                    "suggestions": [
                        {
                            "action": {
                                "text": "Otvoriť Google",
                                "postbackData": "open_google",
                                "fallbackUrl": "https://google.com",
                                "openUrl": {
                                    "url": "https://google.com"
                                }
                            }
                        }
                    ]
                },
                {
                    "title": "Telekom karta",
                    "description": "Karta s výškou obrázka TALL",
                    "media": {
                        "height": "TALL",
                        "contentInfo": {
                            "fileUrl": "https://www.telekom.sk/documents/10179/19896051/telekom-logo.png"
                        }
                    },
                    "suggestions": [
                        {
                            "action": {
                                "text": "Zavolať podporu",
                                "postbackData": "call_support",
                                "fallbackUrl": "https://telekom.sk",
                                "dial": {
                                    "phoneNumber": "0800123456"
                                }
                            }
                        }
                    ]
                }
            ]
        }
    },
    "sms": {
        "text": "Fallback SMS, pokiaľ príjemca nie je dostupný pre RCS"
    }
}

Popis jednotlivých parametrov

Parameter	Typ	Povinnosť	Popis
recipients[]	array	✔️	Zoznam príjemcov správy.
channels[]	array	✔️	Zoznam kanálov pre odoslanie správy.
deliveryTime	string (datetime)	❌	Dátum a čas odoslania správy.
priority	integer	❌	Priorita odosielania správy. Možné hodnoty parametra: 1 (Nízka) 2 (Štandardná) - Default 3 (Vysoká).
groupId	integer	❌	ID kadenčnej skupiny, prostredníctvom ktorej bude správa odoslaná.
callbackUrls	array	❌	Callback url, ktoré budú volané pri zmene stavu/spätnej správe.
sms	object	ℹ️	Objekt s informáciami o SMS.
rcs	object	ℹ️	Objekt s informáciami o RCS.

_{ℹ️ - Parametre sms a rcs sú povinné pokiaľ je tento typ správy zadefinovaný v parametri channels.}

recipients#

Parameter recipients obsahuje zoznam príjemcov pre danú správu. Každá správa musí obsahovať aspoň jedného príjemcu.

Názov parametra	Typ parametra	Povinnosť	Popis
phone	string	✔️	Telefónne číslo príjemcu v tvare +421XXXXXXXXX.
externalId	string	❌	Slúži na identifikáciu správy zo strany zákazníka. Odosiela sa pri úspešnom prijatí požiadavky a pri callbacku.

Príklad

[
    {
        "phone": "+421XXXXXXXXX",
        "externalId": "8e9b404f-fd1d-4633-926c-13c286514427"
    },
    {
        "phone": "+421YYYYYYYYY",
        "externalId": "caf87152-2b04-4f67-a97a-963efc3f0c21"
    }
],

channels#

Parameter channels obsahuje zoznam s informáciou o kanáloch pre doručenie správy. Poradie kanálov v zozname určuje ich prioritu. Každá správa musí mať aspoň jeden kanál, prostredníctvom ktorého bude odoslaná.

Názov parametra	Typ parametra	Povinnosť	Popis
type	string	✔️	Kanál, cez ktorý bude správa odoslaná. Možné hodnoty parametra sú : rcs sms
ttl	integer	❌	Počet sekúnd, po ktorých sa správa označí ako nedoručiteľná. Po uplynutí tohto času sa systém pokúsi odoslať správu cez nasledujúci kanál.

Príklad

[
    {
        "type": "rcs",
        "ttl": 5
    },
    {
        "type": "sms"
    }
],

Takto zadefinovaná správa sa bude odosielať primárne ako RCS. Pokiaľ sa správa neodošle do 5 sekúnd, bude použitý nasledujúci kanál a odošle sa ako SMS

deliveryTime#

Voliteľný parameter pre určenie času doručenia správy. Podporované sú viaceré formáty:

2025-09-25 08:00:00
2025-09-25T06:00:00Z (UTC)
2025-09-25T08:00:00+02:00 (CEST)

Pokiaľ parameter nie je určený alebo je jeho hodnota v minulosti, správa sa odošle okamžite.

callbackUrls#

Zoznam adries, ktoré budú volané pri zmene stavu doručenia správy alebo pri odpovedi príjimateľa.

Názov parametra	Typ parametra	Povinnosť	Popis
url	string	✔️	Url, na ktorú príde požiadavka pri zmene stavu správy alebo odpovedi.
types	array - string	✔️	Typ callbacku. Podporované sú 2 hodnoty: dsn - informácia o zmene stavu doručenia správy postback - odpoveď na správu pomocou suggestions.

Príklad

alebo

href="#__codelineno-8-1">[ { "url": "https://zakaznik.app/postback", "types": [ "postback" ] }, { "url": "https://zakaznik.app/dsn", "types": [ "dsn" ] } class="p">] href="#__codelineno-9-1">[ { "url": "https://zakaznik.app/callbacks", "types": [ "postback", "dsn" ] } class="p">]

sms#

Obsahuje informácie potrebné pre odoslanie SMS.

Názov parametra	Typ parametra	Povinnosť	Popis
text	string	✔️	Text správy. Maximálna dĺžka správy závisí od použitého kódovania.
from	string	❌	Číslo alebo textový identifikátor, ktorý bude zobrazený u prijímateľa. Pokiaľ tento parameter nebude definovaný, použije sa primárne číslo priradené k účtu.
unicode	boolean	❌	V prípade, že tento parameter nie je definovaný, aplikácia odošle správu na základe automatickej detekcie kódovania. `true` pošle ako unicode[UTF-16] `false` pošle ako GSM-7.

Príklad

{
    "text": "Text, z ktorého bude odstránená diakritika",
    "unicode":false
},

rcs#

Informácie potrebné pre odoslanie RCS správy

Názov parametra	Typ parametra	Povinnosť	Popis
text	string	ℹ️	Text správy
file	object	ℹ️	Objekt s informáciami o súbore.
standaloneCard	object	ℹ️	Objekt s definíciou mediálnej karty, ktorá sa zobrazí prijímateľovi
carouselCard	object	ℹ️	Objekt(carousel), ktorý môže obsahovať rôzne vizuálne prvky alebo médiá.
suggestions[]	array	❌	Návrhy na odpoveď vo forme tlačidiel, ktoré sa zobrazia pod správou.
from	string	❌	Názov agenta pre odoslanie RCS správy.

_{ℹ️ - Povinné je použiť presne jeden z týchto parametrov.}

rcs.file#

Názov parametra	Typ parametra	Povinnosť	Popis
url	string	✔️	Verejne dostupná URL adresa súboru. MIME typ súboru je určovaný na základe poľa content-type v HTTP hlavičke pri načítavaní súboru. Pole content-type musí byť v HTTP odpovedi z danej URL prítomné a presné. Odporúčaná maximálna veľkosť súboru je 100 MB. V prípade, že táto adresa odkazuje na neexistujúci súbor odosielanie správy RCS zlyhá a správa bude odoslaná nasledujúcim kanálom.
thumbnailUrl	string	❌	(Iba pre obrazové, zvukové a video súbory) Verejne dostupná URL adresa náhľadu. Maximálna veľkosť je 100 kB. Pokiaľ tento parameter nebude vyplnený, zobrazí sa prázdne zástupné okno, kým sa súbor nestiahne do zariadenia používateľa. V závislosti od nastavení zariadenia sa súbor nemusí stiahnuť automaticky a používateľ bude musieť stlačiť tlačidlo na stiahnutie. V prípade, že táto adresa odkazuje na neexistujúci súbor odosielanie správy RCS zlyhá a správa bude odoslaná nasledujúcim kanálom.
forceRefresh	boolean	❌	Pri hodnote true sa stiahne súbor a náhľad zo zadaných URL adries aj v prípade, ak sú už uložené kópie súboru (alebo náhľadu) vo vyrovnávacej pamäti.

Príklad

{
    "url": "https://www.google.com/logos/doodles/2015/googles-new-logo-5078286822539264.3-hp2x.gif",
    "thumbnailUrl": "https://www.google.com/logos/doodles/2015/googles-new-logo-5078286822539264.3-hp2x-thumbnail.gif",
    "forceRefresh": true
}

rcs.standaloneCard#

Názov parametra	Typ parametra	Povinnosť	Popis
cardOrientation	string (enum)	✔️	Orientácia karty. Môže mať 2 hodnoty: VERTICAL - vertikálne rozloženie HORIZONTAL - horizontálne rozloženie
cardContent	object	✔️	Obsah karty
thumbnailImageAlignment	string (enum)	❌	Zarovnanie náhľadu obrázka pre karty s horizontálnym rozložením.

Príklad

{
    "cardOrientation": "HORIZONTAL",
    "thumbnailImageAlignment": "RIGHT",
    "cardContent": {
        "title": "Slovak Telekom",
        "media": {
            "contentInfo": {
                "fileUrl": "https://www.telekom.sk/documents/10179/19896051/telekom-logo.png"
            }
        },
        "suggestions": [
            {
                "action": {
                    "text": "Zavolať podporu",
                    "postbackData": "call_support",
                    "dial": {
                        "phoneNumber": "+421800123456"
                    }
                }
            }
        ]
    }
}

rcs.standaloneCard.thumbnailImageAlignment#

Umiestnenie obrázka pri standaloneCard s horizontálnym rozložením

LEFT - zarovnanie náhľadu doľava
RIGHT - zarovnanie náhľadu doprava

Ukážka

rcs.carouselCard#

Názov parametra	Typ parametra	Povinnosť	Popis
cardWidth	string (enum)	✔️	Šírka jednotlivých kariet. Môže mať 2 hodnoty: SMALL- 120 DP. Pokiaľ je šírka karty small nie je možné použiť media s výškou TALL MEDIUM - 232 DP
cardContents[]	array objektov cardContent	✔️	Zoznam jednotlivých kariet. Minimálna dĺžka zoznamu je 2 a maximálna je 10 kariet.

Príklad

{
    "cardWidth": "MEDIUM",
    "cardContents": [
        {
            "title": "Predajne Slovak Telekom",
            "media": {
                "height": "TALL",
                "contentInfo": {
                    "fileUrl": "https://www.telekom.sk/documents/10179/19720195/spolupraca.jpg"
                }
            },
            "suggestions": [
                {
                    "action": {
                        "text": "Zobraziť predajne",
                        "postbackData": "open_url_nearby_stores",
                        "fallbackUrl": "https://www.telekom.sk/",
                        "viewLocation": {
                            "query": "Slovak Telekom predajňa"
                        }
                    }
                },
                {
                    "action": {
                        "text": "Zavolať zákaznícku linku",
                        "postbackData": "dial_support",
                        "fallbackUrl": "https://www.telekom.sk/",
                        "dial": {
                            "phoneNumber": "+421800123456"
                        }
                    }
                }
            ]
        },
        {
            "title": "Slovak Telekom",
            "media": {
                "height": "MEDIUM",
                "contentInfo": {
                    "fileUrl": "https://www.telekom.sk/documents/10179/19896051/telekom-logo.png"
                }
            },
            "suggestions": [
                {
                    "action": {
                        "text": "Volania",
                        "postbackData": "open_url_calls",
                        "openUrl": {
                            "url": "https://www.telekom.sk/volania"
                        }
                    }
                },
                {
                    "action": {
                        "text": "Internet",
                        "postbackData": "open_url_internet",
                        "openUrl": {
                            "url": "https://www.telekom.sk/internet"
                        }
                    }
                },
                {
                    "action": {
                        "text": "Televízia",
                        "postbackData": "open_url_tv",
                        "openUrl": {
                            "url": "https://www.telekom.sk/televizia"
                        }
                    }
                },
                {
                    "action": {
                        "text": "Stiahnúť aplikáciu",
                        "postbackData": "open_url_app",
                        "openUrl": {
                            "url": "https://play.google.com/store/apps/details?id=com.telekom.portal"
                        }
                    }
                }
            ]
        }
    ]
}

rcs.carouselCard.cardWidth#

Výška zobrazovaného média pri vertikálnom rozložení. Pri samostatnej karte s horizontálnym rozložením nie je výška prispôsobiteľná a toto pole sa ignoruje. Hodnoty:

SMALL - 120 DP. Pokiaľ je šírka karty small nie je možné použiť media s výškou TALL
MEDIUM - 232 DP

Ukážka

V uvedenom príklade je použitá výška karty MEDIUM v obidvoch prípadoch

cardContent#

Slúži na definovanie obsahu, ktorý sa zobrazí na karte.

Názov parametra	Typ parametra	Povinnosť	Popis
title	string	ℹ️	Názov karty. Maximálne 200 znakov
description	string	ℹ️	Popis karty. Maximálne 2000 znakov.
media	object	ℹ️	Mediálny súbor zobrazený na karte.
suggestions[]	array	❌	Návrhy odpovedí vo forme tlačidiel, ktoré sa zobrazia na karte.

_{ℹ️ - Povinné je použiť aspoň jeden z týchto parametrov.}

cardContent.media#

Mediálny súbor, ktorý sa zobrazí na karte

Názov parametra	Typ parametra	Povinnosť	Popis
height	string (enum)	✔️	Výška zobrazovaného média pri vertikálnom rozložení.
contentInfo	object	✔️	Informácie o mediálnom súbore vrátane URL adresy súboru a URL adresy jeho náhľadu.

cardContent.media.height#

Výška zobrazovaného média pri vertikálnom rozložení. Pri samostatnej karte s horizontálnym rozložením nie je výška prispôsobiteľná a toto pole sa ignoruje. Hodnoty:

SHORT - 112 DP.
MEDIUM - 168 DP.
TALL - 264 DP. Nie je možné použiť pre carousel card ak je veľkosť karty nastavená na SMALL.

Ukážka

cardContent.media.contentInfo#

Názov parametra	Typ parametra	Povinnosť	Popis
fileUrl	string	✔️	Verejne dostupná URL adresa súboru. MIME typ súboru je určovaný na základe poľa content-type v HTTP hlavičke pri načítavaní súboru. Pole content-type musí byť v HTTP odpovedi z danej URL prítomné a presné. Odporúčaná maximálna veľkosť súboru je 100 MB. V prípade, že táto adresa odkazuje na neexistujúci súbor odosielanie správy RCS zlyhá a správa bude odoslaná nasledujúcim kanálom.
thumbnailUrl	string	❌	(Iba pre obrazové, zvukové a video súbory) Verejne dostupná URL adresa náhľadu. Maximálna veľkosť je 100 kB. Pokiaľ tento parameter nebude vyplnený, zobrazí sa prázdne zástupné okno, kým sa súbor nestiahne do zariadenia používateľa. V závislosti od nastavení zariadenia sa súbor nemusí stiahnuť automaticky a používateľ bude musieť stlačiť tlačidlo na stiahnutie. V prípade, že táto adresa odkazuje na neexistujúci súbor odosielanie správy RCS zlyhá a správa bude odoslaná nasledujúcim kanálom.
forceRefresh	boolean	❌	Pri hodnote true sa stiahne súbor a náhľad zo zadaných URL adries aj v prípade, ak sú už uložené kópie súboru (alebo náhľadu) vo vyrovnávacej pamäti.

Príklad

{
    "fileUrl": "https://www.google.com/logos/doodles/2015/googles-new-logo-5078286822539264.3-hp2x.gif",
    "thumbnailUrl": "https://www.google.com/logos/doodles/2015/googles-new-logo-5078286822539264.3-hp2x-thumbnail.gif",
    "forceRefresh": true
}

suggestions#

Parameter suggestions je zoznam objektov, ktoré slúžia ako návrhy odpovedí pre prijímateľa. Maximálna dĺžka zoznamu je 11 návrhov. Objekt v zozname môže nadobúdať 2 typy a to reply alebo action, pričom tieto typy je v zozname možné kombinovať.

Tento parameter môže byť nastavený buď na úrovni rcs alebo cardContent. Ak je parameter nastavený na úrovni cardContent, jeho hodnota na úrovni rcs je ignorovaná.

Príklad

[
    {
        "reply": {
            "text": "Áno",
            "postbackData": "yes"
        }
    },
    {
        "reply": {
            "text": "Nie",
            "postbackData": "no"
        }
    },
    {
        "action": {
            "text": "Zavolať podporu",
            "postbackData": "call_support",
            "dial": {
                "phoneNumber": "+421800123456"
            }
        }
    }
]

suggestions.reply#

Objekt typu reply slúži ako návrh rýchlej textovej odpovede pre prijímateľa.

Názov parametra	Typ parametra	Povinnosť	Popis
text	string	✔️	Text, ktorý sa prijímateľovi zobrazí ako rýchla odpoveď. Maximálne 25 znakov.
postbackData	string	✔️	Dáta, ktoré sa odošlú na callbackUrl po kliknutí na rýchlu odpoveď

Príklad

{
    "reply": {
        "text": "Áno",
        "postbackData": "yes"
    }
},

suggestions.action#

Objekt typu action slúži pre navrhnutie akcie ako napr. zdieľanie lokácie, návšteva stránky, vytočenie čísla a pod.

Názov parametra	Typ parametra	Povinnosť	Popis
text	string	✔️	Text, ktorý sa zobrazí pri danej akcii. Maximálne 25 znakov
postbackData	string	✔️	Dáta, ktoré sa odošlú na callbackUrl po kliknutí na navhrovnú akciu
dial	object	ℹ️	Otvorí predvolenú aplikáciu na telefonovanie a vloží do nej špecifikované t.č.
viewLocation	object	ℹ️	Akcia na zobrazenie polohy v predvolenej mapovej aplikácii na základe zemepisnej šírky a dĺžky alebo dotazu
shareLocation	object	ℹ️	Otvorí výber polohy, kde si používateľ môže vybrať lokáciu, ktorú chce odoslať agentovi
openUrl	object	ℹ️	Akcia, ktorá otvorí poskytnutú url v predvolenom webovom prehliadači
createCalendarEvent	object	ℹ️	Akcia pre vytvorenie udalosti v kalendári
fallbackUrl	string	❌	URL adresa, ktorá sa otvorí v novom okne, ak zariadenie nepodporuje funkciu suggestions

_{ℹ️ - Povinné je použiť presne jeden z týchto parametrov.}

suggestions.action.dial#

Názov parametra	Typ parametra	Povinnosť	Popis
phoneNumber	string	✔️	Telefónne číslo vo formáte +421XXXXXXXXX

Príklad

{
    "action": {
        "text": "Zavolať podporu",
        "postbackData": "call_support",
        "fallbackUrl": "https://telekom.sk",
        "dial": {
            "phoneNumber": "0800123456"
        }
    }
}

suggestions.action.viewLocation#

Názov parametra	Typ parametra	Povinnosť	Popis
latLong	object	ℹ️	Objekt, ktorý na základe zemepisnej šírky a dĺžky definuje miesto na mape
query ⚠️	string	ℹ️	Pre predvolené mapové aplikácie, ktoré podporujú funkciu vyhľadávania (vrátane Google Maps), klepnutie na túto navrhovanú akciu spôsobí vyhľadanie miesta v okolí aktuálnej polohy používateľa. Ak je dotaz dostatočne špecifický, môže byť použiťý na určenie akéhokoľvek miesta na svete. Napríklad nastavenie dotazu na Slovak Telekom zobrazí všetky pobočky Slovak Telekom v okolí používateľa. Nastavenie dotazu na Námestie SNP 1, 811 01 Bratislava vyberie túto konkrétnu adresu bez ohľadu na polohu používateľa.
label	string	❌	Názov miesta definovaného objektom latLong

_{ℹ️ - Je povinné použiť presne jeden z týchto parametrov.}
_{⚠️ - Dostupné iba na zariadeniach s Android OS.}

Príklad

{
   "action": {
        "text": "Slovak Telekom",
        "postbackData": "view_location",
        "fallbackUrl": "https://www.telekom.sk/",
        "viewLocation": {
            "query": "Slovak Telekom"
        }
    }
}

suggestions.action.viewLocation.latLong#

Názov parametra	Typ parametra	Povinnosť	Popis
latitude	number	✔️	Zemepisná šírka v stupňoch. Musí byť v rozsahu [-90.0, +90.0]
longitude	number	✔️	Zemepisná dĺžka v stupňoch. Musí byť v rozsahu [-180.0, +180.0]

Príklad

{
    "latitude": 49.16259795554555, 
    "longitude": 19.999893522995347
}

suggestions.action.shareLocation#

Umožňuje užívateľovi poslať polohu vášmu agentovi. Poloha, ktorú užívateľ určí, nemusí byť nutne polohou užívateľa. Táto akcia nemá žiadne povinné ani voliteľné parametre.

suggestions.action.openUrl#

Názov parametra	Typ parametra	Povinnosť	Popis
url	string	✔️	URL adresa, ktorá sa otvorí v predvolenom prehliadači

Príklad

{
    "action": {
        "text": "Telekom aplikácia",
        "postbackData": "test_text",
        "fallbackUrl": "https://google.com",
        "openUrl": {
            "url": "https://play.google.com/store/apps/details?id=com.telekom.portal",
            "description": "Popis url"
        }
    }
}

suggestions.action.createCalendarEvent#

Názov parametra	Typ parametra	Povinnosť	Popis
title	string	✔️	Názov udalosti
description	string	✔️	Popis udalosti
startDateTime	string (date-time)	✔️	Začiatok udalosti
endDateTime	string (date-time)	✔️	Koniec udalosti

Dátum je potrebné zadávať vo formáte RFC 3339: "YYYY-MM-DDTHH:MM:SS±[hh:mm]", napr:

2025-09-25T06:00:00Z (UTC)
2025-09-25T08:00:00+02:00 (CEST)

Príklad

{
    "action": {
        "text": "Pridať do kalendára",
        "postbackData": "calendar",
        "fallbackUrl": "https://google.com",
        "createCalendarEvent": {
            "title": "Názov udalosti",
            "description" : "Popis udalosti",
            "startDateTime": "2025-05-16T14:00:00.00+02:00",
            "endDateTime": "2025-05-16T14:30:00.00+02:00"
        }
    }
}

Callback pre delivery status správy#

Formát požiadavky, ktorá bude pri zmene statusu odoslaná na adresu definovanú v parametri callbackUrls.

{
  "delivery": {
    "status": "DELIVERED",
  },
  "messageId": 991003276,
  "channel": "sms",
  "messageParts": 1,
  "type": "dsn",
  "timestamp": "2025-10-02T08:31:39.825Z"
}

Popis parametrov

Parameter	Typ	Popis
delivery.status	string	Stav správy. Nadobudnuteľné stavy sú popísané nižšie
messageId	integer	ID správy
channel	string	Kanál cez ktorý bola správa odoslaná. (sms, rcs, viber)
messageParts	integer	Počet správ, na ktoré bola správa rozdelená
type	string	Typ callbacku (dsn, postback)
timestamp	string	Timestamp vo formáte ISO 86001

Stavy parametra status:

Status	Popis
SCHEDULED	Správa je načasovaná na neskoršie odoslanie.
QUEUED	Správa bola prijatá a čaká na odoslanie.
SENDING	Správa sa aktuálne odosiela.
SENT	Správa bola odoslaná do SMS centra.
DELIVERED	Správa bola doručená adresátovi.
EXPIRED	Časový limit na doručenie správy vypršal.
DELETED	Správa bola odstránená z doručovacej fronty.
UNDELIVERABLE	Správu nie je možné doručiť.
DENIED	Správa bola zamietnutá SMS centrom.
IN_GROUP	Správa je zaradená do kadenčnej skupiny.
BLACKLISTED	Správa sa nachádza na blackliste a bola zablokovaná.
ERROR	Správu nie je možné odoslať z dôvodu chyby. Systém sa pokúsi opätovne správu doručiť ešte 5 krát v priebehu 60 minút.
UNKNOWN	Správa bola odoslaná, ale nie je možné zistiť stav doručenia.