app2email API Harga

Dokumentasi

Fail persediaan

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.

Dalam papan pemuka

Setiap integrasi mempunyai bahagian Setup file:

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

Hanya pemilik dan pentadbir sesuatu nombor yang dapat melihatnya.

  1. 1. Muat turun

    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.

  2. 2. Ubah

    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.

  3. 3. Muat naik

    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.

  4. 4. Guna

    Apply membuat tepat perubahan yang ditunjukkan oleh semakan. Semakan kekal sah selama 1 jam.

  5. 5. Batal

    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.

Tambah dan ubah, atau jadikannya sama seperti fail

Sebelum memuat naik, pilih apa yang berlaku kepada perkara yang tidak disenaraikan dalam fail:

  • Add and change (lalai): baris dalam fail dicipta atau diubah, dan yang lain kekal seperti sedia ada. Fail dengan hanya lima baris hanya mengubah lima perkara itu.
  • Make it exactly like the file: apa-apa jenis yang sama yang tidak disenaraikan dalam fail akan dibuang. Produk diarkibkan, tidak pernah dipadam. Semakan menyenaraikan setiap penyingkiran sebelum anda menggunakannya.

Salin ke nombor lain

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.

Note

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.

Apa yang terkandung dalam fail persediaan

IntegrasiBaris
Book-and-Paybooking.settings (satu baris bagi setiap bahagian: waktu, web, jenama, mesej ...), booking.service, booking.provider (kakitangan)
Order-and-Payshop.settings (satu baris bagi setiap bahagian, termasuk rupa halaman pesanan), shop.category, shop.option_group, shop.item (dengan varian dan gambar)
Tickets-and-Paytickets.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-Infosubmit.settings, submit.list, submit.connection, submit.form, submit.automation
Semuaasset: gambar, dinamakan oleh baris yang menggunakannya

Tidak pernah dalam fail

  • Rahsia: kunci pembayaran, kata laluan sambungan dan token. Rahsia yang disimpan kekal seperti sedia ada.
  • Mengaktifkan sesuatu integrasi. Fail tidak pernah melakukannya, dan fail tidak pernah menerbitkan, membatalkan atau memadam acara bertiket.
  • Apa yang dilakukan pelanggan: tempahan, pesanan, tiket yang dijual, penyerahan, pelanggan, pembayaran.
  • Ahli pasukan dan log masuk kakitangan.
  • Angka stok Order-and-Pay, melainkan anda tandakan Also set the stock figures from the file. Tanpanya, fail yang anda eksport pada waktu pagi tidak dapat membatalkan jualan hari itu.

Format

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

Gambar

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.

Untuk ejen AI dan API

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:

PanggilanFungsi
GET /v1/{number}/setup/guidesetiap jenis rekod, medan dan hadnya, dengan contoh. Ejen membacanya dahulu
GET /v1/{number}/setup/exportfail semasa: format=jsonl, zip atau json
POST /v1/{number}/setup/checkmenyemak fail dan tidak mengubah apa-apa: masalah mengikut baris, pelan, dan check_id
POST /v1/{number}/setup/applymenggunakan semakan: {"check_id": 123}
POST /v1/{number}/setup/assetsmenyimpan gambar selama 7 hari dan memberikan sha256-nya
GET /v1/{number}/setup/jobssemakan, penggunaan dan pembatalan terkini
POST /v1/{number}/setup/jobs/{id}/undomengembalikan 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.

Tip

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.

Had

PerkaraHad
Satu fail20 MB teks, 50,000 baris (dalam papan pemuka, muat naik paling besar 19 MB)
Permintaan dengan gambar di dalamnya60 MB melalui API
Satu gambar5 MB
Gambar yang diambil melalui alamat100 setiap muat naik; Order-and-Pay mengambil gambar produk di latar belakang dalam beberapa minit
Fail besarlebih 1,000 rekod disemak dan digunakan di latar belakang; papan pemuka menunggu dengan sendirinya
Semakanboleh digunakan dalam masa 1 jam, sekali sahaja
Batal30 hari