Export/import JSONL

Tip

Marketingový přehled funkce, příklady použití a hotové prompty pro ChatGPT a Claude, které vygenerují JSONL automaticky, najdete na stránce Odesílání zpráv pomocí AI.

JSONL (JSON Lines) je formát, který ukládá JSON objekty na více řádcích, čímž je možné efektivně ukládat/načítat velké množství dat, bez nutnosti parsování celého souboru. Více o formátu JSONL najdete na oficiálních stránkách jsonlines.org.

Export

Exportování do toho formátu nabízí naše webová administrace. Exportovat můžete všechny odeslané nebo přijaté SMS ve vybraném časovém filtru nebo filtru dle stavu. To vám v praxi dovoluje vyexportovat například ty zprávy, které nebylo možné v minulém měsíci doručit.

Import v administraci

Importování z tohoto souboru je možné přímo v administraci, což vám dovoluje si odesílání kompletně připravit mimo prostředí SmsManager, následně importovat do systému a odeslat.

Import na API

Další možností je importovat data na API. U velkého objemu dat může být tento způsob efektivnější, protože není nutné vytvářet tolik HTTP spojení. Soubor vytvoříte a následně zavoláte naše API, které vám vrátí podepsané URL na které lze soubor uploadovat. Jeho zpracování a rozdělení na jednotlivé zprávy pak již probíhá na naší straně.

Tento mezikrok s uploadem souboru a jeho zpracování představuje určité zdržené. Pro menší rozesílky (řádově tisíce zpráv) je proto obvykle efektivnější volat přímo API.

Formát JSON objektů

Každý objekt v souboru JSONL reprezentuje jednu zprávu a má strukturu odpvídající API /message:

Minimální podoba:

{
    "to": [{"phone": "420777123456"}],
    "body": "Text zprávy"
}