app2email API Ceník

Dokumentace

Soubory nastavení

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.

V dashboardu

Každá integrace má sekci Setup file:

IntegraceKde
Book-and-Payna záložce Overview, dole
Order-and-Payna záložce Import & export, dole
Tickets-and-Payna záložce Settings, dole
Submit-Infona záložce Settings, dole

Vidí ji jen vlastník a správci čísla.

  1. 1. Stáhnout

    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.

  2. 2. Změnit

    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.

  3. 3. Nahrát

    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.

  4. 4. Použít

    Apply provede přesně ty změny, které kontrola ukázala. Kontrola zůstává platná 1 hodinu.

  5. 5. Vrátit zpět

    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řidat a změnit, nebo nastavit přesně podle souboru

Před nahráním zvolte, co se stane s věcmi, které soubor neuvádí:

  • Add and change (výchozí): řádky v souboru se vytvoří nebo změní, vše ostatní zůstane beze změny. Soubor s pouhými pěti řádky změní jen těchto pět věcí.
  • Make it exactly like the file: vše stejného druhu, co soubor neuvádí, se odebere. Produkt se archivuje, nikdy se nemaže. Kontrola vypíše každé odebrání ještě před použitím.

Kopírování na jiné číslo

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.

Note

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.

Co soubor nastavení obsahuje

IntegraceŘádky
Book-and-Paybooking.settings (jeden řádek na sekci: otevírací doba, web, značka, zprávy ...), booking.service, booking.provider (zaměstnanci)
Order-and-Payshop.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-Paytickets.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-Infosubmit.settings, submit.list, submit.connection, submit.form, submit.automation
Všeasset: obrázek, pojmenovaný řádky, které jej používají

Nikdy v souboru

  • Tajné údaje: platební klíče, hesla ke spojení a tokeny. Uložený tajný údaj zůstane beze změny.
  • Zapnutí integrace. Soubor to nikdy neudělá a soubor také nikdy nezveřejní, nezruší ani neodstraní událost s prodanými vstupenkami.
  • To, co zákazníci udělali: rezervace, objednávky, prodané vstupenky, odeslané formuláře, zákazníci, platby.
  • Členové týmu a přihlášení zaměstnanců.
  • Stavy skladu u Order-and-Pay, pokud nezaškrtnete Also set the stock figures from the file. Bez toho by soubor, který jste vyexportovali ráno, nemohl vrátit zpět dnešní prodeje.

Formát

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

Obrázky

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.

Pro AI agenty a API

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/guidevšechny typy záznamů, jejich pole a limity, s příklady. Agenti si jej přečtou jako první
GET /v1/{number}/setup/exportaktuální soubor: format=jsonl, zip nebo json
POST /v1/{number}/setup/checkzkontroluje soubor a nic nemění: problémy podle řádků, plán, check_id
POST /v1/{number}/setup/applypoužije kontrolu: {"check_id": 123}
POST /v1/{number}/setup/assetsuloží obrázek na 7 dní a vrátí jeho sha256
GET /v1/{number}/setup/jobsposlední kontroly, použití a vrácení zpět
POST /v1/{number}/setup/jobs/{id}/undovrá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.

Tip

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.

Limity

CoLimit
Soubor20 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ázek5 MB
Obrázky načtené podle adresy100 na nahrání; Order-and-Pay stahuje obrázky produktů na pozadí během několika minut
Velké souboryvíce než 1 000 záznamů se kontroluje a použije na pozadí; dashboard na ně počká sám
Kontrolalze použít do 1 hodiny, jednou
Vrácení zpět30 dní