app2email API Harga

Dokumentasi

Setup file

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.

Di dashboard

Setiap integrasi memiliki bagian Setup file:

IntegrasiLokasi
Book-and-Paytab Overview, di bagian bawah
Order-and-Paytab Import & export, di bagian bawah
Tickets-and-Paytab Settings, di bagian bawah
Submit-Infotab Settings, di bagian bawah

Hanya owner dan admin sebuah nomor yang melihatnya.

  1. 1. Unduh

    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.

  2. 2. Ubah

    Buka file di editor teks dan ubah, tambah, atau hapus baris. Setiap baris adalah satu hal: layanan, produk, acara. Spreadsheet tidak diperlukan.

  3. 3. Unggah

    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.

  4. 4. Terapkan

    Apply membuat persis perubahan yang ditunjukkan pemeriksaan. Hasil pemeriksaan tetap berlaku selama 1 jam.

  5. 5. Batalkan

    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.

Tambah dan ubah, atau jadikan persis seperti file

Sebelum mengunggah, pilih apa yang terjadi pada hal-hal yang tidak tercantum di file:

  • Add and change (bawaan): baris di file dibuat atau diubah, yang lain tetap seperti adanya. File dengan lima baris saja hanya mengubah lima hal itu.
  • Make it exactly like the file: segala hal sejenis yang tidak tercantum di file dihapus. Produk diarsipkan, tidak pernah dihapus. Pemeriksaan mencantumkan setiap penghapusan sebelum Anda menerapkan.

Salin ke nomor lain

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.

Note

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.

Isi setup file

IntegrasiBaris
Book-and-Paybooking.settings (satu baris per bagian: jam, web, brand, pesan ...), booking.service, booking.provider (staf)
Order-and-Payshop.settings (satu baris per bagian, termasuk tampilan halaman pesanan), shop.category, shop.option_group, shop.item (dengan varian dan gambar)
Tickets-and-Paytickets.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-Infosubmit.settings, submit.list, submit.connection, submit.form, submit.automation
Semuaasset: gambar, dinamai oleh baris yang memakainya

Tidak pernah ada di file

  • Rahasia: kunci pembayaran, kata sandi koneksi, dan token. Rahasia yang tersimpan tetap seperti adanya.
  • Mengaktifkan integrasi. File tidak pernah melakukannya, dan file tidak pernah memublikasikan, membatalkan, atau menghapus acara bertiket.
  • Yang dilakukan pelanggan: booking, pesanan, tiket terjual, kiriman, pelanggan, pembayaran.
  • Anggota tim dan login staf.
  • Angka stok Order-and-Pay, kecuali Anda mencentang Also set the stock figures from the file. Tanpa itu, file yang Anda ekspor pagi hari tidak bisa membatalkan penjualan hari itu.

Formatnya

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

Gambar

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.

Untuk agen AI dan API

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:

PanggilanFungsinya
GET /v1/{number}/setup/guidesetiap tipe record, field, dan batasnya, dengan contoh. Agen membacanya lebih dulu
GET /v1/{number}/setup/exportfile saat ini: format=jsonl, zip atau json
POST /v1/{number}/setup/checkmemeriksa file dan tidak mengubah apa pun: masalah per baris, rencananya, sebuah check_id
POST /v1/{number}/setup/applymenerapkan hasil pemeriksaan: {"check_id": 123}
POST /v1/{number}/setup/assetsmenyimpan gambar selama 7 hari dan menjawab sha256-nya
GET /v1/{number}/setup/jobspemeriksaan, penerapan, dan pembatalan terbaru
POST /v1/{number}/setup/jobs/{id}/undomengembalikan 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.

Tip

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.

Batas

ApaBatas
Satu file20 MB teks, 50.000 baris (di dashboard, unggahan maksimal 19 MB)
Permintaan dengan gambar di dalamnya60 MB lewat API
Satu gambar5 MB
Gambar yang diambil lewat alamat100 per unggahan; Order-and-Pay mengambil gambar produk di latar belakang dalam hitungan menit
File besarlebih dari 1.000 record diperiksa dan diterapkan di latar belakang; dashboard menunggunya sendiri
Satu pemeriksaanbisa diterapkan dalam 1 jam, sekali
Undo30 hari