Setup file menyimpan seluruh penyiapan sebuah integrasi dalam satu file teks. Unduh sebagai cadangan, ubah banyak hal sekaligus, salin penyiapan ke nomor lain, atau biarkan agen AI menyiapkan semuanya lewat API atau MCP. Setiap unggahan diperiksa dulu dan bisa dibatalkan.
Setup file menyimpan semua yang Anda siapkan di sebuah integrasi: pengaturan, layanan dan staf Book-and-Pay, kategori, opsi, dan produk Order-and-Pay, acara, tanggal, dan tipe tiket Tickets-and-Pay, serta formulir dan otomatisasi Submit-Info. Ini satu file teks, sehingga Anda bisa menyimpannya sebagai cadangan, mengubahnya di editor apa pun, mengunggahnya lagi, atau menyalinnya ke nomor Anda yang lain.
File yang sama berfungsi di tiga tempat: dashboard, API, dan server MCP untuk agen AI.
Setiap integrasi memiliki bagian Setup file:
| Integrasi | Lokasi |
|---|---|
| Book-and-Pay | tab Overview, di bagian bawah |
| Order-and-Pay | tab Import & export, di bagian bawah |
| Tickets-and-Pay | tab Settings, di bagian bawah |
| Submit-Info | tab Settings, di bagian bawah |
Hanya owner dan admin sebuah nomor yang melihatnya.
Download memberikan penyiapan sebagai file .a2e.jsonl. Download with pictures memberikan .zip berisi file yang sama dan setiap gambar di dalamnya: cadangan offline lengkap yang bisa Anda unggah lagi apa adanya.
Buka file di editor teks dan ubah, tambah, atau hapus baris. Setiap baris adalah satu hal: layanan, produk, acara. Spreadsheet tidak diperlukan.
Upload a file memeriksanya lebih dulu. Belum ada yang berubah. Anda melihat setiap masalah beserta nomor barisnya dan cara memperbaikinya, atau apa yang akan dilakukan penerapan: berapa banyak hal yang baru, berubah, atau dihapus, dan yang mana.
Apply membuat persis perubahan yang ditunjukkan pemeriksaan. Hasil pemeriksaan tetap berlaku selama 1 jam.
Setiap penerapan tercantum di bawah Recent changes by setup file. Undo mengembalikan semua yang diubah penerapan itu, selama 30 hari, selama tidak ada penerapan berikutnya yang mengubah integrasi yang sama. Batalkan yang lebih baru lebih dulu.
Sebelum mengunggah, pilih apa yang terjadi pada hal-hal yang tidak tercantum di file:
Jika Anda owner atau admin dari lebih dari satu nomor, Copy to another number menyalin penyiapan sebuah integrasi dari nomor yang sedang Anda buka ke nomor lain: cabang kedua, nomor uji, atau template yang Anda berikan ke setiap toko baru.
Salinan diperiksa lebih dulu di nomor lain dan menunjukkan apa yang akan diubahnya di sana. Copy now menerapkannya. Gambar ikut tersalin. Untuk membatalkan salinan, buka integrasi yang sama di nomor lain: salinan itu tercantum di sana di bawah Recent changes.
Alamat web Book-and-Pay, Order-and-Pay, dan Tickets-and-Pay hanya milik satu nomor dan tidak pernah disalin. Atur alamat nomor lain di dashboard-nya sendiri.
| Integrasi | Baris |
|---|---|
| Book-and-Pay | booking.settings (satu baris per bagian: jam, web, brand, pesan ...), booking.service, booking.provider (staf) |
| Order-and-Pay | shop.settings (satu baris per bagian, termasuk tampilan halaman pesanan), shop.category, shop.option_group, shop.item (dengan varian dan gambar) |
| Tickets-and-Pay | tickets.settings (satu baris per bagian; wa_templates adalah kata-kata Anda sendiri untuk pesan WhatsApp), tickets.chart (denah kursi tersimpan), tickets.event (dengan tanggal, tipe tiket, batas bersama, gambar, dan denah kursinya), tickets.promo |
| Submit-Info | submit.settings, submit.list, submit.connection, submit.form, submit.automation |
| Semua | asset: gambar, dinamai oleh baris yang memakainya |
Tidak pernah ada di file
Setup file adalah JSON Lines: satu objek JSON per baris. Baris pertama menyatakan file apa ini; setiap baris lainnya adalah satu record dengan type dan key. Key menemukan record yang sama lagi di lain waktu: id layanan, SKU produk, alamat acara.
{"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"]}Urutan baris tidak berpengaruh. Harga Book-and-Pay berupa jumlah (25 adalah 25,00, price adalah label yang ditampilkan di sampingnya); harga Order-and-Pay dan Tickets-and-Pay dalam satuan terkecil mata uang (1250 adalah 12,50). Field persis setiap baris ada di panduan API (GET /v1/{number}/setup/guide).
Sebuah record menamai gambar dengan key dari baris asset. Gambar berasal dari salah satu:
url: alamat https://, diambil oleh kami.data: gambar itu sendiri, base64.file: path di dalam .zip yang diunggah.sha256: gambar yang sudah dimiliki nomor ini.Ekspor menulis alamat publik setiap gambar. Gambar yang tidak memiliki alamat publik, seperti gambar lantai di belakang denah kursi, mendapat tautan bertanda tangan yang berlaku 7 hari, sehingga file yang disalin ke nomor lain tetap membawanya.
{"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"]}Gambar berformat PNG, JPEG, atau WEBP, maksimal 5 MB masing-masing. Bila integrasi membutuhkannya, gambar diperkecil atau diubah menjadi JPEG: logo Book-and-Pay agar muat 300 KB, gambar Tickets-and-Pay agar muat 1 MB.
Agen menyiapkan seluruh integrasi dalam satu langkah yang diperiksa, bukan lusinan panggilan. Server MCP https://api.app2email.com/mcp/setup memiliki tool berikut: get_setup_guide, export_setup, check_setup, apply_setup, upload_setup_asset, list_setup_jobs, get_setup_job dan undo_setup. Panggilan yang sama ada di API:
| Panggilan | Fungsinya |
|---|---|
GET /v1/{number}/setup/guide | setiap tipe record, field, dan batasnya, dengan contoh. Agen membacanya lebih dulu |
GET /v1/{number}/setup/export | file saat ini: format=jsonl, zip atau json |
POST /v1/{number}/setup/check | memeriksa file dan tidak mengubah apa pun: masalah per baris, rencananya, sebuah check_id |
POST /v1/{number}/setup/apply | menerapkan hasil pemeriksaan: {"check_id": 123} |
POST /v1/{number}/setup/assets | menyimpan gambar selama 7 hari dan menjawab sha256-nya |
GET /v1/{number}/setup/jobs | pemeriksaan, penerapan, dan pembatalan terbaru |
POST /v1/{number}/setup/jobs/{id}/undo | mengembalikan apa yang diubah sebuah penerapan |
Kunci membutuhkan izin milik integrasi itu sendiri: bookings:manage, orders:manage, tickets:manage atau submissions:manage. Kunci sandbox boleh mengekspor dan memeriksa, tetapi tidak menerapkan.
Alur yang lazim bagi agen: baca panduan, ekspor file saat ini, ubah beberapa baris, periksa, perbaiki yang dilaporkan pemeriksaan, lalu tanyakan kepada pengguna sebelum menerapkan check_id.
| Apa | Batas |
|---|---|
| Satu file | 20 MB teks, 50.000 baris (di dashboard, unggahan maksimal 19 MB) |
| Permintaan dengan gambar di dalamnya | 60 MB lewat API |
| Satu gambar | 5 MB |
| Gambar yang diambil lewat alamat | 100 per unggahan; Order-and-Pay mengambil gambar produk di latar belakang dalam hitungan menit |
| File besar | lebih dari 1.000 record diperiksa dan diterapkan di latar belakang; dashboard menunggunya sendiri |
| Satu pemeriksaan | bisa diterapkan dalam 1 jam, sekali |
| Undo | 30 hari |