# 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.

Endpoint: POST /message
Version: v2
Security: x-api-key

## Request fields (application/json):

  - `body` (string, required)
    Tělo zprávy (pokud není definováno v toku).

  - `to` (array, required)
    Seznam příjemců.

  - `to.phone_number` (string, required)
    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"

  - `callback` (string)
    URL pro zpětné volání pro příjem oznámení o doručení (Webhook, viz [Webhooks](#tag/Webhooks)).

  - `tag` (string)
    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` (object)
    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` (string)
    Naplánovaný čas odeslání zprávy. Vždy v časovém pásmu UTC.
    Example: "2025-01-11T10:00:00Z"

  - `delivery_time` (object)

  - `delivery_time.days` (array)
    Dny v týdnu pro naplánovaný čas.
    Enum: "monday", "tuesday", "wednesday", "thursday", "friday", "saturday", "sunday"

  - `delivery_time.start` (string)
    Počáteční čas pro naplánovaný čas.
    Example: "08:00"

  - `delivery_time.end` (string)
    Koncový čas pro naplánovaný čas.
    Example: "21:00"

  - `delivery_time.tz` (string)
    Časové pásmo pro naplánovaný čas.
    Example: "Europe/Prague, Europe/London, Europe/Berlin, America/New_York"

  - `flow` (array)
    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.).

  - `flow.sms` (object)

  - `flow.sms.body` (string, required)
    Tato definice těla zprávy zde má vyšší prioritu než ta definovaná v kořenovém objektu.

  - `flow.sms.sender` (string)
    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 +).

  - `flow.sms.gateway` (string)
    Použijte direct, pokud používáte vyhrazené virtuální číslo. Použijte custom, pokud používáte SIM hosting.
    Enum: "high", "direct", "custom"

  - `flow.sms.ttl` (integer)
    Doba života v minutách.

  - `flow.sms.type` (string)
    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.
    Enum: "sms", "utf"

  - `flow.viber` (object)

  - `flow.viber.sender` (string, required)
    Použijte jméno odesílatele, které jste předregistrovali pro svou Viber Business zprávu.

  - `flow.viber.buttons` (array)

  - `flow.viber.buttons.title` (string, required)

  - `flow.viber.buttons.url` (string, required)

  - `flow.whatsapp_text` (object)

  - `flow.whatsapp_text.body` (string, required)
    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í.

  - `flow.whatsapp_text.sender` (string, required)
    ID telefonního čísla registrovaného čísla WhatsApp. Naleznete ho v [nastavení WhatsApp](https://app.smsmanager.com/whatsapp).

  - `flow.whatsapp_template` (object)

  - `flow.whatsapp_template.template_name` (string, required)
    Název šablony, kterou jste předregistrovali a schválili před použitím.

  - `flow.whatsapp_template.params` (array)
    Pokud má vaše šablona parametry, musíte zde pro ně předat hodnoty.

  - `flow.whatsapp_template.params_header` (array)
    Pokud má vaše šablona hlavičku s parametrem, musíte zde pro něj předat hodnotu.

  - `flow.whatsapp_template.params_buttons` (array)
    Pokud mají tlačítka vaší šablony parametry, musíte zde pro ně předat hodnoty.

  - `flow.whatsapp_template.language` (string, required)
    Jazyk šablony (pro stejnou šablonu můžete mít více jazyků).

  - `payload` (object)
    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"}

## Response 200 fields (application/json):

  - `request_id` (string)
    Jedinečný identifikátor požadavku.

  - `accepted` (array)

  - `accepted.key` (string)
    Index původního příjemce z pole to.

  - `accepted.message_id` (string)
    Jedinečný identifikátor zprávy pro přijatou zprávu.

  - `rejected` (array)

## Response 400 fields (application/json):

  - `Message` (string)
    Chybová zpráva.
    Example: "Uživatel není oprávněn přistupovat k tomuto zdroji s explicitním zamítnutím"