Plik konfiguracji zawiera całą konfigurację integracji w jednym pliku tekstowym. Pobierz go jako kopię zapasową, zmień wiele rzeczy naraz, skopiuj konfigurację na inny numer albo pozwól agentowi AI ustawić wszystko przez API lub MCP. Każde wgranie jest najpierw sprawdzane i można je cofnąć.
Plik konfiguracji zawiera wszystko, co ustawiono w integracji: ustawienia, usługi i personel Book-and-Pay, kategorie, opcje i produkty Order-and-Pay, wydarzenia, terminy i rodzaje biletów Tickets-and-Pay oraz formularze i automatyzacje Submit-Info. To jeden plik tekstowy, więc możesz go trzymać jako kopię zapasową, zmienić w dowolnym edytorze, wgrać ponownie albo skopiować na inny z Twoich numerów.
Ten sam plik działa w trzech miejscach: w panelu, w API oraz w serwerze MCP dla agentów AI.
Każda integracja ma sekcję Plik konfiguracji:
| Integracja | Gdzie |
|---|---|
| Book-and-Pay | zakładka Przegląd, na dole |
| Order-and-Pay | zakładka Import i eksport, na dole |
| Tickets-and-Pay | zakładka Ustawienia, na dole |
| Submit-Info | zakładka Ustawienia, na dole |
Widzą ją tylko właściciel i administratorzy numeru.
Pobierz daje konfigurację jako plik .a2e.jsonl. Pobierz ze zdjęciami daje plik .zip z tym samym plikiem i każdym zdjęciem w środku: pełna kopia offline, którą możesz później wgrać w niezmienionej postaci.
Otwórz plik w edytorze tekstu i zmień, dodaj lub usuń wiersze. Każdy wiersz to jedna rzecz: usługa, produkt, wydarzenie. Arkusz kalkulacyjny nie jest potrzebny.
Wgraj plik najpierw go sprawdza. Na razie nic się nie zmienia. Widzisz każdy problem z numerem wiersza i sposobem naprawy albo to, co zrobiłoby zastosowanie: ile rzeczy jest nowych, zmienionych lub usuniętych i które to są.
Zastosuj wprowadza dokładnie te zmiany, które pokazało sprawdzenie. Sprawdzenie jest ważne przez 1 godzinę.
Każde zastosowanie jest wymienione w Ostatnie zmiany wg pliku konfiguracji. Cofnij przywraca wszystko, co zastosowanie zmieniło, przez 30 dni, o ile żadne późniejsze zastosowanie nie zmieniło tej samej integracji. Najpierw cofnij późniejsze.
Zanim wgrasz plik, wybierz, co ma się stać z rzeczami, których plik nie wymienia:
Jeśli jesteś właścicielem lub administratorem więcej niż jednego numeru, Kopiuj na inny numer kopiuje konfigurację integracji z numeru, na którym jesteś, na inny: drugi oddział, numer testowy albo wzorzec dla każdego nowego sklepu.
Kopia jest najpierw sprawdzana na drugim numerze i pokazuje, co by tam zmieniła. Kopiuj teraz ją stosuje. Zdjęcia idą razem z nią. Aby cofnąć kopię, otwórz tę samą integrację na drugim numerze: kopia jest tam wymieniona w sekcji Ostatnie zmiany.
Adres www Book-and-Pay, Order-and-Pay i Tickets-and-Pay należy tylko do jednego numeru i nigdy nie jest kopiowany. Ustaw adres drugiego numeru w jego własnym panelu.
| Integracja | Wiersze |
|---|---|
| Book-and-Pay | booking.settings (jeden wiersz na sekcję: godziny, strona, marka, wiadomości ...), booking.service, booking.provider (personel) |
| Order-and-Pay | shop.settings (jeden wiersz na sekcję, w tym wygląd strony zamówień), shop.category, shop.option_group, shop.item (z wariantami i zdjęciami) |
| Tickets-and-Pay | tickets.settings (jeden wiersz na sekcję; wa_templates to Twoje własne brzmienie wiadomości WhatsApp), tickets.chart (zapisane plany miejsc), tickets.event (z terminami, rodzajami biletów, wspólnymi limitami, zdjęciami i planem miejsc), tickets.promo |
| Submit-Info | submit.settings, submit.list, submit.connection, submit.form, submit.automation |
| Wszystkie | asset: zdjęcie, nazwane przez wiersze, które go używają |
Nigdy w pliku
Plik konfiguracji to JSON Lines: jeden obiekt JSON na wiersz. Pierwszy wiersz mówi, czym jest plik; każdy kolejny wiersz to jeden rekord z type i key. Klucz pozwala znaleźć ten sam rekord następnym razem: id usługi, SKU produktu, adres wydarzenia.
{"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"]}Kolejność wierszy nie ma znaczenia. Ceny w Book-and-Pay to kwoty (25 to 25.00, price to etykieta wyświetlana obok). Ceny w Order-and-Pay i Tickets-and-Pay są podane w najmniejszej jednostce waluty (1250 to 12.50). Dokładne pola każdego wiersza są w przewodniku API (GET /v1/{number}/setup/guide).
Rekord wskazuje zdjęcie kluczem wiersza asset. Zdjęcie pochodzi z jednego z tych źródeł:
url: adres https://, pobierany przez nas.data: samo zdjęcie, w base64.file: ścieżka w wgranym pliku .zip.sha256: zdjęcie, które ten numer już ma.Eksport zapisuje publiczny adres każdego zdjęcia. Zdjęcie bez publicznego adresu, na przykład plan podłogi za planem miejsc, dostaje podpisany link ważny 7 dni, więc plik skopiowany na inny numer nadal je zawiera.
{"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"]}Zdjęcia to PNG, JPEG lub WEBP, najwyżej 5 MB każde. Tam, gdzie integracja tego wymaga, zdjęcie jest pomniejszane lub zamieniane na JPEG: logo Book-and-Pay dopasowane do 300 KB, zdjęcie Tickets-and-Pay dopasowane do 1 MB.
Agent ustawia całą integrację w jednym sprawdzonym kroku zamiast kilkudziesięciu wywołań. Serwer MCP https://api.app2email.com/mcp/setup ma te narzędzia: get_setup_guide, export_setup, check_setup, apply_setup, upload_setup_asset, list_setup_jobs, get_setup_job i undo_setup. Te same wywołania są w API:
| Wywołanie | Co robi |
|---|---|
GET /v1/{number}/setup/guide | wszystkie typy rekordów, ich pola i limity, z przykładami. Agenci czytają go najpierw |
GET /v1/{number}/setup/export | aktualny plik: format=jsonl, zip lub json |
POST /v1/{number}/setup/check | sprawdza plik i niczego nie zmienia: problemy wg wiersza, plan, check_id |
POST /v1/{number}/setup/apply | stosuje sprawdzenie: {"check_id": 123} |
POST /v1/{number}/setup/assets | przechowuje zdjęcie przez 7 dni i odpowiada jego sha256 |
GET /v1/{number}/setup/jobs | ostatnie sprawdzenia, zastosowania i cofnięcia |
POST /v1/{number}/setup/jobs/{id}/undo | cofa to, co zmieniło zastosowanie |
Klucz potrzebuje własnego uprawnienia integracji: bookings:manage, orders:manage, tickets:manage lub submissions:manage. Klucz sandbox może eksportować i sprawdzać, ale nie może stosować zmian.
Typowa pętla agenta: przeczytaj przewodnik, wyeksportuj aktualny plik, zmień kilka wierszy, sprawdź, napraw to, co zgłosiło sprawdzenie, a potem zapytaj użytkownika, zanim zastosujesz check_id.
| Co | Limit |
|---|---|
| Plik | 20 MB tekstu, 50 000 wierszy (w panelu wgranie do 19 MB) |
| Żądanie ze zdjęciami w środku | 60 MB przez API |
| Zdjęcie | 5 MB |
| Zdjęcia pobierane z adresu | 100 na wgranie; Order-and-Pay pobiera zdjęcia produktów w tle w ciągu kilku minut |
| Duże pliki | ponad 1000 rekordów jest sprawdzanych i stosowanych w tle; panel sam na nie czeka |
| Sprawdzenie | można je zastosować w ciągu 1 godziny, raz |
| Cofnięcie | 30 dni |