app2email API Cennik

Dokumentacja

Pliki konfiguracji

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.

W panelu

Każda integracja ma sekcję Plik konfiguracji:

IntegracjaGdzie
Book-and-Payzakładka Przegląd, na dole
Order-and-Payzakładka Import i eksport, na dole
Tickets-and-Payzakładka Ustawienia, na dole
Submit-Infozakładka Ustawienia, na dole

Widzą ją tylko właściciel i administratorzy numeru.

  1. 1. Pobierz

    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.

  2. 2. Zmień

    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.

  3. 3. Wgraj

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

  4. 4. Zastosuj

    Zastosuj wprowadza dokładnie te zmiany, które pokazało sprawdzenie. Sprawdzenie jest ważne przez 1 godzinę.

  5. 5. Cofnij

    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.

Dodaj i zmień, albo zrób dokładnie jak w pliku

Zanim wgrasz plik, wybierz, co ma się stać z rzeczami, których plik nie wymienia:

  • Dodaj i zmień (domyślnie): wiersze z pliku są tworzone lub zmieniane, a reszta zostaje bez zmian. Plik z pięcioma wierszami zmienia tylko te pięć rzeczy.
  • Zrób dokładnie jak w pliku: wszystko tego samego rodzaju, czego plik nie wymienia, zostaje usunięte. Produkt jest archiwizowany, nigdy kasowany. Sprawdzenie wymienia każde usunięcie, zanim zastosujesz zmiany.

Kopiuj na inny numer

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.

Note

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.

Co zawiera plik konfiguracji

IntegracjaWiersze
Book-and-Paybooking.settings (jeden wiersz na sekcję: godziny, strona, marka, wiadomości ...), booking.service, booking.provider (personel)
Order-and-Payshop.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-Paytickets.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-Infosubmit.settings, submit.list, submit.connection, submit.form, submit.automation
Wszystkieasset: zdjęcie, nazwane przez wiersze, które go używają

Nigdy w pliku

  • Sekrety: klucze płatności, hasła do połączeń i tokeny. Zapisany sekret zostaje bez zmian.
  • Włączanie integracji. Plik tego nigdy nie robi, a plik nigdy nie publikuje, nie anuluje ani nie usuwa wydarzenia z biletami.
  • To, co zrobili klienci: rezerwacje, zamówienia, sprzedane bilety, zgłoszenia, klienci, płatności.
  • Członkowie zespołu i loginy personelu.
  • Stany magazynowe Order-and-Pay, chyba że zaznaczysz Ustaw też stany magazynowe z pliku. Bez tego plik wyeksportowany rano nie może cofnąć dzisiejszej sprzedaży.

Format

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

Zdjęcia

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.

Dla agentów AI i API

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łanieCo robi
GET /v1/{number}/setup/guidewszystkie typy rekordów, ich pola i limity, z przykładami. Agenci czytają go najpierw
GET /v1/{number}/setup/exportaktualny plik: format=jsonl, zip lub json
POST /v1/{number}/setup/checksprawdza plik i niczego nie zmienia: problemy wg wiersza, plan, check_id
POST /v1/{number}/setup/applystosuje sprawdzenie: {"check_id": 123}
POST /v1/{number}/setup/assetsprzechowuje zdjęcie przez 7 dni i odpowiada jego sha256
GET /v1/{number}/setup/jobsostatnie sprawdzenia, zastosowania i cofnięcia
POST /v1/{number}/setup/jobs/{id}/undocofa 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.

Tip

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.

Limity

CoLimit
Plik20 MB tekstu, 50 000 wierszy (w panelu wgranie do 19 MB)
Żądanie ze zdjęciami w środku60 MB przez API
Zdjęcie5 MB
Zdjęcia pobierane z adresu100 na wgranie; Order-and-Pay pobiera zdjęcia produktów w tle w ciągu kilku minut
Duże plikiponad 1000 rekordów jest sprawdzanych i stosowanych w tle; panel sam na nie czeka
Sprawdzeniemożna je zastosować w ciągu 1 godziny, raz
Cofnięcie30 dni