> ## Documentation Index > Fetch the complete documentation index at: https://developers.smsmanager.com/llms.txt > Use this file to discover all available pages before exploring further. # Odeslat zprávu > Použijte tento koncový bod k odeslání zprávy jednomu nebo více příjemcům (až 10 příjemců). Pokud chcete použít jiné kanály než SMS (Viber, WhatsApp atd.), musíte použít vlastnost `flow`. ## OpenAPI ````yaml /openapi/cs/json/jsonapi_v2.yaml post /message openapi: 3.1.0 info: title: JSON API description: > API pro odesílání zpráv přes SMS, Viber, WhatsApp a další komunikační kanály. ## JSON API v2 API klíč je vyžadován pro všechny požadavky. Svůj API klíč naleznete v [nastavení účtu](https://app.smsmanager.com/api-cloud). Verze API (http-api a xml-api) jsou také zastaralé a měli byste místo nich používat toto JSON API v2. version: v2 contact: url: https://smsmanager.cz email: cc@smsmanager.cz servers: - url: https://api.smsmngr.com/v2 description: Odpoví s daty vašeho požadavku security: [] tags: - name: sending x-displayName: Odesílání description: > Pro odesílání zpráv použijte jeden z následujících koncových bodů. - `/message` pro odeslání zprávy až 10 příjemcům - `/messages` pro odeslání více zpráv (až 10 zpráv najednou, každá až s 10 příjemci) - `/simple/message` pro odeslání jednoduché zprávy (GET a POST) paths: /message: post: tags: - sending summary: Odeslat zprávu description: > Použijte tento koncový bod k odeslání zprávy jednomu nebo více příjemcům (až 10 příjemců). Pokud chcete použít jiné kanály než SMS (Viber, WhatsApp atd.), musíte použít vlastnost `flow`. requestBody: required: true content: application/json: schema: $ref: '#/components/schemas/Message' examples: Simple message: value: body: Test message to: - phone_number: '420777123456' Message with flow: value: body: Test message to: - phone_number: '420777123456' flow: - sms: sender: SmsManager gateway: high ttl: 10 Scheduled message: value: body: Meeting reminder to: - phone_number: '420777123456' datetime: '2025-01-11T10:00:00Z' Message with callback and payload: value: body: Order shipped to: - phone_number: '420777123456' callback: https://example.com/delivery payload: order_id: ORD-1001 Unicode SMS with custom TTL: value: body: 'Привет, Ваш код: 1234' to: - phone_number: '420777123456' tag: transactional flow: - sms: sender: SmsManager type: utf ttl: 5 responses: '200': description: Zprávy úspěšně odeslány content: application/json: schema: $ref: '#/components/schemas/MessageResponse' '400': description: Špatný požadavek content: application/json: schema: type: object properties: Message: type: string description: Chybová zpráva. example: >- Uživatel není oprávněn přistupovat k tomuto zdroji s explicitním zamítnutím security: - x-api-key: [] components: schemas: Message: type: object required: - body - to properties: body: type: string maxLength: 1000 description: Tělo zprávy (pokud není definováno v toku). to: type: array minItems: 1 maxItems: 10 description: Seznam příjemců. items: type: object properties: phone_number: type: string description: >- Telefonní číslo příjemce. Doporučuje se mezinárodní formát (E.164, bez úvodního `+` nebo `00`), ale je akceptován i jiný formát (před přijetím požadavku jej převedeme na mezinárodní formát). example: '420777123456' required: - phone_number callback: type: string format: uri description: >- URL pro zpětné volání pro příjem oznámení o doručení (Webhook, viz [Webhooks](#tag/Webhooks)). tag: type: string default: promotional description: >- Tag pro zprávu. Můžete jej použít k seskupování zpráv (např. podle ID kampaně). Existují také speciální tagy, které můžete použít: `priority` (pro prioritní zprávy), `transactional` (pro transakční zprávy). params: type: object description: >- Poskytnutím tohoto objektu můžete zprávě předat speciální parametry. Zeptejte se nás, jak tento parametr použít pro zkracování odkazů nebo jiné funkce. datetime: type: string format: date-time description: Naplánovaný čas odeslání zprávy. Vždy v časovém pásmu UTC. example: '2025-01-11T10:00:00Z' delivery_time: type: object properties: days: type: array items: type: string enum: - monday - tuesday - wednesday - thursday - friday - saturday - sunday description: Dny v týdnu pro naplánovaný čas. start: type: string description: Počáteční čas pro naplánovaný čas. example: '08:00' end: type: string description: Koncový čas pro naplánovaný čas. example: '21:00' tz: type: string description: Časové pásmo pro naplánovaný čas. example: Europe/Prague, Europe/London, Europe/Berlin, America/New_York default: UTC flow: type: array description: >- Seznam komunikačních kanálů pro tok zprávy. Pokud je definován, nesmí být prázdný. Můžete použít více kanálů, pořadí kanálů je důležité (první kanál se použije jako první, pokud první kanál není dostupný nebo jej příjemce nepřijme, použije se druhý kanál atd.). items: type: object additionalProperties: false minProperties: 1 maxProperties: 1 properties: sms: type: object properties: body: type: string maxLength: 1000 description: >- Tato definice těla zprávy zde má vyšší prioritu než ta definovaná v kořenovém objektu. sender: type: string description: >- Alfanumerické jméno odesílatele (max. 11 znaků, může být vyžadována předběžná registrace) nebo vyhrazené virtuální číslo (bez `+`). examples: - Mojefirma - 420777123456 gateway: type: string enum: - high - direct - custom default: high description: >- Použijte `direct`, pokud používáte vyhrazené virtuální číslo. Použijte `custom`, pokud používáte SIM hosting. ttl: type: integer description: Doba života v minutách. type: type: string enum: - sms - utf default: utf description: >- Nastavte `utf`, pokud chcete zachovat unicode znaky ve zprávě. Nastavte `sms`, pokud chcete převést nebo odebrat unicode ze zprávy, abyste zachovali maximální kapacitu v SMS. required: - body viber: type: object properties: body: type: string maxLength: 1000 description: >- Tato definice těla zprávy zde má vyšší prioritu než ta definovaná v kořenovém objektu. sender: type: string description: >- Použijte jméno odesílatele, které jste předregistrovali pro svou Viber Business zprávu. buttons: type: array maxItems: 1 items: type: object required: - title - url properties: title: type: string url: type: string format: uri ttl: type: integer description: Doba života v minutách. required: - body - sender whatsapp_text: type: object properties: body: type: string description: >- Tato definice těla zprávy zde má vyšší prioritu než ta definovaná v kořenovém objektu. Vlastní tělo zprávy můžete použít pouze tehdy, když příjemce již odpověděl na vaši šablonovou zprávu nebo vám poslal zprávu jako první. maxLength: 1000 sender: type: string description: >- ID telefonního čísla registrovaného čísla WhatsApp. Naleznete ho v [nastavení WhatsApp](https://app.smsmanager.com/whatsapp). examples: - '514578330250514' required: - body - sender whatsapp_template: type: object properties: template_name: type: string description: >- Název šablony, kterou jste předregistrovali a schválili před použitím. maxLength: 100 sender: type: string description: >- ID telefonního čísla registrovaného čísla WhatsApp. Naleznete ho v [nastavení WhatsApp](https://app.smsmanager.com/whatsapp). examples: - '514578330250514' params: type: array items: type: string description: >- Pokud má vaše šablona parametry, musíte zde pro ně předat hodnoty. params_header: type: array items: type: string description: >- Pokud má vaše šablona hlavičku s parametrem, musíte zde pro něj předat hodnotu. params_buttons: type: array items: type: string description: >- Pokud mají tlačítka vaší šablony parametry, musíte zde pro ně předat hodnoty. language: type: string examples: - en - cs description: >- Jazyk šablony (pro stejnou šablonu můžete mít více jazyků). ttl: type: integer description: Doba života v minutách. required: - template_name - language - sender payload: type: object description: > Můžete dokonce vytvořit pro zprávu payload, kde můžete definovat jakékoli parametry pro zprávu. Tento objekt je vrácen v oznámení o doručení a odpovědích. example: user_id: '123456' MessageResponse: type: object properties: request_id: type: string description: Jedinečný identifikátor požadavku. accepted: type: array items: type: object properties: key: type: string description: Index původního příjemce z pole `to`. message_id: type: string description: Jedinečný identifikátor zprávy pro přijatou zprávu. rejected: type: array items: type: object properties: key: type: string description: Index původního příjemce z pole `to`. securitySchemes: x-api-key: type: apiKey in: header name: x-api-key ````