# Odeslat více zpráv

Tento endpoint slouží k hromadnému odeslání identických zpráv více příjemcům (můžete nastavit až 10 příjemců na jeden požadavek a až 10 požadavků na jedno volání API). To znamená, že můžete odeslat až 100 příjemcům v rámci jednoho volání HTTP API. Pokud chcete použít jiné kanály než SMS (Viber, WhatsApp atd.), musíte použít vlastnost flow. Při použití tohoto endpointu obdržíte message_id pro každý z požadavků (nikoli pro každého příjemce). Chcete-li získat message_id pro každého příjemce, musíte k message_id připojit -. Více informací o message_id naleznete v dokumentaci.

Endpoint: POST /messages
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 požadavku z pole těla.

  - `accepted.message_id` (string)
    Jedinečný identifikátor zprávy pro každý požadavek v poli těla.

  - `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"