Fail persediaan menyimpan keseluruhan persediaan sesuatu integrasi dalam satu fail teks. Muat turunnya sebagai sandaran, ubah banyak perkara sekaligus, salin persediaan ke nombor lain, atau biarkan ejen AI menyediakan semuanya melalui API atau MCP. Setiap muat naik disemak dahulu dan boleh dibatalkan.
Fail persediaan menyimpan semua yang anda sediakan dalam sesuatu integrasi: tetapan, perkhidmatan dan kakitangan Book-and-Pay, kategori, pilihan dan produk Order-and-Pay, acara, tarikh dan jenis tiket Tickets-and-Pay, serta borang dan automasi Submit-Info. Ia ialah satu fail teks, jadi anda boleh menyimpannya sebagai sandaran, mengubahnya dalam mana-mana editor, memuat naiknya semula, atau menyalinnya ke nombor lain yang anda miliki.
Fail yang sama berfungsi di tiga tempat: papan pemuka, API dan pelayan MCP untuk ejen AI.
Setiap integrasi mempunyai bahagian Setup file:
| Integrasi | Lokasi |
|---|---|
| Book-and-Pay | tab Overview, di bahagian bawah |
| Order-and-Pay | tab Import & export, di bahagian bawah |
| Tickets-and-Pay | tab Settings, di bahagian bawah |
| Submit-Info | tab Settings, di bahagian bawah |
Hanya pemilik dan pentadbir sesuatu nombor yang dapat melihatnya.
Download memberikan persediaan sebagai fail .a2e.jsonl. Download with pictures memberikan fail .zip yang mengandungi fail yang sama dan setiap gambar di dalamnya: sandaran luar talian yang lengkap dan boleh dimuat naik semula seperti sedia ada.
Buka fail dalam editor teks dan ubah, tambah atau buang baris. Setiap baris ialah satu perkara: satu perkhidmatan, satu produk, satu acara. Hamparan tidak diperlukan.
Upload a file menyemak fail dahulu. Tiada apa yang berubah lagi. Anda melihat setiap masalah dengan nombor barisnya dan cara membetulkannya, atau apa yang akan berlaku jika digunakan: berapa banyak perkara yang baharu, diubah atau dibuang, serta yang mana.
Apply membuat tepat perubahan yang ditunjukkan oleh semakan. Semakan kekal sah selama 1 jam.
Setiap penggunaan disenaraikan di bawah Recent changes by setup file. Undo mengembalikan semua yang diubah oleh penggunaan itu, dalam tempoh 30 hari, selagi tiada penggunaan kemudian yang mengubah integrasi yang sama. Batalkan yang terkini dahulu.
Sebelum memuat naik, pilih apa yang berlaku kepada perkara yang tidak disenaraikan dalam fail:
Jika anda pemilik atau pentadbir lebih daripada satu nombor, Copy to another number menyalin persediaan sesuatu integrasi dari nombor anda ke nombor lain: cawangan kedua, nombor ujian, atau templat yang anda berikan kepada setiap kedai baharu.
Salinan disemak dahulu pada nombor lain dan menunjukkan apa yang akan diubah di sana. Copy now menggunakannya. Gambar turut disalin. Untuk membatalkan salinan, buka integrasi yang sama pada nombor lain: salinan itu disenaraikan di sana di bawah Recent changes.
Alamat web Book-and-Pay, Order-and-Pay dan Tickets-and-Pay hanya milik satu nombor dan tidak pernah disalin. Tetapkan alamat nombor lain dalam papan pemuka nombor itu sendiri.
| Integrasi | Baris |
|---|---|
| Book-and-Pay | booking.settings (satu baris bagi setiap bahagian: waktu, web, jenama, mesej ...), booking.service, booking.provider (kakitangan) |
| Order-and-Pay | shop.settings (satu baris bagi setiap bahagian, termasuk rupa halaman pesanan), shop.category, shop.option_group, shop.item (dengan varian dan gambar) |
| Tickets-and-Pay | tickets.settings (satu baris bagi setiap bahagian; wa_templates ialah ayat anda sendiri untuk mesej WhatsApp), tickets.chart (pelan tempat duduk yang disimpan), tickets.event (dengan tarikh, jenis tiket, had dikongsi, gambar dan pelan tempat duduk), tickets.promo |
| Submit-Info | submit.settings, submit.list, submit.connection, submit.form, submit.automation |
| Semua | asset: gambar, dinamakan oleh baris yang menggunakannya |
Tidak pernah dalam fail
Fail persediaan ialah JSON Lines: satu objek JSON bagi setiap baris. Baris pertama menyatakan jenis fail itu; setiap baris lain ialah satu rekod dengan type dan key. Kunci itu mengenal pasti rekod yang sama semula pada masa akan datang: id perkhidmatan, 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"]}Susunan baris tidak penting. Harga Book-and-Pay ialah jumlah (25 bermakna 25.00, price ialah label yang dipaparkan di sebelahnya); harga Order-and-Pay dan Tickets-and-Pay ialah unit terkecil mata wang (1250 bermakna 12.50). Medan tepat bagi setiap baris terdapat dalam panduan API (GET /v1/{number}/setup/guide).
Sesuatu rekod menamakan gambar dengan kunci baris asset. Gambar itu datang daripada salah satu:
url: alamat https://, diambil oleh kami.data: gambar itu sendiri, dalam base64.file: laluan dalam .zip yang dimuat naik.sha256: gambar yang sudah ada pada nombor ini.Eksport menulis alamat awam setiap gambar. Gambar yang tiada alamat awam, seperti gambar lantai di belakang pelan tempat duduk, mendapat pautan bertandatangan yang sah selama 7 hari, supaya fail yang disalin ke nombor lain masih 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 mestilah PNG, JPEG atau WEBP, paling besar 5 MB setiap satu. Jika sesuatu integrasi memerlukannya, gambar akan dikecilkan atau ditukar kepada JPEG: logo Book-and-Pay dimuatkan dalam 300 KB, dan gambar Tickets-and-Pay dimuatkan dalam 1 MB.
Ejen menyediakan keseluruhan integrasi dalam satu langkah yang disemak, bukannya berpuluh-puluh panggilan. Pelayan MCP https://api.app2email.com/mcp/setup mempunyai alat ini: get_setup_guide, export_setup, check_setup, apply_setup, upload_setup_asset, list_setup_jobs, get_setup_job dan undo_setup. Panggilan yang sama terdapat dalam API:
| Panggilan | Fungsi |
|---|---|
GET /v1/{number}/setup/guide | setiap jenis rekod, medan dan hadnya, dengan contoh. Ejen membacanya dahulu |
GET /v1/{number}/setup/export | fail semasa: format=jsonl, zip atau json |
POST /v1/{number}/setup/check | menyemak fail dan tidak mengubah apa-apa: masalah mengikut baris, pelan, dan check_id |
POST /v1/{number}/setup/apply | menggunakan semakan: {"check_id": 123} |
POST /v1/{number}/setup/assets | menyimpan gambar selama 7 hari dan memberikan sha256-nya |
GET /v1/{number}/setup/jobs | semakan, penggunaan dan pembatalan terkini |
POST /v1/{number}/setup/jobs/{id}/undo | mengembalikan apa yang diubah oleh penggunaan |
Kunci memerlukan kebenaran integrasi itu sendiri: bookings:manage, orders:manage, tickets:manage atau submissions:manage. Kunci sandbox boleh mengeksport dan menyemak, tetapi tidak boleh menggunakan.
Gelung biasa untuk ejen: baca panduan, eksport fail semasa, ubah beberapa baris, semak, betulkan apa yang dilaporkan oleh semakan, kemudian tanya pengguna sebelum menggunakan check_id.
| Perkara | Had |
|---|---|
| Satu fail | 20 MB teks, 50,000 baris (dalam papan pemuka, muat naik paling besar 19 MB) |
| Permintaan dengan gambar di dalamnya | 60 MB melalui API |
| Satu gambar | 5 MB |
| Gambar yang diambil melalui alamat | 100 setiap muat naik; Order-and-Pay mengambil gambar produk di latar belakang dalam beberapa minit |
| Fail besar | lebih 1,000 rekod disemak dan digunakan di latar belakang; papan pemuka menunggu dengan sendirinya |
| Semakan | boleh digunakan dalam masa 1 jam, sekali sahaja |
| Batal | 30 hari |