- SMS
- Viber
- WhatsApp Text
- WhatsApp Šablona
- RCS
SMS kanál
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 +. Pro alfanumerické odesílatele může být vyžadována předregistrace. |
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+).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. Musí přesně odpovídat jménu registrovanému přes SmsManager. |
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. |
sender | string | Phone Number ID vašeho registrovaného WhatsApp čísla. |
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/whatsapp.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. |
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, 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). |
Volitelná pole
| Pole | Typ | Popis |
|---|---|---|
body | string | Text zprávy. |
ttl | integer | Doba života v minutách. Po jejím uplynutí se přejde na další kanál ve flow. |
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 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ů.