Flows
SmsManager podporuje pět messagingových kanálů, každý s vlastními přednostmi a konfiguračními možnostmi. Můžete použít jeden kanál nebo je kombinovat v toku zpráv pro maximalizaci míry doručení. Tato stránka pokrývá, co každý kanál umožňuje, jaká pole přijímá a jak jej nastavit.- SMS
- Viber
- WhatsApp Text
- WhatsApp Šablona
- RCS
SMS flow
SMS je univerzálně nejpodporovanější kanál — funguje na každém mobilním telefonu, nevyžaduje instalaci žádné aplikace a je k dispozici prakticky v každé zemi. Použijte SMS jako spolehlivý samostatný kanál nebo jako finální zálohu ve vícekanálovém flow.Povinná pole
| Pole | Typ | Popis |
|---|---|---|
body | string | Text zprávy (max 1 000 znaků). |
Volitelná pole
| Pole | Typ | Výchozí | Popis |
|---|---|---|---|
sender | string | — | Alfanumerické jméno odesílatele (max 11 znaků) nebo vyhrazené virtuální číslo bez úvodního +, případně alias odesílatele. Pro alfanumerické odesílatele může být vyžadována předregistrace. Pokud ho v kroku neuvedete, použije se sender z kořene požadavku a poté výchozí odesílatel vašeho účtu (default_sender). Viz Odesílatelé. |
gateway | string | high | Směrovací brána. Použijte high pro standardní doručení, direct při odesílání z vyhrazeného virtuálního čísla nebo custom pro nastavení SIM hostování. |
ttl | integer | — | Doba života v minutách. Pokud nelze zprávu v tomto okně doručit, je vyřazena. |
type | string | utf | Kódování znaků. utf zachovává Unicode znaky (emoji, cyrilice atd.). sms odstraňuje nebo převádí Unicode pro maximalizaci počtu znaků na SMS část. |
Unicode a délka zprávy
Standardní SMS části obsahují až 160 znaků GSM-7. Pokud použijetetype: utf a zahrnete Unicode znaky, každá část se zmenší na 70 znaků. Mějte to na paměti u zpráv blízkých hranici částí: dlouhá zpráva, která je v pořádku jako prostý text, se může při přidání emoji rozdělit na více částí.Průvodce bránami
high— Výchozí sdílená brána, vhodná pro drtivou většinu SMS odeslání.direct— Použijte, pokud jste zakoupili vyhrazené virtuální číslo a chcete obousměrnou komunikaci. Nastavtesenderna vaše virtuální číslo (bez+). Pokudgatewayneuvedete asenderje vyhrazené virtuální číslo registrované pro váš účet, zvolímedirectautomaticky, včetně cenydirect. Podrobnosti najdete v popisu toku zpráv.custom— Použijte při používání hostování SIM karet. Kontaktujte podporu SmsManager pro konfiguraci této brány.
Příklad
{
"body": "Váš jednorázový kód je 8274. Platnost 10 minut.",
"to": [{ "phone_number": "420777123456" }],
"flow": [
{
"sms": {
"sender": "MojeFirma",
"gateway": "high",
"type": "sms",
"ttl": 10
}
}
]
}
Viber kanál
Viber Business Messages vám umožňují odesílat bohatý obsah — delší text, tlačítko s výzvou k akci a značková registrovaná jména odesílatele — přímo v aplikaci Viber. Viber zprávy jsou obvykle levnější než SMS a podporují bohatší uživatelský zážitek, vyžadují však, aby měl příjemce nainstalovaný Viber.Povinná pole
| Pole | Typ | Popis |
|---|---|---|
body | string | Text zprávy (max 1 000 znaků). |
sender | string | Předregistrované jméno Viber Business odesílatele nebo alias odesílatele. Musí přesně odpovídat jménu registrovanému přes SmsManager. Pokud ho v kroku neuvedete, použije se sender z kořene požadavku a poté výchozí odesílatel vašeho účtu (default_sender). Viz Odesílatelé. |
Volitelná pole
| Pole | Typ | Výchozí | Popis |
|---|---|---|---|
ttl | integer | — | Doba života v minutách. Pokud zpráva není doručena před vypršením TTL, SmsManager přejde na další kanál ve flow. |
buttons | array | — | Maximálně jedno tlačítko. Každý objekt tlačítka vyžaduje title (popisek tlačítka) a url (cílová URL). |
Požadavky na nastavení
Než budete moci odesílat Viber Business Messages, musíte registrovat Viber Business jméno odesílatele přes SmsManager. Jméno musí být schváleno Viberem a je obvykle vaší značkou nebo názvem společnosti. Pro zahájení registrace kontaktujte podporu SmsManager nebo navštivte dashboard účtu.Příklad
{
"body": "Vaše objednávka #5821 je připravena k vyzvednutí! 🎉",
"to": [{ "phone_number": "420777123456" }],
"flow": [
{
"viber": {
"sender": "MujObchod",
"ttl": 120,
"body": "Vaše objednávka #5821 je připravena k vyzvednutí! 🎉",
"buttons": [
{
"title": "Zobrazit objednávku",
"url": "https://example.com/orders/5821"
}
]
}
},
{
"sms": {
"sender": "MujObchod",
"body": "Vaše objednávka #5821 je připravena k vyzvednutí!"
}
}
]
}
Viber Business Messages jsou doručovány pouze příjemcům, kteří mají nainstalovanou aplikaci Viber. Vždy zahrnujte SMS zálohu ve svém flow, abyste dosáhli i příjemců, kteří Viber nepoužívají.
WhatsApp textový kanál
WhatsApp textové zprávy vám umožňují odesílat volný text přes WhatsApp — stejný druh zprávy, kterou by napsal člověk. Protože WhatsApp omezuje nevyžádané odchozí zprávy, můžete volný text odeslat pouze v rámci 24hodinového zákaznického okna: okno se otevře, když vám příjemce jako první napsal zprávu nebo odpověděl na jednu z vašich WhatsApp šablonových zpráv.Povinná pole
| Pole | Typ | Popis |
|---|---|---|
body | string | Text zprávy (max 1 000 znaků). Povoleno pouze v rámci 24hodinového zákaznického okna. U zprávy s médiem slouží jako popisek a můžete ho vynechat. |
sender | string | Phone Number ID vašeho registrovaného WhatsApp čísla nebo alias odesílatele. Pokud ho v kroku neuvedete, použije se sender z kořene požadavku a poté výchozí odesílatel vašeho účtu (default_sender). Viz Odesílatelé. |
Volitelná pole
| Pole | Typ | Popis |
|---|---|---|
image, video, document, audio | string nebo object | Médium z veřejné URL — buď URL jako řetězec, nebo objekt s url. V jedné zprávě použijte nejvýše jedno. Formáty a další pole najdete v referenci WhatsApp text. |
Požadavky na nastavení
Před odesíláním WhatsApp zpráv musíte ke svému účtu SmsManager připojit WhatsApp Business telefonní číslo. Své Phone Number ID najdete v nastavení WhatsApp na app.smsmanager.com/app/senders.Kdy použít WhatsApp text vs. WhatsApp šablonu
| Situace | Použijte |
|---|---|
| Příjemce vám napsal nebo odpověděl na šablonu v posledních 24 hodinách | whatsapp_text |
| Zahájení proaktivního kontaktu (příjemce vám nedávno nenapsal) | whatsapp_template |
Příklad
{
"to": [{ "phone_number": "420777123456" }],
"flow": [
{
"whatsapp_text": {
"sender": "514578330250514",
"body": "Děkujeme, že jste nás kontaktovali! Zde jsou požadované informace: https://example.com/faq"
}
}
]
}
Pokud se pokusíte odeslat
whatsapp_text zprávu mimo 24hodinové zákaznické okno, kanál selže a SmsManager přejde na další kanál ve vašem flow. Pro proaktivní oslovování použijte whatsapp_template.WhatsApp šablonový kanál
WhatsApp šablonové zprávy vám umožňují zahájit proaktivní kontakt s kterýmkoli příjemcem — i když vám nikdy nenapsal. Šablony jsou předschváleny Metou a obsahují pevný strukturální text s volitelnými proměnnými značkami. Protože jsou předem prověřeny, můžete je odeslání kdykoli, nejen v rámci zákaznického okna.Povinná pole
| Pole | Typ | Popis |
|---|---|---|
template_name | string | Přesný název schválené šablony (max 100 znaků). |
sender | string | Phone Number ID vašeho registrovaného WhatsApp čísla nebo alias odesílatele. Pokud ho v kroku neuvedete, použije se sender z kořene požadavku a poté výchozí odesílatel vašeho účtu (default_sender). Viz Odesílatelé. |
language | string | Kód jazyka verze šablony (např. en, cs, de). |
Volitelná pole
| Pole | Typ | Popis |
|---|---|---|
params | array of strings | Hodnoty proměnných značek v těle šablony (v pořadí). |
params_header | array of strings | Hodnota proměnné značky v hlavičce šablony, je-li přítomna. |
params_buttons | array of strings | Hodnoty proměnných značek v tlačítkách šablony (např. dynamické URL). |
ttl | integer | Doba života v minutách. |
Požadavky na nastavení
- Připojte WhatsApp Business číslo — navštivte app.smsmanager.com/whatsapp pro propojení svého čísla a získání Phone Number ID.
- Vytvořte a nechte schválit šablonu — šablony musí být před použitím odeslány a schváleny Metou. Tento proces obvykle trvá od několika minut do několika hodin.
Příklad
{
"to": [{ "phone_number": "420777123456" }],
"flow": [
{
"whatsapp_template": {
"sender": "514578330250514",
"template_name": "order_confirmation",
"language": "cs",
"params": ["Jan", "ORD-9921"],
"params_header": ["ORD-9921"],
"params_buttons": ["https://example.com/track/ORD-9921"],
"ttl": 1440
}
},
{
"sms": {
"sender": "MujObchod",
"body": "Ahoj Jane, vaše objednávka ORD-9921 je potvrzena! Sledovat: https://example.com/track/ORD-9921"
}
}
]
}
params poskytuje hodnoty ["Jan", "ORD-9921"] v pořadí.Pokud šablona nebyla ještě schválena nebo bylo schválení odvoláno, kanál
whatsapp_template selže a SmsManager přejde na další kanál ve vašem flow.RCS kanál
RCS (Rich Communication Services) je nástupce SMS s bohatým obsahem přímo v nativní aplikaci pro zprávy na Androidu. Umožňuje odesílat text, obrázky, videa, dokumenty a audio, návrhy odpovědí a akční tlačítka, samostatnou rich card i produktový carousel. RCS zprávy se doručí jen příjemcům s aktivním RCS, proto je vhodné za RCS krok vždy zařadit SMS zálohu.Povinná pole
| Pole | Typ | Popis |
|---|---|---|
sender | string | ID vašeho RCS agenta (odesílatele) nebo alias odesílatele. Pokud ho v kroku neuvedete, použije se sender z kořene požadavku a poté výchozí odesílatel vašeho účtu (default_sender). Viz Odesílatelé. |
Volitelná pole
| Pole | Typ | Popis |
|---|---|---|
body | string | Text zprávy. U zprávy s médiem slouží jako popisek. |
ttl | integer | Doba života v minutách. Po jejím uplynutí se přejde na další kanál ve flow. |
image, video, document, audio | string nebo object | Médium z veřejné URL — buď URL jako řetězec, nebo objekt s url. V jedné zprávě použijte nejvýše jedno. Viz Media. |
buttons | array | Návrhy odpovědí a akční tlačítka (reply / url). |
card | object | Samostatná rich card s media, nadpisem, popisem a tlačítky. |
carousel | array | Vodorovně listovatelná řada 2 až 10 karet. |
Příklad
{
"body": "Vaše objednávka #5821 je připravena k vyzvednutí!",
"to": [{ "phone_number": "420777123456" }],
"flow": [
{
"rcs": {
"sender": "muj_rcs_agent",
"body": "Vaše objednávka #5821 je připravena k vyzvednutí!",
"buttons": [
{ "type": "url", "text": "Zobrazit objednávku", "postback": "ORDER", "url": "https://example.com/orders/5821" }
]
}
},
{
"sms": {
"sender": "MujObchod",
"body": "Vaše objednávka #5821 je připravena k vyzvednutí!"
}
}
]
}
RCS zprávy jsou doručovány pouze příjemcům s aktivním RCS. Vždy zahrnujte SMS zálohu ve svém flow, abyste dosáhli i ostatních příjemců.