curl --request POST \
--url https://api.smsmngr.com/v2/message/priority \
--header 'Content-Type: application/json' \
--header 'x-api-key: <api-key>' \
--data '
{
"body": "Your verification code is 123456",
"to": [
{
"phone_number": "420777123456"
}
],
"tag": "transactional"
}
'{
"request_id": "66666666-6666-6666-6666-666666666666",
"accepted": [
{
"key": "0",
"message_id": "pppppppp-qqqq-rrrr-ssss-tttttttttttt"
}
],
"rejected": []
}{
"Message": "User is not authorized to access this resource with an explicit deny"
}Odeslání prioritní zprávy
Stejné jako /message, ale zpráva je zpracována prioritní frontou. Použijte pro časově kritické zprávy (jednorázová hesla, transakční notifikace). Formát požadavku i odpovědi je shodný s /message.
curl --request POST \
--url https://api.smsmngr.com/v2/message/priority \
--header 'Content-Type: application/json' \
--header 'x-api-key: <api-key>' \
--data '
{
"body": "Your verification code is 123456",
"to": [
{
"phone_number": "420777123456"
}
],
"tag": "transactional"
}
'{
"request_id": "66666666-6666-6666-6666-666666666666",
"accepted": [
{
"key": "0",
"message_id": "pppppppp-qqqq-rrrr-ssss-tttttttttttt"
}
],
"rejected": []
}{
"Message": "User is not authorized to access this resource with an explicit deny"
}Authorizations
Body
Seznam příjemců.
1 - 10 elementsShow child attributes
Show child attributes
Tělo zprávy (pokud není definováno ve flow). Tělo je povinné buď zde v kořenovém objektu, nebo v kroku flow. Delší texty jsou zkráceny na 1000 znaků.
1000Výchozí odesílatel pro všechny kroky flow. Pokud krok flow definuje vlastní sender, má hodnota z kroku flow vyšší prioritu. Alfanumerický název odesílatele (max. 11 znaků, může být vyžadována předchozí registrace) nebo dedikované virtuální číslo (bez +).
"Mojefirma"
"420777123456"
Tag zprávy. Můžete jej použít pro seskupování zpráv (např. podle id kampaně). Více tagů lze předat oddělených čárkou. Tagy jsou normalizovány na malá písmena a jsou zachovány pouze znaky a-z, 0-9, -, . a _. Existují také speciální tagy: priority (pro prioritní zprávy), transactional (pro transakční zprávy). Zprávy s výchozím tagem promotional jsou kontrolovány proti opt-out seznamu příjemců.
Zastaralý alias pole tag. Použijte tag.
Tímto objektem můžete zprávě předat speciální parametry, např. automatické zkracování odkazů přes objekt _url. Zeptejte se nás, jak tento parametr použít pro další funkce.
Show child attributes
Show child attributes
Naplánovaný čas odeslání zprávy. Vždy v UTC. Pokud je čas více než 1 minutu v budoucnosti, zpráva je naplánována a zpracována v daný čas. Časy v minulosti jsou odeslány okamžitě.
"2025-01-11T10:00:00Z"
Povolené doručovací okno. Pokud je aktuální (nebo naplánovaný) čas mimo okno, odeslání se posune na nejbližší platný čas.
Show child attributes
Show child attributes
Seznam komunikačních kanálů pro flow zprávy. Pokud je definován, nesmí být prázdný. Můžete použít více kanálů, na pořadí záleží (první kanál se použije jako první; pokud krok definuje ttl a jeho ttl_condition není v rámci TTL splněna, použije se další kanál, atd.). Pokud flow není definováno, použije se výchozí [{"sms": {"gateway": "high"}}].
Show child attributes
Show child attributes
Můžete odeslat payload zprávy, kde si můžete definovat libovolné parametry zprávy. Tento objekt je vrácen v notifikaci o doručení a v odpovědích.
{ "user_id": "123456" }
Was this page helpful?