Soubor nastavení obsahuje celé nastavení integrace v jednom textovém souboru. Stáhněte jej jako zálohu, změňte mnoho věcí najednou, zkopírujte nastavení na jiné číslo nebo nechte AI agenta nastavit vše přes API nebo MCP. Každé nahrání se nejprve zkontroluje a dá se vrátit zpět.
Soubor nastavení obsahuje vše, co jste v integraci nastavili: nastavení, služby a zaměstnance v Book-and-Pay, kategorie, možnosti a produkty v Order-and-Pay, události, termíny a typy vstupenek v Tickets-and-Pay a formuláře a automatizace v Submit-Info. Je to jeden textový soubor, takže si jej můžete uschovat jako zálohu, upravit v libovolném editoru, znovu nahrát nebo zkopírovat na jiné své číslo.
Stejný soubor funguje na třech místech: v dashboardu, v API a v MCP serveru pro AI agenty.
Každá integrace má sekci Setup file:
| Integrace | Kde |
|---|---|
| Book-and-Pay | na záložce Overview, dole |
| Order-and-Pay | na záložce Import & export, dole |
| Tickets-and-Pay | na záložce Settings, dole |
| Submit-Info | na záložce Settings, dole |
Vidí ji jen vlastník a správci čísla.
Download stáhne nastavení jako soubor .a2e.jsonl. Download with pictures stáhne .zip se stejným souborem a všemi obrázky uvnitř: úplná offline záloha, kterou můžete znovu nahrát beze změny.
Otevřete soubor v textovém editoru a změňte, přidejte nebo odeberte řádky. Každý řádek je jedna věc: služba, produkt, událost. Tabulkový procesor není potřeba.
Upload a file soubor nejprve zkontroluje. Zatím se nic nemění. Uvidíte každý problém s číslem řádku a způsobem opravy, nebo to, co by použití změnilo: kolik věcí je nových, změněných nebo odebraných a které to jsou.
Apply provede přesně ty změny, které kontrola ukázala. Kontrola zůstává platná 1 hodinu.
Každé použití je uvedeno v sekci Recent changes by setup file. Undo vrátí zpět vše, co dané použití změnilo, a to po dobu 30 dní, pokud žádné pozdější použití nezměnilo stejnou integraci. Nejprve vraťte zpět pozdější použití.
Před nahráním zvolte, co se stane s věcmi, které soubor neuvádí:
Jste-li vlastníkem nebo správcem více čísel, Copy to another number zkopíruje nastavení integrace z čísla, na kterém jste, na jiné číslo: druhou pobočku, testovací číslo nebo šablonu, kterou dáte každému novému obchodu.
Kopie se nejprve zkontroluje na druhém čísle a ukáže, co by tam změnila. Copy now ji použije. Obrázky se kopírují také. Kopii vrátíte zpět tak, že na druhém čísle otevřete tutéž integraci: kopie je tam uvedena v sekci Recent changes.
Webová adresa Book-and-Pay, Order-and-Pay a Tickets-and-Pay patří jen jednomu číslu a nikdy se nekopíruje. Adresu druhého čísla nastavte v jeho vlastním dashboardu.
| Integrace | Řádky |
|---|---|
| Book-and-Pay | booking.settings (jeden řádek na sekci: otevírací doba, web, značka, zprávy ...), booking.service, booking.provider (zaměstnanci) |
| Order-and-Pay | shop.settings (jeden řádek na sekci, včetně vzhledu stránky objednávek), shop.category, shop.option_group, shop.item (s variantami a obrázky) |
| Tickets-and-Pay | tickets.settings (jeden řádek na sekci; wa_templates jsou vaše vlastní znění zpráv WhatsApp), tickets.chart (uložené plány sedadel), tickets.event (s termíny, typy vstupenek, sdílenými limity, obrázky a plánem sedadel), tickets.promo |
| Submit-Info | submit.settings, submit.list, submit.connection, submit.form, submit.automation |
| Vše | asset: obrázek, pojmenovaný řádky, které jej používají |
Nikdy v souboru
Soubor nastavení je JSON Lines: jeden objekt JSON na řádek. První řádek říká, o jaký soubor jde; každý další řádek je jeden záznam s type a key. Klíč umožní záznam příště znovu najít: id služby, SKU produktu, adresu události.
{"type":"a2e.setup","version":1,"products":["booking"]}
{"type":"booking.service","key":"haircut","name":"Haircut","duration_min":30,"price":"$25","price_amount":25}
{"type":"booking.service","key":"beard","name":"Beard trim","duration_min":15,"price":"$12","price_amount":12}
{"type":"booking.provider","key":"sam","name":"Sam","services":["haircut","beard"]}Pořadí řádků nehraje roli. U Book-and-Pay jsou ceny částky (25 znamená 25,00, price je popisek zobrazený vedle ní); u Order-and-Pay a Tickets-and-Pay jsou ceny v nejmenší jednotce měny (1250 znamená 12,50). Přesná pole každého řádku jsou v průvodci API (GET /v1/{number}/setup/guide).
Záznam pojmenuje obrázek klíčem řádku asset. Obrázek pochází z jednoho z těchto zdrojů:
url: adresa https://, kterou načteme my.data: samotný obrázek, base64.file: cesta uvnitř nahraného .zip.sha256: obrázek, který toto číslo již má.Export zapíše veřejnou adresu každého obrázku. Obrázek bez veřejné adresy, například půdorys za plánem sedadel, dostane podepsaný odkaz platný 7 dní, takže soubor zkopírovaný na jiné číslo jej stále obsahuje.
{"type":"asset","key":"classic-photo","url":"https://example.com/classic.jpg"}
{"type":"shop.item","key":"BURGER-CLASSIC","name":"Classic burger","category":"burgers","price":1250,"images":["classic-photo"]}Obrázky jsou PNG, JPEG nebo WEBP, každý nejvýše 5 MB. Tam, kde to integrace vyžaduje, se obrázek zmenší nebo převede na JPEG: logo Book-and-Pay se vejde do 300 KB, obrázek Tickets-and-Pay do 1 MB.
Agent nastaví celou integraci v jednom zkontrolovaném kroku místo desítek volání. MCP server https://api.app2email.com/mcp/setup má tyto nástroje: get_setup_guide, export_setup, check_setup, apply_setup, upload_setup_asset, list_setup_jobs, get_setup_job a undo_setup. Stejná volání jsou v API:
| Volání | Co dělá |
|---|---|
GET /v1/{number}/setup/guide | všechny typy záznamů, jejich pole a limity, s příklady. Agenti si jej přečtou jako první |
GET /v1/{number}/setup/export | aktuální soubor: format=jsonl, zip nebo json |
POST /v1/{number}/setup/check | zkontroluje soubor a nic nemění: problémy podle řádků, plán, check_id |
POST /v1/{number}/setup/apply | použije kontrolu: {"check_id": 123} |
POST /v1/{number}/setup/assets | uloží obrázek na 7 dní a vrátí jeho sha256 |
GET /v1/{number}/setup/jobs | poslední kontroly, použití a vrácení zpět |
POST /v1/{number}/setup/jobs/{id}/undo | vrátí zpět to, co použití změnilo |
Klíč potřebuje oprávnění dané integrace: bookings:manage, orders:manage, tickets:manage nebo submissions:manage. Klíč pro sandbox může exportovat a kontrolovat, ale nemůže použít změny.
Obvyklý postup pro agenta: přečíst průvodce, exportovat aktuální soubor, změnit několik řádků, zkontrolovat, opravit to, co kontrola hlásí, a poté se zeptat uživatele, než použije check_id.
| Co | Limit |
|---|---|
| Soubor | 20 MB textu, 50 000 řádků (v dashboardu nahrání nejvýše 19 MB) |
| Požadavek s obrázky uvnitř | 60 MB přes API |
| Obrázek | 5 MB |
| Obrázky načtené podle adresy | 100 na nahrání; Order-and-Pay stahuje obrázky produktů na pozadí během několika minut |
| Velké soubory | více než 1 000 záznamů se kontroluje a použije na pozadí; dashboard na ně počká sám |
| Kontrola | lze použít do 1 hodiny, jednou |
| Vrácení zpět | 30 dní |